Make targets
Shortcuts for the commands you run every day. They only need go (and npm for the dashboard
and docs site), so they work the same on Windows, macOS and Linux. make help prints this list.
| Target | What it does |
|---|---|
make tools |
Install the developer tools used by dev and lint. |
make env |
Warn when .env is missing. |
make build |
Build the release binary with a baked-in version. |
make build-all |
Build the developer SPA, then the Go binary. |
make web-build |
Build the developer SPA into web/dev/dist (embedded by Go). |
make web-typecheck |
Type-check the developer SPA. |
make dev-web |
Run the SPA dev server on :5173 with /dev/api proxied to :8080. |
make dev |
Run the SPA dev server (:8080, HMR) and the API (:8081, air). |
make dev-api |
Run only the API with hot reload (air). |
make run |
Run the API once from source. |
make serve |
Alias for run. |
make queue |
Run the queue worker (River). Stop with Ctrl-C. |
make schedule |
Run the scheduler daemon. Stop with Ctrl-C. |
make test |
Run the unit test suite. |
make test-race |
Run the unit test suite with the race detector. |
make test-cover |
Run tests and write coverage.html. |
make test-integration |
Run the full suite against a real Postgres. |
make vet |
Run go vet. |
make format |
Format all Go code. |
make fmt |
Alias for format. |
make format-check |
Fail when any Go file is not gofmt-clean. |
make fmt-check |
Alias for format-check. |
make lint |
Run golangci-lint. |
make lint-fix |
Run golangci-lint and apply automatic fixes. |
make tidy |
Tidy go.mod and go.sum. |
make check |
Format check + vet + lint + unit tests. |
make sqlc |
Regenerate sqlc output in internal/dbgen. |
make openapi |
Regenerate OpenAPI-derived types in internal/contract. |
make openapi-gen |
Refresh the generated regions of api/openapi.yaml from module routes/DTOs. |
make openapi-check |
Validate the spec + route drift and fail if the generated regions are stale. |
make generate |
Regenerate all generated code. |
make gen-check |
Verify generated code, docs and skill copies are current; fails on drift. |
make skills-sync |
Copy the agent skills (.agents/skills, canonical) to .claude/skills for Claude Code. |
make skills-check |
Fail when .claude/skills differs from .agents/skills (run make skills-sync). |
make docs |
Preview the documentation site with hot reload at http://localhost:4321. |
make docs-build |
Build the documentation site into website/dist and check every link. |
make docs-gen |
Regenerate docs/reference (CLI, configuration, permissions, make) from the code. |
make db-up |
Start the local Postgres via docker compose. |
make db-down |
Stop the local Postgres. |
make migrate |
Apply pending migrations. |
make migrate-status |
Show applied and pending migrations. |
make migrate-rollback |
Roll back the most recent migration. |
make seed |
Seed permissions, default tenant/branch/roles, super-admin and developer users. |
make fresh |
Roll back everything, migrate and seed. Destructive. |
make health |
Run the application health checks. |
make config |
Print the effective configuration with secrets masked. |
make version |
Print the build version. |
make clean |
Remove build artifacts. |
make clean-all |
Also remove local runtime state. |