Zergboard Docs

Static docs for product, API, integrations, deployment, and CLI operations.

Landing Open App

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

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 are in the repository `docs/` directory and are referenced by this page.

  • `docs/README.md`
  • `docs/architecture.md`
  • `docs/api.md`
  • `docs/integrations.md`
  • `docs/deployment.md`
  • `docs/cli.md`