Quickstart
Start a Person demo with an isolated PostgreSQL database.
Requirements
Install Bun 1.4.x, Node.js 24 LTS, Make, Git, and Docker with Compose.
Start development
make devOpen the printed app URL. The HeroUI table loads three fictional people
from PostgreSQL through GraphQL. Press Refresh to query again. The stack
starts PostgreSQL, API, web, Caddy, and a one-off dependency installer.
drizzle-kit push and idempotent demo seeding run before the API listens.
Generated passwords live in secrets/ and are mounted as Docker secrets;
no manual database URL or .env credentials are needed.
Check your changes
make fix
make check
make test
make buildStop the current stack with make down. This preserves its database and dependency volumes.
See Development for isolated worktrees and docs commands.