Bookie

Healthcare booking platform — Next.js frontend + Express/Prisma API + PostgreSQL.

Stack

• Web: Next.js 16, React 19, Ant Design, Tailwind, Zustand
• API: Express 5, Prisma, JWT session cookies
• DB: PostgreSQL 16 (Docker)

Quick start

pnpm install        # generates Prisma client; migrates + seeds when Postgres is up
cp .env.example .env.local
cp server/.env.example server/.env

pnpm db:up          # start Postgres (Docker required)
pnpm dev            # Next.js :7004 + API :9004

pnpm install runs migrations and seed automatically when server/.env exists and Postgres is reachable. If the database is down, install still succeeds — run pnpm db:up then pnpm db:setup once.

Pre-commit hooks run eslint --fix on staged files (including import sorting).

Open http://localhost:7004.

Scripts

Command	Description
pnpm dev	Next.js + API in parallel
pnpm dev:web	Next.js only (port 7004)
pnpm server:dev	API only (port 9004)
pnpm watch	Alias for pnpm dev
pnpm db:up / pnpm db:down	Docker Postgres
pnpm db:migrate	Apply migrations
pnpm db:seed	Seed sample data
pnpm verify	The full guard — typecheck (web + server), gates, lint, test, build
pnpm lint	ESLint (--max-warnings 0)
pnpm lint-fix	ESLint with auto-fix (imports, etc.)
pnpm typecheck	TypeScript — web only, the root tsconfig excludes server/
pnpm typecheck:server	TypeScript for the API package
pnpm gates	Design-system + export-style grep gates

Documentation

docs/DEV_CREDS.md	Local login credentials (seeded emails + dev password)
docs/DATABASE_STRUCTURE.md	Schema, API envelope, routes
docs/BACKLOG.md	Known defects and outstanding work
docs/history/	Completed work, kept for the reasoning
CLAUDE.md	Conventions and codebase map, for humans and agents alike

Each major directory also carries its own CLAUDE.md with that layer's invariants — src/api, src/app, src/components, src/helpers, src/store, src/styles, server, tests. Read the local one before editing there.

Deploy

Push to master deploys: GitHub Actions builds both sides, ships them to the server, migrates, and restarts. Server setup, the secrets table, both nginx server blocks and the rollback procedure are in docs/DEPLOYMENT.md.