HCTHE HCLAB

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)