# Project Conventions

## Language
- TypeScript strict mode, no `any` types
- Prefer const over let, never use var
- Use template literals over string concatenation

## Architecture
- Feature-based folder structure under src/features/
- Each feature exports through an index.ts barrel file
- Shared utilities go in src/lib/

## Error Handling
- Use Result<T, E> pattern for expected failures
- Throw only for programmer errors
- Always log errors with structured context

## Testing
- Colocate tests next to source files (*.test.ts)
- Use factories for test data, not fixtures
- Integration tests in __tests__/ directories

# Code Standards

## TypeScript
- Enable strict mode in all tsconfig files
- No `any` types — use `unknown` and narrow
- Prefer interfaces over type aliases for object shapes

## React
- Functional components only
- Use custom hooks for shared stateful logic
- Colocate component, styles, and tests

## Git
- Conventional commits (feat:, fix:, chore:, etc.)
- Keep commits atomic and focused
- Squash merge feature branches