# Quickstart

Start Champagne with an isolated PostgreSQL database.

Source: https://docs.champagne.dev-ukab.fr/en/quickstart

## Requirements [#requirements]

Install Bun 1.4.x, Node.js 24 LTS, Make, Git, and Docker with Compose.

### Install dependencies [#install-dependencies]From the repository root:```sh
make setup
```

### Start development [#start-development]```sh
make dev
```Open 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 [#check-your-changes]```sh
make fix
make check
make test
make build
```



Stop the current stack with `make down`. This preserves its database and dependency volumes.
See [Development](/en/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](/en/stripe-connect). Application payment remains unavailable until the selected
club's merchant and catalogue are ready.