Local Development

At a glance

• Use this page for daily local iteration on the unified app (event sites + platform UI).

Do this

1. Apply local migrations.

npm run db:migrate:local

2. Start the local dev server.

make dev

This starts a single server that serves both event sites and the platform management UI at /platform/*.

3. Run quality checks before merging.

npm run check
npm test

Important inputs:

• .dev.vars.example (local env vars template, repo root)
• apps/event-site/wrangler.toml (worker bindings)

When it fails

• Missing local DB state: rerun npm run db:migrate:local.
• Platform route issues: verify PLATFORM_OPERATOR_EMAILS and PLATFORM_DOMAIN_SUFFIX env vars.
• See Troubleshooting.