Developer Quick Start
Install dependencies, start local services, and validate the Handlet web app.
Prerequisites
- Node.js 20.10 or newer
- pnpm 10.x
- Docker for local Supabase
- local environment variables for the web app
Install
pnpm install
Environment files
The web app merges environment files in this order:
apps/web/.envapps/web/.env.developmentapps/web/.env.local
Put local secrets and machine-specific overrides in apps/web/.env.local.
Start local services
pnpm supabase:web:start pnpm dev
The public marketing pages can load without local Supabase. Authenticated app routes need Supabase and reachable public Supabase browser variables.
Validate before shipping
Run the standard checks after implementation work:
pnpm typecheck pnpm lint:fix pnpm format:fix pnpm run lint:design-tokens
Run the QA path check when route, navigation, layout, or user journey files change:
pnpm run lint:qa-paths