Commands Reference

Setup and install

Command	Purpose
make setup	Create env files if missing and install backend/frontend dependencies
make install	Install backend and frontend dependencies
make install-backend	Backend dependencies only
make install-frontend	Frontend dependencies only

Local development

Command	Purpose
make infra	Start Postgres, Redis, and MinIO in Docker
make infra-stop	Stop infrastructure containers
make infra-down	Stop and remove infra containers/volumes
make infra-wait	Wait for infra health
make backend-dev	Run backend with reload
make frontend-dev	Run the frontend dev server
make dev-all	Start infra plus backend/frontend in one command

Full Docker stack

Command	Purpose
make stack	Start the full stack
make stack-build	Start the full stack with image rebuild
make stack-down	Stop the full stack
make stack-logs	Tail full-stack logs

Docs

Command	Purpose
make docs-install	Install Docusaurus dependencies
make docs-dev	Run the docs dev server
make docs-build	Build the docs site
make docs-serve	Preview the built docs

Database

Command	Purpose
make db-migrate	Apply Alembic migrations
make db-revision msg="..."	Create a new Alembic revision
make db-downgrade	Roll back one migration
make db-history	Show migration history

Lint and format

Command	Purpose
make format	Format backend and frontend
make lint	Lint backend and frontend
make format-backend	Backend formatting only
make lint-backend	Backend lint only

Practical Advice

• Use make dev-all for most feature work.
• Use make stack-build when env or container wiring matters.
• Use make docs-build whenever you change this Docusaurus site.
• Prefer targeted Python linting on the files you changed before finalizing work.