flutter-architect

flutter-architect is a skill for Claude Code, Codex from m3taz-ahmed/ai-globals. It costs 59 tokens per session (2,383 once invoked), scanned A, original, MIT.

A full guide to planning and building Flutter applications for mobile, web, desktop, and other platforms from one Dart codebase. It covers both the visual interface and the application’s data, state, navigation, testing, and release structure.

In plain words
What is it for?
Use it to structure Flutter projects, build responsive interfaces, manage application state and navigation, connect data and storage, profile performance, test the app, and set up CI/CD releases.
Why use it?
It helps keep a multi-platform app’s architecture, dependencies, interface, performance, and delivery process consistent. It also provides guidance for choosing common Flutter tools for state management, routing, data storage, and testing.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to structure Flutter projects, build responsive interfaces, manage application state and navigation, connect data and storage, profile performance, test the app, and set up CI/CD releases.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/m3taz-ahmed/ai-globals/flutter-architect
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add m3taz-ahmed/ai-globals --skill flutter-architect
Clone the repo
git clone --depth 1 https://github.com/m3taz-ahmed/ai-globals

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for flutter-architect

README.md
[![agentmods](https://agentmods.dev/badge/skills/m3taz-ahmed/ai-globals/flutter-architect/github.svg)](https://agentmods.dev/skills/m3taz-ahmed/ai-globals/flutter-architect)
Your own site
<a href="https://agentmods.dev/skills/m3taz-ahmed/ai-globals/flutter-architect"><img src="https://agentmods.dev/badge/skills/m3taz-ahmed/ai-globals/flutter-architect/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for flutter-architect

Your own site · 80×15
<a href="https://agentmods.dev/skills/m3taz-ahmed/ai-globals/flutter-architect"><img src="https://agentmods.dev/badge/skills/m3taz-ahmed/ai-globals/flutter-architect.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 59 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,383 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00059 $0.02383
Opus 5 $0.00030 $0.01192
Sonnet 5 $0.00012 $0.00477
Haiku 4.5 $0.00006 $0.00238

Measured 12d ago against content hash da097d127e44, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

flutter-architect scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/flutter-architect/SKILL.md · 48 lines

How it starts

The opening of the file, as written. The whole thing — 48 lines — stays where its author put it; the contents beside it link to each section on GitHub.

[SKILL] flutter-architect [OBJ] Architect, design, build, profile, and ship production-grade Flutter apps across iOS, Android, web, and desktop from a single Dart codebase — owning both the visual layer (design system, theming, motion, accessibility) and the engineering layer (state, architecture, networking, persistence, testing, CI/CD). [PERSONAS] MOBILE (primary), UX (primary), ARCH (secondary), DEV (secondary). [SUB-SKILLS] flutter-design (UX/visual layer), flutter-developer (engineering layer).

[RULES]

  1. [CMD] Context7 IDs: Flutter /flutter/website; Flutter API /websites/api_flutter_dev; Flutter Packages /flutter/packages; Dart /dart-lang/site-www; Riverpod /riverpod/riverpod; go_router /flutter/packages (go_router subpath); BLoC /felangel/bloc; Freezed /rrousselGit/freezed; Drift /simolus3/drift.
  2. [REQ] [VER-01] Pin to lockfile exact versions. Read pubspec.lock -> grep flutter: sdk: dart: -> load tech-stack/flutter-<ver>.md. NEVER assume Flutter version; default reference is Flutter 3.47 / Dart 3.13 (Aug 2026). Material 3 is default ON since Flutter 3.16 — never set useMaterial3: false without justification.
  3. [REQ] Project anatomy (feature-first): lib/{core,features,config,l10n,routing}; one feature = one folder with data/ (models, datasources, repos), domain/ (entities, repo interfaces, usecases), presentation/ (widgets, pages, controllers). Keep main.dart < 30 lines; app entry only.
  4. [REQ] Architecture: clean-ish layering (presentation -> domain -> data). Dependency rule: presentation depends on domain, data depends on domain, domain depends on nothing. No BuildContext in domain/data. No business logic in build().
  5. [REQ] State management decision tree: local ephemeral UI state -> setState/ValueNotifier; scoped shared state -> Riverpod (prefer Notifier/AsyncNotifier + ref.watch/ref.read, avoid legacy StateProvider for complex state); event-driven / strict separation / large teams -> BLoC (Cubit for simple). NEVER use InheritedWidget manually for app state. NEVER mix setState with a global store.
  6. [REQ] Immutability: models via freezed + json_serializable; const constructors everywhere possible; @immutable on widgets holding mutable fields flagged. Use Dart 3.13 primary constructors for concise immutable data classes when language version >= 3.1.
  7. [REQ] Routing: go_router + go_router_builder for all non-trivial apps. Declarative routes with TypedGoRoute/TypedStatefulShellRoute (compile-time safe via go_router_builder); ShellRoute/StatefulShellRoute.indexedStack for nested nav with state preservation; redirect for auth guards; extra for typed args (define route-arg classes, never raw Map). Use PopScope (NOT deprecated WillPopScope) for Android predictive back (Android 14+). Router Refresh Pattern: use _RouterRefreshNotifier (ChangeNotifier) + ref.listen to trigger redirects on auth state change WITHOUT rebuilding the router (preserves bottom nav state).
  8. [REQ] Theming & design system: single ThemeData via ColorScheme.fromSeed() + TextTheme (GoogleFonts or bundled fonts); expose via Theme.of(context) ONLY — no hardcoded Color(0x...) in widgets. Support light + dark + system. Define spacing/radius/elevation tokens as constants or ThemeExtension. See flutter-design for full design-system rules.
  9. [REQ] Networking: dio (interceptors: auth, logging, retry, error-mapping) or http for simple; optional retrofit for type-safe API definitions (@RestApi() annotations + retrofit_generator). Deserialize via freezed + json_serializable; repository pattern wraps datasources; never call HTTP from widgets. Backend isolation: backend SDK (Firebase, Supabase) imports forbidden outside data/ layers and entrypoints — domain/presentation remain backend-agnostic. Handle loading/error/empty states explicitly in every async view. Freezed Failure union: @freezed class Failure { network/cache/auth/server/permission/unknown } with exhaustive pattern matching.
  10. [REQ] Persistence: drift (typed SQLite), hive/isar for KV, shared_preferences for primitives only. Local-first with conflict resolution for offline apps; encrypt sensitive stores (flutter_secure_storage).
  11. [REQ] Performance budget: 60 FPS (16.6 ms/frame); profile with Flutter DevTools (Performance + CPU/Memory tabs). Use const widgets, RepaintBoundary around animations, ListView.builder (never ListView(children:) for >20 items), itemExtent when known, AutomaticKeepAliveClientMixin sparingly. Avoid rebuilds: scope Consumer/Selector to the smallest subtree; prefer ref.watch in leaf widgets.
  12. [REQ] Accessibility: Semantics on custom gesture widgets; respect MediaQuery.textScaler (never fixed font sizes); large-tap-targets >= 48x48 dp; test with TalkBack + VoiceOver; ExcludeSemantics only when overriding. WCAG AA contrast via ColorScheme.
  13. [REQ] Testing two-tier [TEST-07]: FAST -> flutter test test/path/to/touched_test.dart (~5s); FULL -> flutter test --coverage (target >= 80% logic, >= 70% total) + flutter test integration_test/. Widget tests via testWidgets + WidgetTester; mock with mocktail (Dart-friendly, no annotation boilerplate). One behavior per test (AAA). No hardcoded IDs/dates — use factories.
  14. [REQ] CI/CD: GitHub Actions / Codemagic / Fastlane. Lanes: analyze (flutter analyze --fatal-infos), format (dart format --set-exit-if-changed), test, build (per platform), deploy. Build AAB (Android) + IPA/XCArchive (iOS); sign via Play App Signing + App Store Connect API key. Pin action SHAs [GIT-05]; OIDC keyless where supported.
  15. [REQ] L10n: flutter_localizations + intl + ARB files; gen-l10n for typed AppLocalizations; OR Slang (^4.12.0) for compile-time safe translations with zero runtime lookup. Never hardcode user-facing strings; RTL-aware layouts (test Directionality(textDirection: TextDirection.rtl)); mirror directional icons.
  16. [REQ] Security [SEC-01..10]: zero-trust input validation (Form + validators); no secrets in code (use .env + --dart-define / flutter_dotenv); HTTPS only + certificate pinning for sensitive APIs; flutter_secure_storage for tokens; obfuscate release builds (--obfuscate --split-debug-info); Play Integrity / DeviceCheck for anti-tamper.
  17. [REQ] Code quality [CODE-01..05]: widget files < 300 lines, build() < 30 lines; extract widgets to classes (not methods) for perf + reuse; enums/constants over magic strings; strict typing — avoid dynamic, prefer sealed classes / pattern matching (Dart 3). No TODO/FIXME without ticket tag.
  18. [REQ] Cross-platform: feature-detect with Platform.isIOS/Platform.isAndroid/kIsWeb; MediaQuery.padding/SafeArea for notches; adaptive widgets (Platform.isIOS ? CupertinoActionSheet : BottomSheet); responsive via LayoutBuilder + breakpoints (compact < 600, medium 600-840, expanded > 840).
  19. [REQ] Animations: implicit (AnimatedContainer/AnimatedOpacity) for simple; AnimationController + CurvedAnimation for sequenced; Hero for shared-element transitions; Rive/Lottie for designer-authored; CustomPainter + RepaintBoundary for canvas. Dispose controllers.
  20. [REQ] Query Context7 for ANY Flutter/Dart/package API before implementation. Test on physical devices (iOS + Android) before declaring done. Run flutter analyze + dart format + targeted tests during iteration; FULL suite + coverage before done.
  21. [REQ] UseCase pattern: abstract class UseCase<R, P> { Future<Result<R>> call(P params); } — encapsulates single business operations, testable, reusable. Each feature's domain layer exposes usecases that controllers call.
  22. [REQ] Multi-flavor: main_dev.dart, main_staging.dart, main_production.dart entry points with separate Firebase/env configs. --flavor + --dart-define-from-file for environment injection.
  23. [REQ] Observability: sentry_flutter for crash reporting + posthog_flutter for product analytics + feature flags + session replay. Wire observers into router for automatic screen tracking. Reset analytics identity on logout.
  24. [REQ] E2E testing: integration_test (floor) + Patrol (ceiling — handles native permission dialogs, system sheets). Maestro (YAML, cross-platform) for black-box E2E if team prefers non-Dart authoring.
  25. [REQ] IAP/Monetization: in_app_purchase plugin for Flutter IAP; RevenueCat for subscription lifecycle management (cross-platform, server-side receipt validation).

Read the full file on GitHub · 48 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 48 lines · 59 tokens per session scan A da097d127e44

Subscribe to this mod's changes

flutter-architect is a skill published in the GitHub repository m3taz-ahmed/ai-globals (5 stars, last pushed yesterday), licensed MIT. It adds 59 tokens to every session and 2,383 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

orca-emulator-android

Android device and emulator control from inside Orca over adb, with the live device view in Orca's emulator pane. Use when driving an adb-connected emulator or phone on Windows, Linux, or macOS: booting AVDs, taps, swipes, typing, hardware buttons, rotation, app install and launch, runtime permissions, the…

stablyai/orca · 102 tokens

android-tombstone-symbolication

Symbolicate the .NET runtime frames in an Android tombstone file. Extracts BuildIds and PC offsets from the native backtrace, downloads debug symbols from the Microsoft symbol server, and runs llvm-symbolizer to produce function names with source file and line numbers. USE FOR triaging a .NET MAUI or Mono Android app…

dotnet/skills · 176 tokens

dogfood

Systematically explore and test a mobile app on iOS/Android with agent-device to find bugs, UX issues, and other problems. Use when asked to dogfood, QA, exploratory test, find issues, bug hunt, or test this app on mobile.

callstack/agent-device · 55 tokens

winapp-maui

Package and sign .NET MAUI Windows apps with winapp, resolving the resizetizer manifest dependency. Use when packaging or signing a .NET MAUI Windows app, building a MAUI MSIX or signed unpackaged build in CI, or fixing 'manifest contains unresolved placeholders ($placeholder$)' errors from winapp package.

microsoft/winappCli · 71 tokens

react-native-ease-refactor

Scan for Animated/Reanimated code and migrate to EaseView.

appandflow/react-native-ease · 18 tokens

apple-search-ads

When the user wants to set up, optimize, or scale Apple Search Ads (ASA) campaigns — including keyword bidding, match types, campaign structure, Creative Product Sets, CPP routing, and ROAS optimization. Use when the user mentions "Apple Search Ads", "ASA", "Search Ads", "Search tab ads", "Today tab ads", "CPT"…

Eronred/aso-skills · 127 tokens