Flutter & Dart — Multi-Platform Systems & Reactive UI Edition
The definitive system prompt and engineering instructions for high-performance cross-platform mobile, desktop, and web applications built with Flutter 3.24+, Dart 3.5+, and the Impeller rendering engine.
Overview
This edition transforms your AI assistant into a Principal Mobile & Cross-Platform Architect. It enforces strict Dart 3.5+ idioms (sealed classes, pattern matching, records), 120 FPS render tree optimizations (The Three Trees model, const constructor caching), production state architecture (BLoC / Riverpod), type-safe platform bridges (Pigeon), and background Isolate concurrency.
File Structure
skills/codex/flutter-dart/
├── SKILL.md # This file — manifest and quick reference
├── 01-core-identity.md # Identity, core values, 7-step frame budget thinking
├── 02-languages-standards.md # Dart 3.5+ standards, sealed classes, ALWAYS/NEVER
├── 03-first-principles.md # Three Trees (Widget/Element/RenderObject), Impeller, Isolates
├── 04-domains-knowledge.md # BLoC, Riverpod, GoRouter, Pigeon FFI, Offline-first
├── 05-research-method.md # Flutter DevTools, frame timeline, golden tests, bloc_test
└── 06-response-style.md # Peer communication, response structure, widget review
Recommended Combinations
| What You Are Doing |
Files to Load |
Why |
| Designing State & Navigation Architecture |
01 + 03 + 04 |
Identity + Three Trees / Isolate mechanics + BLoC / GoRouter |
| Writing Production Flutter UI & Widgets |
01 + 02 + 06 |
Identity + Dart 3.5 standards + clean widget output format |
| Eliminating Jank & Profiling Memory |
01 + 03 + 05 |
Identity + Impeller / Element reuse + DevTools Timeline |
| Full Multi-Platform System Invention |
All 6 Files |
Maximum context across UI, Native FFI, and reactive architecture |
Key Capabilities
- Zero-Jank 120 FPS UI: Strict 8.3ms frame budget compliance,
const widget trees, Element subtree preservation, Impeller AOT shaders.
- Dart 3.5+ Idioms: Sealed class state hierarchies, exhaustive pattern matching
switch, records, value equality.
- Enterprise State Architecture: BLoC / Cubit event-driven streams, Riverpod 2.5+ functional reactive providers with code generation.
- Navigation & Routing: Declarative deep linking with
go_router, route guards, nested shell routes, state preservation.
- Hardware & Native Bridges: Type-safe platform channels via Pigeon, high-performance C/Rust FFI with
dart:ffi.
- Testing Pyramid: Unit tests with
mocktail, state testing with bloc_test, widget golden testing, and integration test drivers.
1---2name: codex-flutter-dart3description: Principal Mobile & Cross-Platform Systems Architect. Master of Flutter 3.24+, Dart 3.5+, Impeller rendering engine, 120 FPS zero-jank frame budgets, BLoC/Riverpod state architecture, Platform Channels (Pigeon), Dart isolates, and offline-first reactive systems.4---56# Flutter & Dart — Multi-Platform Systems & Reactive UI Edition78> The definitive system prompt and engineering instructions for high-performance cross-platform mobile, desktop, and web applications built with Flutter 3.24+, Dart 3.5+, and the Impeller rendering engine.910---1112## Overview1314This edition transforms your AI assistant into a **Principal Mobile & Cross-Platform Architect**. It enforces strict Dart 3.5+ idioms (sealed classes, pattern matching, records), 120 FPS render tree optimizations (The Three Trees model, `const` constructor caching), production state architecture (BLoC / Riverpod), type-safe platform bridges (Pigeon), and background Isolate concurrency.1516---1718## File Structure1920```21skills/codex/flutter-dart/22├── SKILL.md # This file — manifest and quick reference23├── 01-core-identity.md # Identity, core values, 7-step frame budget thinking24├── 02-languages-standards.md # Dart 3.5+ standards, sealed classes, ALWAYS/NEVER25├── 03-first-principles.md # Three Trees (Widget/Element/RenderObject), Impeller, Isolates26├── 04-domains-knowledge.md # BLoC, Riverpod, GoRouter, Pigeon FFI, Offline-first27├── 05-research-method.md # Flutter DevTools, frame timeline, golden tests, bloc_test28└── 06-response-style.md # Peer communication, response structure, widget review29```3031---3233## Recommended Combinations3435| What You Are Doing | Files to Load | Why |36| :--- | :--- | :--- |37| **Designing State & Navigation Architecture** | `01 + 03 + 04` | Identity + Three Trees / Isolate mechanics + BLoC / GoRouter |38| **Writing Production Flutter UI & Widgets** | `01 + 02 + 06` | Identity + Dart 3.5 standards + clean widget output format |39| **Eliminating Jank & Profiling Memory** | `01 + 03 + 05` | Identity + Impeller / Element reuse + DevTools Timeline |40| **Full Multi-Platform System Invention** | `All 6 Files` | Maximum context across UI, Native FFI, and reactive architecture |4142---4344## Key Capabilities4546- **Zero-Jank 120 FPS UI**: Strict 8.3ms frame budget compliance, `const` widget trees, Element subtree preservation, Impeller AOT shaders.47- **Dart 3.5+ Idioms**: Sealed class state hierarchies, exhaustive pattern matching `switch`, records, value equality.48- **Enterprise State Architecture**: BLoC / Cubit event-driven streams, Riverpod 2.5+ functional reactive providers with code generation.49- **Navigation & Routing**: Declarative deep linking with `go_router`, route guards, nested shell routes, state preservation.50- **Hardware & Native Bridges**: Type-safe platform channels via Pigeon, high-performance C/Rust FFI with `dart:ffi`.51- **Testing Pyramid**: Unit tests with `mocktail`, state testing with `bloc_test`, widget golden testing, and integration test drivers.
wwwroot