@flutter

flutter-animation provides a decision tree for selecting animation strategies (implicit, explicit, tween, physics, hero, staggered) with implementation templates and a validation loop emphasizing controller disposal and performance patterns.

flutter-localizing-apps covers arb file setup, localization delegate configuration, and pluralization/placeholder syntax for multi-language flutter apps. includes ios bundle setup and common localization ancestor errors.

flutter-handling-concurrency provides patterns for offloading cpu-bound work to isolates and async operations for i/o tasks, with decision matrix and three complete workflows plus runnable examples.

flutter-architecting-apps prescribes a three-layer (ui, logic, data) structure for flutter projects with unidirectional data flow, single source of truth, and reactive state management. covers layering patterns, service/repository separation, viewmodel binding, and feature workflow.

flutter-concurrency guides isolate-based background JSON parsing and async state management to maintain 60fps ui rendering. covers decision trees for serialization strategy, short-lived and long-lived isolate patterns, and futurebuilder integration.

flutter-native-interop provides decision logic and implementation patterns for cross-platform native integration via ffi, platform channels, platform views, and js interop, with explicit guidance on thread safety and wasm constraints.

flutter-caching-data covers offline-first patterns and five caching strategies (shared_preferences, sqlite/hive, file system, state restoration, engine pre-warming) with complete workflows for repository sync and android initialization.

flutter-animating-apps covers four animation patterns (implicit, explicit, hero, physics-based) using flutter's typed animation system, with emphasis on proper resource management via controller disposal and staggered timing.

flutter-localization covers i18n/l10n setup for multi-language apps, including dependency injection, .arb file management, code generation via l10n.yaml, root widget configuration, and ios platform-specific locale registration.

flutter-http-and-json covers http request handling (get, post, put, delete) with synchronous and background json parsing. integrates firebase vertexai schemas and enforces strict status code validation with dart 3 null safety.

flutter-building-forms covers validated form construction using statefulwidgets, textformfield validators, and formstate management. addresses field-level error handling and submission workflows with concrete examples.

flutter-add-integration-test guides setup of flutter driver extensions, interactive widget exploration via mcp, and test authoring using both widgettester and legacy flutter-driver apis. covers execution paths for chrome, android, and firebase test lab with a feedback loop for debugging common failures.

flutter-routing-and-navigation guides selection and implementation of routing strategies in flutter apps, from imperative navigator for simple flows to declarative routing for deep linking and web support, with patterns for nested navigation and type-safe data passing.

flutter-databases establishes mvvm-compliant data layers using the repository pattern, with decision trees for selecting persistence tech (sqflite, hive, shared_preferences) based on data shape and size. includes code examples for offline-first sync and sql injection prevention.

flutter-building-layouts covers constraint-driven ui construction, spanning linear layouts, adaptive design, and a four-phase implementation workflow. teaches the foundational rule (constraints down, sizes up, parent positions) and identifies common pitfalls like unbounded constraints in flex boxes.

flutter-managing-state covers ephemeral state with setstate and app-level state via mvvm and provider, distinguishing management strategies and unidirectional data flow patterns.

flutter-implement-json-serialization covers manual JSON encoding/decoding via dart:convert with model classes using fromJson factories and toJson methods, including type safety enforcement and isolate-based parsing for large documents.

flutter-platform-views guides embedding native views and web content across android, ios, macos, and web platforms, with decision trees for strategy selection and code templates for each platform.

flutter-state-management guides implementers through mvvm and unidirectional data flow for flutter apps, with decision logic for ephemeral vs app state and code examples for provider-based architecture.

flutter-plugins scaffolds flutter plugin packages with native interop via method channels, ffi, or federated architectures. includes decision tree logic to select appropriate plugin type based on native code requirements and team structure.

flutter-apply-architecture-best-practices covers layered application structure via mvvm, repository injection, and separation of concerns. incomplete treatment of logic and data layers limits actionability.

flutter-setting-up-on-windows covers sdk installation, tooling configuration, visual studio c++ workload setup, and packaging workflows for windows flutter development including certificate generation for msix deployment.

flutter-layout provides widget composition patterns and a decision tree for selecting appropriate layout containers (row, column, stack, listview, gridview) based on content dimensionality and responsiveness requirements.

flutter-app-size covers measurement and optimization of app bundles across android, ios, and desktop platforms using build analysis, devtools visualization, and reduction strategies like debug info splitting and asset compression.

flutter-environment-setup-linux configures debian/ubuntu or chromeos systems for flutter desktop development by installing system dependencies, validating toolchains with flutter doctor, and prompting optional ide setup.

flutter-adding-home-screen-widgets covers implementing native home screen widgets on ios and android by synchronizing flutter state with native ui via shared local storage and the home_widget package.

flutter-setting-up-on-macos automates xcode and cocoapods configuration on macos for flutter development, validates setup via flutter doctor and flutter devices, and documents recovery steps for common installation failures.

flutter-testing-apps covers unit, widget, and integration testing strategies for flutter applications, including architectural patterns, plugin testing with native platform integration, and platform-specific execution workflows.

flutter-improving-accessibility outlines ui design patterns, semantic widget usage, and validation workflows to make flutter apps usable with screen readers and keyboard navigation.

flutter-implementing-navigation-and-routing covers imperative and declarative routing patterns, deep linking across platforms, and nested navigation for multi-step flows. provides guidance on navigator vs router selection and practical workflows with code examples.

flutter-embedding-native-views covers platform view integration across android, ios, and macos, plus web embedding modes. includes composition tradeoffs, step-by-step workflows, and performance mitigation strategies.

flutter-reducing-app-size documents core concepts for measuring and optimizing flutter bundle sizes, covering debug vs release modes, upload vs download size distinctions, and json analysis file generation with incomplete procedural workflows.

flutter-architecture describes mvvm pattern implementation with three-layer structure, unidirectional data flow, and decision logic for when to create services and repositories. focused on mobile ui reactivity via provider and listenablebuilder.

flutter-setting-up-on-linux documents linux system dependencies and workflows for flutter desktop development, including toolchain setup, environment validation, and snapcraft distribution configuration.

flutter-add-widget-test provides setup guidelines and component references for testing flutter widgets using widgettester, but lacks concrete step-by-step instructions for implementing actual test cases.

flutter-setup-localization documents the foundational steps for enabling i18n in flutter projects using flutter_localizations and intl packages with arb file organization, but execution detail is incomplete and workflow coverage lacks depth.

flutter-caching covers in-memory, persistent, and file-based data caching alongside widget rendering optimization and offline-first patterns, with android engine pre-warming for hybrid apps.

flutter-setup-declarative-routing covers go_router configuration for url-based navigation, deep linking, and nested shell routes in flutter web and mobile applications.

flutter-add-widget-preview demonstrates how to set up widget previewing using the @Preview annotation system, supporting custom configurations and runtime transformations for isolated component testing.

flutter-accessibility-audit provides guidance on semantic widget usage and accessibility testing, but the skill definition is incomplete and lacks actionable procedural detail for conducting actual audits.

Guides agents in compiling and packaging C/C++ source code into dynamic or static libraries (Code Assets) using Dart's Native Assets hook system (via…

Guide agents to use `package:ffigen` to automatically generate FFI bindings instead of writing them manually. Use this skill when a task involves writing new…

Entrypoint structure, exit codes, cross-platform scripts. Use when building command line utilities, scripts, or applications.

Replace the usage of `expect` and similar functions from `package:matcher` to `package:checks` equivalents.

Help users write syntactically and semantically correct primary constructors in Dart, and migrate/use the new constructor syntax, empty-body semicolon syntax,…

Collect coverage using the coverage packge and create an LCOV report

Use switch expressions and pattern matching where appropriate

Define and generate mock objects for external dependencies using `package:mockito` and `build_runner`. Use when unit testing classes that depend on complex…

Workflow for fixing package version conflicts. Use this when `pub get` fails due to incompatible package versions.

Uses get_runtime_errors and lsp to fetch an active stack trace, locate the failing line, apply a fix, and verify resolution via hot_reload.

Write and organize unit tests for functions, methods, and classes using `package:test`. Use when creating new logic or fixing bugs to ensure code remains…

Execute `dart analyze` to identify warnings and errors, and use `dart fix --apply` to automatically resolve mechanical lint issues. Use during development to…

Sets up a Linux environment for Flutter development. Use when configuring a Linux machine to run, build, or deploy Flutter applications.

Sets up a Windows environment for Flutter development. Use when configuring a Windows machine to run, build, or deploy Flutter applications for Windows desktop…

Sets up a macOS environment for Flutter development. Use when configuring a macOS machine to run, build, or deploy Flutter applications for iOS or macOS.

Embeds native Android, iOS, or macOS views into a Flutter app. Use when integrating complex native components like maps or web views.

Builds Flutter plugins that provide native interop for other apps to use. Use when creating reusable packages that bridge Flutter with platform-specific…

Adds home screen widgets to a Flutter app for Android and iOS. Use when providing glanceable app information or quick actions on the device home screen.

Interoperates with native platform APIs on Android, iOS, and the web. Use when accessing device-specific features not available in Dart or calling existing…

Configures a Flutter app to support assistive technologies like Screen Readers. Use when ensuring an application is usable for people with disabilities.

Manages local data persistence using SQLite or other database solutions. Use when a Flutter app needs to store, query, or synchronize large amounts of…

Configures a Flutter app to support multiple languages and regions. Use when preparing an application for international markets and diverse user locales.

Executes long-running tasks in background isolates to keep the UI responsive. Use when performing heavy computations or parsing large datasets.

Executes HTTP requests and handles JSON serialization in a Flutter app. Use when integrating with REST APIs or parsing structured data from external sources.

Builds Flutter forms with validation and user input handling. Use when creating login screens, data entry forms, or any multi-field user input.

Measures and optimizes the size of Flutter application bundles for deployment. Use when minimizing download size or meeting app store package constraints.

Implements caching strategies for Flutter apps to improve performance and offline support. Use when retaining app data locally to reduce network requests or…

Implements unit, widget, and integration tests for a Flutter app. Use when ensuring code quality and preventing regressions through automated testing.

Handles routing, navigation, and deep linking in a Flutter application. Use when moving between screens or setting up URL-based navigation.

Customizes the visual appearance of a Flutter app using the theming system. Use when defining global styles, colors, or typography for an application.

Manages application and ephemeral state in a Flutter app. Use when sharing data between widgets or handling complex UI state transitions.

Implements animated effects, transitions, and motion in a Flutter app. Use when adding visual feedback, shared element transitions, or physics-based animations.

Architects a Flutter application using the recommended layered approach (UI, Logic, Data). Use when structuring a new project or refactoring for scalability.

Builds Flutter layouts using the constraint system and layout widgets. Use when creating or refining the UI structure of a Flutter application.

Use the `http` package to execute GET, POST, PUT, or DELETE requests. Use when you need to fetch from or send data to a REST API.

Adds interactive widget previews to the project using the previews.dart system. Use when creating new UI components or updating existing screens to ensure…

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when…

Create model classes with `fromJson` and `toJson` methods using `dart:convert`. Use when manually mapping JSON keys to class properties for simple data…

Configure `MaterialApp.router` using a package like `go_router` for advanced URL-based navigation. Use when developing web applications or mobile apps that…

Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests. Use when adding integration testing to a project,…

Implement a component-level test using `WidgetTester` to verify UI rendering and user interactions (tapping, scrolling, entering text). Use when validating…

Fixes Flutter layout errors (overflows, unbounded constraints) using Dart and Flutter MCP tools. Use when addressing "RenderFlex overflowed", "Vertical…

Use `LayoutBuilder`, `MediaQuery`, or `Expanded/Flexible` to create a layout that adapts to different screen sizes. Use when you need the UI to look good on…

Architects a Flutter application using the recommended layered approach (UI, Logic, Data). Use when structuring a new project or refactoring for scalability.

Builds Flutter plugins that provide native interop for other apps to use. Use when creating reusable packages that bridge Flutter with platform-specific…

Interoperates with native platform APIs on Android, iOS, and the web. Use when accessing device-specific features not available in Dart or calling existing…

Manages local data persistence using SQLite or other database solutions. Use when a Flutter app needs to store, query, or synchronize large amounts of…

Executes HTTP requests and handles JSON serialization in a Flutter app. Use when integrating with REST APIs or parsing structured data from external sources.

Customizes the visual appearance of a Flutter app using the theming system. Use when defining global styles, colors, or typography for an application.

Use the `http` package to execute GET, POST, PUT, or DELETE requests. Use when you need to fetch from or send data to a REST API.

Fixes Flutter layout errors (overflows, unbounded constraints) using Dart and Flutter MCP tools. Use when addressing "RenderFlex overflowed", "Vertical…

Use `LayoutBuilder`, `MediaQuery`, or `Expanded/Flexible` to create a layout that adapts to different screen sizes. Use when you need the UI to look good on…

flutter-environment-setup-windows — an installable skill for AI agents, published by flutter/skills.

flutter-environment-setup-macos — an installable skill for AI agents, published by flutter/skills.

flutter-accessibility — an installable skill for AI agents, published by flutter/skills.

flutter-testing — an installable skill for AI agents, published by flutter/skills.

flutter-theming — an installable skill for AI agents, published by flutter/skills.

flutter-performance — an installable skill for AI agents, published by flutter/skills.

Adding a Home Screen widget to your Flutter App