make (see development-workflow.mdc).
Start / stop
| Command | Purpose |
|---|---|
make start | Start the stack (docker compose up) |
make fresh-start | Rebuild and start clean (docker compose up --build --force-recreate --remove-orphans -V) |
make kill | Stop containers |
make clean-docker | Aggressive Docker cleanup (destructive — can drop volumes) |
Stripe
| Command | Purpose |
|---|---|
make stripe-login | Log in the containerized Stripe CLI when the Makefile prompts you (first start or expired auth) |
make stripe cmd=... | Run Stripe CLI in container |
Database
| Command | Purpose |
|---|---|
make migrate-up | Run migrations in container |
make seed-up | Run seeds in container |
Dependencies & build
| Command | Purpose |
|---|---|
make pnpm-install | Install all workspace deps (writes to host node_modules for IDE type resolution) |
make build module=<pkg> | Build one package |
make build-all | Build workspace packages |
Codegen & quality
| Command | Purpose |
|---|---|
make gql-codegen | GraphQL codegen (stack should be running) |
make codegen-verify | CI-style codegen in one-off container |
make test module=<pkg> [path=...] | Run tests in container |
make lint module=<pkg> [path=...] | Lint in container |
Deploy (Railway)
| Command | Purpose |
|---|---|
make deploy ENV=staging [SHA=...] | Deploy via Railway |
make deploy-staging | Deploy latest to staging |
make deploy-production | Deploy latest to production |
What’s next?
- Architecture overview — the full system map and how each layer connects.
- Tooling system — how the tools object is constructed and how loaders work.
- Tooling — provider-specific setup for logger, queue, mailer, metrics, and more.
- Updating Refract — pull upstream improvements into your project.