LandedNZ
A personalised settlement roadmap and AI assistant for skilled migrants in their first 90 days in New Zealand.
Status: R0 rebuild, Stage A (local foundation). Runs locally only; nothing is deployed yet. The web app has working sign-in, with placeholder pages until the design boards are approved (Stage B).
Run it locally
Prerequisites: Node 24 (see .nvmrc), Docker (running), the Supabase CLI and make. No API keys are needed: AI_MODE=mock (the default in .env.example) gives deterministic chat replies and embeddings.
make setup # npm ci, Prisma client, Playwright browser, .env.local files from .env.example
make dev # Supabase → seed DB if empty → API on :3001 → web on :3000, then returns the prompt (`make logs`, `make stop`)
make dev takes about 30 seconds on a warm Docker. Check it at http://localhost:3001/health ("dbConnected":true) and http://localhost:3000.
To sign in, create a local user (there is no sign-up page yet), then open http://localhost:3000/signin:
make user [email protected] PASSWORD=choose-a-password
Local Supabase also serves Studio at http://127.0.0.1:54323 and the email inbox at http://127.0.0.1:54324.
Everyday commands
Run make to list every target.
| Command | What it does |
|---|
make check | Typecheck, lint, unit tests (API + web) and builds: what CI runs before e2e |
make test | API + web unit tests (Supabase must be running) |
make test-e2e | Playwright sign-in journey; starts the API and web if they are not up |
make docker-api | The production API container on :3001 against local Supabase |
make db-reset | Wipe the local DB and seed it again |
make db-reset-live | Same, with real OpenAI embeddings (needs ANTHROPIC_API_KEY and OPENAI_API_KEY in apps/api/.env.local) |
make stop | Stop local Supabase (data is kept) |
After each content deploy, call POST /admin/recalculate to reconcile existing roadmaps with the new content; production must set ADMIN_API_KEY for this.
For real Claude replies, set AI_MODE=live, ANTHROPIC_API_KEY and OPENAI_API_KEY in apps/api/.env.local.
Repository
| Path | What |
|---|
apps/api | Fastify 5 API, Prisma 7 on Postgres + pgvector, Claude chat over SSE, RAG over the verified YAML knowledge base in content/ |
apps/web | Next 16 app: Supabase sign-in, route guard (src/proxy.ts), shadcn/ui |
packages/types | Types shared by the API and web |
supabase/ | Local stack config (Postgres, auth, Studio, email inbox) |
scripts/dev-all.sh | What make dev runs |
docs/superpowers/ | Specs and implementation plans; the R0 spec is the source of truth for this rebuild |
.github/workflows/ci.yml | CI: the full local stack inside the job, then typecheck, lint, tests, builds, Docker build, e2e |
Working on the code with Claude Code: start at CLAUDE.md.
