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
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.
