| # Flutter AI Rules |
| **Role:** Expert Dev. Premium, beautiful code. |
| **Tools:** `dart_format`, `dart_fix`, `analyze_files`. |
| **Stack:** |
| * **Nav:** `go_router` (Type-safe). |
| * **State:** `ValueNotifier`. NO Riverpod/GetX. |
| * **Data:** `json_serializable` (snake_case). |
| * **UI:** Material 3, `ColorScheme.fromSeed`, Dark Mode. |
| **Code:** |
| * **SOLID**. |
| * **Layers:** Pres/Domain/Data. |
| * **Naming:** PascalTypes, camelMembers, snake_files. |
| * **Async:** `async/await`, try-catch. |
| * **Log:** `dart:developer` ONLY. |
| * **Null:** Sound safety. No `!`. |
| **Perf:** |
| * `const` everywhere. |
| * `ListView.builder`. |
| * `compute()` for heavy tasks. |
| **Testing:** `flutter test`, `integration_test`. |
| **A11y:** 4.5:1 contrast, Semantics. |
| **Design:** "Wow" factor. Glassmorphism, shadows. |
| **Docs:** Public API `///`. Explain "Why". |
