Skip to content

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.