Seed

Seed is the Union Street starter for agent-native products: a minimal control plane with auth, billing, API keys, and clean extension points for API/CLI growth.

Local Development

bun install
bun run dev

Open http://localhost:3000.

Quality Gates

Run these before handoff:

bun run db:check
bun run env:check
bun run test
bun run lint
bun run build

Database Workflow

  • Generate migrations: bunx drizzle-kit generate
  • Validate migration state: bun run db:check
  • Apply migrations only in approved environments/branches (e.g., Neon preview branch), not ad-hoc shared DB pushes.

Testing Docs

  • Test workflow and commands: docs/testing.md
  • Architecture and composition guide: docs/architecture.md
  • Release and promotion workflow: docs/release-flow.md
  • Test-specific agent guidance: tests/AGENTS.md
  • Repo-wide agent guidance: AGENTS.md