Guides¶
Step-by-step guides for common development and operational tasks.
Development Guides¶
- Development - Local setup, build commands, code style, branches, and pull requests
- Deployment - Deploy to staging and production (production via
scripts/deploy-production.sh) - Testing - Write and run tests (pytest, Jest, Playwright, k6)
- Seed Data - Manage catalog and test data
- GitHub Workflow - Branching, PRs, CI gates, auto-merge, promotion and the automation workflows
- Documentation - Build and deploy this documentation site
- Admin Guide - Working in the admin
- Design Review - Design review workflow for custom designs
Stakeholder Workflows¶
- Eefje Intake Process - Bug/feature intake from the business owner: intake assistant, Ivar's
/ready, todos, retest loop
Analytics & Monitoring¶
- PostHog Analytics - Product analytics, feature flags, A/B testing