Makefile Commands

Primary developer command interface. All commands run from the renewa-one/ directory.

Source: renewa-one/Makefile (make help lists everything)

Core Commands

Command	Purpose
`make setup`	Allocate unique ports for this worktree (creates `.env.local`)
`make port-status`	Show the port-slot map across all worktrees
`make dev-init`	Setup ports + pull secrets + start Docker (one command for new worktrees)
`make dev`	Start Docker stack
`make dev-build`	Rebuild and start
`make dev-detach`	Start in background
`make dev-reload`	Recreate containers to pick up changed secrets (keeps volumes/data)
`make dev-clean`	Stop + remove containers/volumes
`make dev-reset`	Clean + restart + open browser
`make install`	First-time setup (worktrees use `dev-init`)

Command	Purpose
`make typecheck`	TypeScript check (backend + frontend, in running dev stack)
`make lint`	ESLint (backend + frontend)
`make format`	Format code
`make test`	Full test suite (start the stack first with `make dev`/`dev-detach`)
`make test-backend` / `make test-frontend`	One side only
`make test-backend-scoped FILES="…"`	Specific backend test files
`make test-frontend-scoped FILES="…"`	Frontend tests related to given source/test paths

During development run only scoped tests for changed files; the full suite runs in CI (pre-push no longer runs tests — see Git Workflow).

Command	Purpose
`make db-generate NAME=desc`	Generate migration from schema changes
`make db-validate`	Validate migration integrity (Atlas)
`make db-lint`	Lint migrations against main (ordering + destructive ops)
`make db-check-drift`	Verify `schema.ts` matches cumulative migrations
`make db-reset-migrations`	Reset `atlas/migrations` to main, keep `schema.ts` changes
`make db-migrate`	Apply pending migrations
`make db-mock`	Load demo data (idempotent; replaces `db-seed`)
`make db-mock-large`	Additional large-scale mock data (run after `db-mock`)
`make db-seed` / `make db-seed-large`	DEPRECATED aliases for `db-mock` / `db-mock-large`
`make db-reset`	Drop, create, migrate, reload mocks
`make db-studio`	Open Drizzle Studio UI
`make adminer`	Start Adminer (database UI)
`make config-export`	Export config snapshot from local DB

Command	Purpose
`make status`	Show container status
`make start` / `make stop`	Start/stop containers (stop preserves data)
`make logs` / `logs-backend` / `logs-frontend`	View container logs
`make shell-backend` / `shell-frontend`	Shell into containers
`make shell-db`	PostgreSQL shell
`make urls`	Show clickable access URLs for this instance
`make open`	Open frontend in browser
`make info`	Show current port configuration

Command	Purpose
`make prod-build`	Production Docker build (CI/CD)
`make prod-test`	Test production build locally

Command	Purpose
`make env-pull`	Pull `.env` from Infisical (local environment; requires `infisical login`)
`make env-push`	Push `.env` to Bitwarden shared note (legacy; requires `bw` CLI)
`make env-check`	Verify env completeness vs `.env.example`

make dev warns when the Infisical CLI is missing (warn-no-infisical).

Command	Purpose
`make sso-register`	Register local SSO redirect URI in Azure Entra (requires `ENTRA_*` in `.env`)