Briven/apps/api/README.md

@briven/api — control plane

Hono on Bun. The control plane for briven: accounts, projects, billing, auth, CLI sessions, env vars, audit logs. Customer data queries never hit this service.

dev

# from the repo root
pnpm install
pnpm --filter @briven/api dev

requires bun 1.1+. the dev script uses bun --hot for live reload.

endpoints (phase 0)

path	description
GET /	liveness + service identity
GET /health	process alive
GET /ready	dependencies reachable (stubs until phase 1)

phase 1 adds auth, projects, deployments, api-keys — see docs/BUILD_PLAN.md §Phase 1.

env

see src/env.ts for the full schema. all vars carry the BRIVEN_ prefix per CLAUDE.md §4.