flutter

# 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`.