Quickstart
Install, seed, and run the starter locally.
setuplocal-dev
Use Vite+ for the managed Node runtime and pinned pnpm. A Cloudflare account is needed for deployment only.
vp install
cp .env.example .env
pnpm run db:migrate:local
pnpm run db:seed
pnpm run devThe development command runs the web app on port 3071, the REST/MCP API on 8787,
and the background Worker on 8788. They share persisted local D1. To run one app,
use pnpm -C apps/web dev, pnpm -C apps/api dev, or
pnpm -C apps/background dev.
Open http://localhost:3071/sign-in. Seeding creates these credential accounts:
| Password | Roles | |
|---|---|---|
demo@starter.local | demo-starter-password | System admin and starter-lab owner |
engineer@example.com | demo-starter-password | starter-lab member |
The sign-in form also offers magic links and six-digit emailed codes. Both
expire after ten minutes. Codes allow three failed attempts. Without an email
provider, local delivery appears in the dev server's email.dispatched log.
The Seed workspace supplies members,
notifications, audit history, API tokens, and webhook endpoints. See the
setup guide (docs/setup.md in the local checkout)
for environment details and troubleshooting.