Reference
Commands
Every script worth knowing, grouped by what you're doing.
Develop
pnpm dev # http://localhost:3000
pnpm build # production build
pnpm preview # serve the build
pnpm typecheck # nuxt typecheck
Database
pnpm supabase <cmd> # the CLI is a project dep, not global
pnpm db:reset # reset + migrate + seed
pnpm db:types # regenerate shared/types/database.types.ts
pnpm seed # reseed (SEED_FAST=1 for the minimal set)
After changing a table or function, run
pnpm db:types or typecheck fails. Never
edit a migration that has already been applied to a real database — add a new one.Test
pnpm test # vitest (pure logic)
pnpm test:coverage # with the 100% gate
pnpm test:e2e # Playwright e2e + a11y
pnpm screenshots # regenerate docs/screenshots/
Lint and generate
pnpm lint / pnpm lint:fix
pnpm fmt / pnpm fmt:check
pnpm lint:i18n # key parity + usage
pnpm gen:layer <name> # scaffold a feature layer
pnpm gen:auth-templates # regenerate supabase/templates/*.html
forge.toml wires oxfmt and oxlint into a pre-commit hook that auto-fixes and
restages, so you don't need to run them during development.Set up and verify
pnpm setup # pick integrations, write .env
pnpm doctor # verify what setup wrote
Both read the same subsystem manifest — adding a subsystem there wires up both.
Changelogs
There are two, deliberately:
| File | Audience | Edited by |
|---|---|---|
CHANGELOG.md | developers | release-please — never by hand |
app/utils/changelog.ts → /changelog | your users | you, one entry per date |