Quickstart
Start Champagne 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 people table loads demonstration profiles
from PostgreSQL through GraphQL. Visible lists refresh automatically every 30 seconds and when the tab regains focus. The stack
starts PostgreSQL, the API, the back office, the member app (consumer.localhost), the
Mailpit inbox (mail.localhost), Waggle (waggle.localhost), 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.
The clubs are Vosges, Astel and Ukab Clubs, with three annual IÉNA plans. Without an explicitly configured fixture manifest there are no seeded Stripe memberships. To enable connected merchants, Finance and real sandbox Checkout, including accepted-application Plan payment steps, follow Stripe Connect. Application payment remains unavailable until the selected club's merchant and catalogue are ready.