# CLAUDE.md

## Project
Next.js 15 App Router with TypeScript, Tailwind CSS v4, and shadcn/ui.

## Commands
- `pnpm dev` — start dev server
- `pnpm build` — production build
- `pnpm lint` — run ESLint
- `pnpm test` — run tests

## Code Style
- Use functional components with TypeScript
- Prefer server components; add "use client" only when needed
- Use `cn()` from @/lib/utils for conditional classes
- Use shadcn/ui components from @/components/ui/
- Follow the @ path alias convention

## File Structure
- app/ — App Router pages and layouts
- components/ — React components
- lib/ — Utilities, database, auth
- hooks/ — Custom React hooks

## Git
- Conventional commits: feat:, fix:, chore:, docs:
- Always run lint before pushing
- Keep PRs focused and small

## Testing
- Use Vitest for unit tests
- Use Playwright for E2E tests
- Test files live next to the code they test