What problem does it solve?
Provides a clear, production-ready set of rules and checklists to avoid fragmentation and bugs when implementing Flutter screens, widgets, simulators, and feature wiring inside the MINT mobile codebase, ensuring consistency with project conventions and preventing accidental changes to backend services.
Core Features & Use Cases
- Enforces working only inside apps/mobile/ and never touching services/backend/.
- Prescribes GoRouter navigation patterns, Provider state management, and mandatory use of the Mint UI kit and MintColors palette.
- Includes checklists for new screens and simulators, testing patterns (widget tests, mocking SharedPreferences, viewport setup), and anti-bug discipline steps for tracing and validation.
- Real-world use case: wire certificate extraction to CoachProfile persistence and trigger recalculation, or consolidate scattered retirement features into a single retirement cockpit using provided services and feature flags.
Quick Start
Open the apps/mobile/ directory, create a new screen following the New Screen Checklist, register its route in app.dart, use Mint UI components and MintColors, add at least one smoke test, then run flutter analyze and flutter test.