# Project Rules

## Architecture
- Clean architecture with domain, application, and infrastructure layers
- Domain models must not import from infrastructure
- Use dependency injection for all services

## Code Style
- TypeScript strict mode, no implicit any
- Use Result<T, E> for error handling in domain layer
- Prefer composition over inheritance
- Maximum 3 parameters per function; use options objects for more

## Testing
- Unit tests for domain logic (no mocking frameworks)
- Integration tests for API endpoints
- E2E tests for critical user journeys with Playwright

## Dependencies
- Do not add new dependencies without discussing first
- Prefer standard library over third-party for simple tasks

---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

# React Component Rules

## Structure
- Use functional components with TypeScript
- Define props interface above the component
- Export components as named exports

## Styling
- Use the project design system tokens for spacing and colors
- Prefer utility classes over custom CSS
- Keep component-specific styles colocated

## Patterns
- Wrap async data in Suspense boundaries
- Use forwardRef for reusable interactive components
- Keep components under 150 lines; extract hooks for logic

## Accessibility
- All interactive elements need aria-labels
- Use semantic HTML elements (nav, main, section)
- Ensure keyboard navigation works for custom widgets