# Flutter

> Flutter patterns — widget architecture, state management, Impeller renderer, platform-adaptive design

- Skill: `xoai/flutter` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add xoai/flutter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xoai/flutter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xoai (https://skillmd.com/u/xoai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xoai/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`.