amaliadwiy
a0ca6be8e1
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>
53 lines
1.4 KiB
Markdown
53 lines
1.4 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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
|