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.