Local development

Prereqs: Node LTS, pnpm, Docker.

pnpm install
docker compose -f infra/docker/compose.yaml up -d --wait   # Postgres · Valkey · MinIO · Mailpit
pnpm db:migrate
pnpm dev        # api + web + worker via turbo

• Web: http://localhost:3000 · API: http://localhost:3001 · Mailpit UI: http://localhost:8025
• Sign up locally; grab the verification link from Mailpit.

Verification ladder

pnpm lint && pnpm typecheck && pnpm test
pnpm test:integration     # needs the compose stack
pnpm --filter @scopekite/web e2e   # builds served by next start — run pnpm build first
pnpm build && pnpm check:api

Port conflicts: if another Postgres owns 5432, run the compose file with an override mapping ScopeKite’s Postgres elsewhere and point DATABASE_URL / TEST_DATABASE_URL / E2E_DATABASE_URL at it — the test harnesses read all three.

Full details: README and TEST_STRATEGY.