Prerequisites
Required
| Tool | Version | Notes |
|---|---|---|
| Node.js | 20+ (18.18 minimum) | Use nvm use 20 if you have multiple versions |
| npm | 10+ | Ships with Node |
| PostgreSQL | 14+ | Local install, Docker, or a cloud dev instance |
Recommended
- Git — version control
- Prisma Studio — browse data via
npm run db:studio - Stripe CLI — test checkout webhooks locally (optional)
- Resend account — transactional email in staging (optional; dev logs reset links to console)
PostgreSQL locally
Example with Docker:
docker run --name thehclab-postgres \
-e POSTGRES_PASSWORD=postgres \
-e POSTGRES_DB=thehclab \
-p 5432:5432 \
-d postgres:16
Connection string:
DATABASE_URL="postgresql://postgres:postgres@localhost:5432/thehclab?schema=public"
Repository layout (essentials)
src/app/ Next.js App Router routes
src/components/ UI and feature components
src/lib/ Server utilities, queries, actions
prisma/ Schema, migrations, seeds
content/docs/ This documentation (Markdown)