Commands
The complete command reference. Bun everywhere — npm/node are not used.
Repo root
| Command | Does |
|---|
bun install | install the whole workspace (Toolkit packages + example + docs) |
bun run typecheck | tsc --noEmit in every package and the example |
bun run lint | oxlint over the repo |
bun run lint:fix | oxlint with autofix |
bun run fmt | oxfmt (writes) |
bun run fmt:check | oxfmt (check only) |
Example app (cd example)
Development
| Command | Does |
|---|
bun run dev | dev server on :3000 |
bun run build | production build (Nitro output) |
bun run worker | the Hatchet worker process (requires HATCHET_CLIENT_TOKEN) |
bun run storybook | component stories |
Database
| Command | Does |
|---|
bun run db:generate | diff schema → write a SQL migration (review it!) |
bun run db:migrate | apply pending migrations |
bun run db:push | push schema without a migration (prototyping only) |
bun run db:studio | Drizzle Studio locally |
bun run db:seed | destructive — truncate everything, load test data |
Tests
| Command | Does |
|---|
bun run e2e | the whole Playwright suite |
bunx playwright test sandbox | block tests only |
bun run test | unit tests (vitest) |
Infrastructure
| Command | Does |
|---|
docker compose up -d | Postgres, MinIO, Hatchet |
docker compose --profile monitoring up -d | Prometheus, Grafana (:3001), Loki |
docker compose --profile proxy up -d | Caddy front door (:8088), security headers |
docker compose --profile idp up -d | lldap + Dex (enterprise sign-in IdPs) |
docker compose --profile realtime up -d | Centrifugo (server-push, :8000) |
docker compose --profile collab up -d | Yjs sync server (collaborative editing, :1234) |
docker compose --profile tools up -d pgweb | the database browser on :8081 |
Docs (cd docs)
| Command | Does |
|---|
bun run dev | this site, with hot reload |
bun run build | static build (also produces llms.txt / llms-full.txt) |
bun run preview | serve the built site |