CLAUDE.md for Turborepo/Nx monorepo projects

# TypeScript Monorepo

## Overview
Monorepo using Turborepo with shared TypeScript packages.

## Tech Stack
- Build: Turborepo
- Package Manager: pnpm
- Language: TypeScript
- Testing: Vitest

## Key Commands
```bash
# From root
pnpm install              # Install all deps
pnpm dev                  # Dev all packages
pnpm build                # Build all packages
pnpm test                 # Test all packages
pnpm lint                 # Lint all packages

# Specific package
pnpm --filter @repo/web dev
pnpm --filter @repo/api build
```

## Project Structure
```
/
├── apps/
│   ├── web/              # Next.js frontend
│   ├── api/              # Backend service
│   └── docs/             # Documentation
├── packages/
│   ├── ui/               # Shared components
│   ├── config/           # Shared configs
│   ├── types/            # Shared types
│   └── utils/            # Shared utilities
├── turbo.json            # Pipeline config
└── pnpm-workspace.yaml   # Workspace config
```

## Conventions
- Internal packages use `@repo/` prefix
- Shared types in `packages/types`
- Use workspace protocol: `"@repo/ui": "workspace:*"`

## Important Notes
- Turborepo caches builds automatically
- Use `--filter` for targeted commands
- Update root `package.json` for new deps