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 sable-agents-demo/docs-site run start

Build:

npm --prefix sable-agents-demo/docs-site run build

Web App

The web app is in:

sable-agents-demo/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 local CI equivalent:

npm run check

Supabase CLI

From:

cd sable-agents-demo/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.