flutter
Layer 2 — Framework Pack
Flutter patterns for modern development (3.x+). Widget architecture, state
management, Impeller renderer, platform-adaptive design, and the common
mistakes agents make from outdated tutorials.
Philosophy
Flutter's "everything is a widget" model is simultaneously its greatest strength
and the main source of agent mistakes. Agents build monolithic widget trees with
thousands of lines, misuse setState for everything, nest widgets 15 levels
deep, and ignore the widget lifecycle. This pack establishes clean widget
architecture, proper state management selection, and Impeller-era performance
patterns.
What's Included
| Type |
Files |
Coverage |
| Patterns |
7 |
Widget architecture, state management, async/data, navigation, platform-adaptive, testing, performance |
| Anti-patterns |
5 |
God widgets, setState everywhere, ignoring dispose, hardcoded dimensions, unnecessary packages |
| Constitution |
1 |
5 Flutter-specific principles |
| Gate |
1 |
Flutter pattern compliance check |
Stack Integrations (detection-gated)
When firebase_core is detected, read integration/firebase-integration.md for
the Flutter + Firebase + Riverpod seams — auth, Firestore, Cloud Functions, and
project structure — that the individual docs don't cover together. This folds in
the former stack-flutter-firebase skill; the content is unchanged.
Constitution: constitution/firebase.constitution-additions.md ·
anti-patterns: anti-patterns/firebase-anti-patterns.md.
1---2name: flutter3description: Flutter patterns — widget architecture, state management, Impeller renderer, platform-adaptive design4---56# flutter78**Layer 2 — Framework Pack**910Flutter patterns for modern development (3.x+). Widget architecture, state11management, Impeller renderer, platform-adaptive design, and the common12mistakes agents make from outdated tutorials.1314## Philosophy1516Flutter's "everything is a widget" model is simultaneously its greatest strength17and the main source of agent mistakes. Agents build monolithic widget trees with18thousands of lines, misuse `setState` for everything, nest widgets 15 levels19deep, and ignore the widget lifecycle. This pack establishes clean widget20architecture, proper state management selection, and Impeller-era performance21patterns.2223## What's Included2425| Type | Files | Coverage |26|------|-------|----------|27| Patterns | 7 | Widget architecture, state management, async/data, navigation, platform-adaptive, testing, performance |28| Anti-patterns | 5 | God widgets, setState everywhere, ignoring dispose, hardcoded dimensions, unnecessary packages |29| Constitution | 1 | 5 Flutter-specific principles |30| Gate | 1 | Flutter pattern compliance check |3132## Stack Integrations (detection-gated)3334When `firebase_core` is detected, read `integration/firebase-integration.md` for35the Flutter + Firebase + Riverpod seams — auth, Firestore, Cloud Functions, and36project structure — that the individual docs don't cover together. This folds in37the former `stack-flutter-firebase` skill; the content is unchanged.38Constitution: `constitution/firebase.constitution-additions.md` ·39anti-patterns: `anti-patterns/firebase-anti-patterns.md`.
xoai