Makefile Reference

We use a Master Makefile to standardize operations across environments.

Setup

Command	Description
make install	Install dependencies using pnpm.
make setup	Full setup: install deps + create .env + deploy DB + seed.

Development

Command	Description
make dev	Start both Web App and Worker.
make dev-web	Start Web App only (localhost:3000).
make dev-worker	Start Worker only.

Database

Command	Description
make db-deploy	Apply migrations (safe for production).
make db-push	Push schema changes (prototyping only).
make db-seed	Seed database with demo data.
make db-studio	Open Prisma Studio GUI.

Quality & Testing

Command	Description
make test	Run critical smoke tests.
make test-all	Run full E2E and Visual regression tests.
make lint	Run ESLint and Prettier.
make audit	Run background script audit.

Deployment

Command	Description
make deploy-stage	Deploy current branch to Staging (Vercel).
make deploy-prod	Deploy Master to Production (Prompted).

Maintenance

Command	Description
make clean	Remove node_modules, .next, and build artifacts.
make clean-duplicates	Run duplicate detection pipeline.