# CLAUDE.md - Guidance for AI Assistance

## Build & Workflow Commands
- Development: `npm run dev`
- Build: `npm run build`
- Start production: `npm run start`
- Lint: `npm run lint`

## Code Style Guidelines
- **Components**: Named function exports with "use client" directive where needed
- **TypeScript**: Strict mode, explicit types for props and functions
- **Naming**: PascalCase for components, camelCase for functions/variables
- **Imports**: React → Next.js → external → internal, use path aliases (@/components, @/lib)
- **Styling**: Tailwind CSS with utility classes, use `cn()` for conditional classes
- **UI Components**: Reusable components in components/ui with consistent prop interfaces
- **Formatting**: 2-space indentation, consistent spacing, trailing commas
- **Error Handling**: Use try/catch for async operations, provide meaningful error messages

## Project Structure
- `/src/app`: Next.js App Router pages and layouts
- `/src/components`: Reusable React components, UI components in `/ui`
- `/src/lib`: Utility functions and helpers