Skip to main content

Local Development

Canonical quickstart​

Use DEVELOPMENT.md at the repository root. From a fresh clone with Node 22:

nvm use
npm run bootstrap
npm run doctor
npm run dev:sable

No personal filesystem path is assumed.

Docs Site​

npm --prefix docs-site run start

Build:

npm --prefix docs-site run build

Web App​

The web app is in:

web

It is a Vercel app with static HTML and api/*.js serverless routes. The static pages can be opened directly for layout checks, but Supabase/Auth/API behavior should be tested in a Vercel-compatible environment.

npm run dev:sable starts that environment with vercel dev. Developers without Vercel project access can still run the web tests while access is provisioned.

Tests​

From the repository root, run the full local gate. It also includes the web production build and developer-tooling tests, which are absent from the current CI workflow:

npm run check

Supabase CLI​

From:

cd supabase

Read-only inspection commands include:

supabase migration list
supabase functions list

Do not run a production migration or function deploy from a workstation. Migrations and Edge Functions deploy from reviewed main through GitHub Actions.

Deno​

Supabase Edge Functions are Deno runtime code. If deno is not installed locally, standalone deno check will not be available; deployment through the Supabase CLI still validates packaging.