Flutter Development

Production guidance for Flutter native mobile applications. Based on the Flutter team's official architecture guide (2024), Riverpod documentation, Very Good Ventures patterns, and Andrea Bizzotto's architecture series.

For API contract design and HTTP semantics, see /api-design. For domain modeling, see /domain-design. For design system and accessibility, see /ux-design. For observability, see /observability.

1. Architecture — MVVM with Layered Data

Two mandatory layers, one optional. Based on the Flutter team's official architecture guide.

UI Layer                          Data Layer
  View (Widget)                     Repository (single source of truth per data type)
  ViewModel (Notifier/Cubit)        Service (wraps external API/DB — no business logic)

Optional Domain Layer (use cases) only for large apps with shared cross-ViewModel logic.