Local Development

At a glance

Use this page for daily local iteration on event-site and control-plane.

Do this

Apply local migrations.

bash

npm run db:migrate:local
npm run db:migrate:control-plane:local

Start local servers.

bash

npm run dev
npm run dev:control-plane

Run quality checks before merging.

bash

npm run check
npm test

Important inputs:

apps/event-site/src/lib/config.ts (local default event config)
apps/event-site/wrangler.toml (worker bindings)
apps/control-plane/wrangler.toml (control-plane bindings)

When it fails

Missing local DB state: rerun local migrations.
Control-plane orchestration errors: verify runtime env vars and provider logs.
See Troubleshooting.