# Flutter Rules

Essential rules for Flutter app development. Detailed patterns in `.kilo/skills/flutter-*`.

## Checklist

- [ ] `final`/`const` everywhere; const constructors on all widgets
- [ ] Small focused widgets; composition over inheritance
- [ ] State management via Riverpod/Bloc/Provider; no business logic in widgets
- [ ] Clean Architecture: presentation/domain/data separation
- [ ] Error handling: Result/Either types; never silently catch
- [ ] dio for HTTP; interceptors for auth/logging/retry
- [ ] go_router for navigation; handle deep links
- [ ] flutter_secure_storage for tokens; never use SharedPreferences
- [ ] Exact versions in pubspec.yaml; `flutter analyze` before commit
- [ ] Unit + widget tests; mocking; test edge cases
- [ ] Certificate pinning for APIs; obfuscate release builds

## Project Structure

```
lib/
├── main.dart
├── core/{constants,theme,utils,errors}
├── features/{auth,user}/{data,domain,presentation}
└── shared/{widgets,services}
```