Skip to main content

Quickstart

Open The App​

The web app lives in:

sable-agents-demo/web

It is a Vercel app made of static HTML pages and web/api/*.js serverless routes.

Local static pages can be opened directly, but live routes need the Vercel or local serverless environment with the right env vars.

Run The Docs Site​

cd sable-agents-demo/docs-site
npm install
npm run start

Build it before shipping:

npm run build

Developer setup and tests​

The canonical editor-neutral guide is DEVELOPMENT.md at the repository root. Start with:

nvm use
npm run bootstrap
npm run doctor
npm run check

npm run check follows the same workspace test, typecheck, manifest, and docs-build boundaries as CI.

Check Supabase State​

From sable-agents-demo/supabase:

supabase migration list
supabase functions list

Compare the current repository migration ledger with the linked project. Do not assume a fixed final migration number, and do not apply migrations from a workstation.

Connector smoke tests​

Connector smoke tests call production services and are operator actions, not first-day local setup. Use the checked-in test suites and PR preview first. An operator runs the documented smoke workflow after merge with approved credentials and records the result.

First Files To Read​

  • sable-agents-demo/README.md
  • DEVELOPMENT.md
  • SABLE.md
  • sable-agents-demo/CLAUDE.md
  • sable-agents-demo/CONNECTOR-SETUP.md