Documentation
Product, API, integrations, deployment, and CLI reference
Architecture
System layout, runtime model, auth/tenancy, integration pipeline.
- Nuxt 3 + Nitro fullstack structure
- Workspace isolation and RBAC checks
- Session-cookie auth and provider-token cookies
API
Core endpoint map for auth, orgs, boards, cards, workspace sessions, and admin.
- Auth + membership-guarded operations
- Board/card lifecycle routes
- Workspace run launch and logs
Integrations
Linear, Notion, Jira, Trello import and OAuth/connectivity flows.
- OAuth connect/status/disconnect routes
- Manual token fallback modes
- Provider env var matrix
Deployment
Fly.io deployment, secret setup, health checks, and rollback baseline.
- Required + optional secrets
- Post-deploy verification checklist
- Migration and rollback notes
CLI
Go + Bubble Tea CLI (`zb`) for login, boards/cards, imports, and workspace runs.
- Interactive TUI mode
- Scriptable non-interactive commands
- Config stored at ~/.zergboard/zb.json
Command quickstart
Build and run the Go CLI locally
cd cli/zb
go mod tidy
go build -o zb
./zb login --email you@example.com --password '...'
./zb orgs
./zb boards
./zb workspace-runs list --session-id <session-id>Source docs in repo
Canonical markdown docs live under the repository docs/ directory
- docs/README.md
- docs/architecture.md
- docs/api.md
- docs/integrations.md
- docs/deployment.md
- docs/cli.md