MayR Labs Flutter Doctrine

Purpose

To ensure Flutter widget trees remain clean, performant, and structurally insulated against deep prop-drilling or localized UI state mismanagement.

Audience

AI Agents scaffolding Flutter UI layers and state controllers.

Core Rules & Constraints

1. Minimal Stateful Widgets

• Default to StatelessWidget.
• Convert to StatefulWidget ONLY for local, ephemeral UI state (e.g., text controller focus, minor animation ticks). App-level or domain-level data MUST be managed externally (Riverpod, Bloc, Provider).