Files

amaliadwiy a0ca6be8e1 docs: split CLAUDE.md into focused reference files

Move architecture, testing, and dev tools detail into docs/ and
reference them via @path pointers to keep CLAUDE.md slim.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-04-24 15:46:18 +08:00

1.4 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Runtime

Default to Bun instead of Node.js everywhere:

bun <file> not node / ts-node
bun test not jest / vitest
bun install not npm install / yarn / pnpm
bun run <script> not npm run
bunx <pkg> not npx
Bun auto-loads .env — never use dotenv.

Common Commands

bun run dev          # dev server with hot reload (bun --watch src/serve.ts)
bun run build        # Vite production build
bun run start        # production server (NODE_ENV=production)
bun run typecheck    # tsc --noEmit
bun run lint         # biome check src/
bun run lint:fix     # biome check --write src/

# Database
bun run db:migrate   # prisma migrate dev
bun run db:seed      # seed demo data
bun run db:generate  # regenerate prisma client
bun run db:studio    # Prisma Studio GUI
bun run db:push      # push schema without migration

# Tests
bun run test              # all tests
bun run test:unit         # tests/unit/
bun run test:integration  # tests/integration/ — no server needed
bun run test:e2e          # tests/e2e/ — requires Lightpanda Docker

Run a single test file: bun test tests/integration/auth.test.ts

Architecture

See @docs/ARCHITECTURE.md

Testing

See @docs/TESTING.md

Dev Tools

See @docs/DEV_TOOLS.md

1.4 KiB Raw Blame History