# {{PROJECT_NAME}} - React Native / Expo

> Genere: {{GENERATION_DATE}} | Claude Craft v{{VERSION}}

## Quoi (Stack & Structure)

**Stack**: {{TECH_STACK}}
**Framework**: React Native {{REACT_NATIVE_VERSION}} + Expo {{EXPO_SDK_VERSION}}
**TypeScript**: {{TYPESCRIPT_VERSION}}

### Structure du projet
```
src/
├── app/                    # Expo Router (file-based routing)
├── components/             # Composants reutilisables
├── features/               # Features par domaine metier
│   └── [feature]/
│       ├── components/
│       ├── hooks/
│       └── types/
├── hooks/                  # Custom hooks globaux
├── services/               # API, Storage
├── stores/                 # State management (Zustand)
├── types/                  # Types TypeScript
├── theme/                  # Colors, spacing
└── utils/                  # Utilitaires
```

## Pourquoi (Objectif & Organisation)

### Architecture: Feature-Based + Clean Layers
- **Presentation (UI)**: app/, components/
- **Application (Logic)**: hooks/, stores/
- **Domain (Business)**: types/, utils/
- **Data (Services)**: services/

Voir `rules/02-architecture.md` pour les patterns.

### Regles critiques

| Regle | Description |
|-------|-------------|
| Analyse avant code | Consulter `rules/01-workflow-analysis.md` |
| TypeScript strict | Mode strict, 0 erreurs |
| ESLint 0 errors | Qualite code obligatoire |
| Coverage 80%+ | Tests obligatoires |
| 60 FPS | Performance target |

## Comment (Commandes & Workflows)

### Commandes de developpement
```bash
npx expo start             # Demarrer dev server
npx expo start --ios       # Run iOS
npx expo start --android   # Run Android
npx expo start --clear     # Clear cache
```

### Pipeline de qualite
```bash
npm run type-check         # Verification types
npm run lint               # ESLint
npm run lint:fix           # Fix lint
npm run format             # Prettier
npm test                   # Tests
npm run test:coverage      # Coverage
```

### Build & Deploy (EAS)
```bash
eas build --profile development --platform all   # Dev build
eas build --profile production --platform all    # Prod build
eas submit --platform ios                        # Submit iOS
eas update --branch production                   # OTA Update
```

### Decision state management
- Data serveur? -> React Query
- Etat global? -> Zustand
- Persistance? -> MMKV
- URL state? -> Expo Router params
- Local state? -> useState

### Workflow de developpement
1. **Analyser** - `rules/01-workflow-analysis.md`
2. **TDD** - Test first (Jest + RNTL)
3. **Qualite** - Lint + Type-check + Tests
4. **Commit** - Conventional Commits

## References

| Contexte | Fichier |
|----------|---------|
| Workflow | `rules/01-workflow-analysis.md` |
| Architecture | `rules/02-architecture.md` |
| Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Tests | `rules/07-testing.md` |
| State | `rules/13-state-management.md` |
| Navigation | `rules/14-navigation.md` |
| Securite | `rules/11-security.md` |
| Performance | `rules/12-performance.md` |

<!-- PROJECT-SPECIFIC-START -->
## Specificites du projet

<!-- Cette section est preservee lors des mises a jour -->

<!-- PROJECT-SPECIFIC-END -->
