DiveDay

Delight-first dive shop operations: bookings, waivers, cert checks, trip prep, and boat manifests in one place that's a genuine pleasure to use.

Built entirely by AI agents. The repo is structured for that: AGENTS.md is the agent entry point, docs/ is the project's memory (vision, dive-domain glossary, ADRs, design principles, workflow), .claude/skills/ carries the task-scoped skills, and .claude/agents/ carries the reviewer agents that encode how work gets done here.

Quickstart

Requires Node 24 and pnpm 12.4.1 — the repository pins both, in .nvmrc and packageManager, and pnpm check:node-version keeps every other place that names a version agreeing with them.

pnpm install
pnpm dev          # http://localhost:3000

Local development and tests use an embedded database and safe fallbacks, so no configuration is required. When you do need a real credential, .env.manual is the one file to edit — pnpm env:manual creates it and pnpm check:env says what each blank line switches off. .env.local is generated by pnpm infra:deploy and overwritten on every run. E2E tests use the sandbox/system Chrome and never download a second browser; set PLAYWRIGHT_CHROMIUM_EXECUTABLE or CHROME_PATH if its location is not auto-detected.

pnpm dev defaults the canonical origin to http://localhost:<port> using the port Next actually selects, including its automatic fallback when 3000 is occupied. An APP_HOST already set in the shell or a dotenv file wins; set it explicitly for a custom hostname or HTTPS.

Command	What
pnpm check	repository safeguards + lint + typecheck + unit tests
pnpm test	unit tests (Vitest)
pnpm e2e	end-to-end tests (Playwright)
pnpm visual	capture the visual surfaces and diff them against the S3 baseline for the parent commit
pnpm build	production build

Stack

Next.js 16 · React 19 · TypeScript strict · Tailwind 4 · Biome · Vitest · Playwright · pnpm — rationale in docs/architecture/decisions/.

Reading order

1. docs/product/vision.md — why this exists
2. docs/design/principles.md — what "delight-first" means concretely
3. docs/product/features/roadmap.md — where it's headed