RandalSchwartzRandalSchwartz/dart-sdk-skills/skills/flutter-sdk-changelog/SKILL.md

flutter-sdk-changelog

Skill34 starsChanged 3 months agoMITView on GitHub

Authoritative guide for Flutter framework APIs, widget lifecycle deprecations, design package unbundling, and version changelogs from Flutter 1.0 through Flutter 3.x+. Use this skill whenever authoring Flutter widgets, inspecting flutter sdk constraints, handling deprecated widgets (WillPopScope, withOpacity, MaterialState, FlatButton), migrating to standalone design libraries (material_ui, cupertino_ui), verifying widget API availability against the project's Flutter minSdk, or upgrading legacy Flutter applications.

1 other project uses a version of this.

Adopted by

Most recently taken up by

jahfaliabdulrahman-dev/hermes-skillstheir own version, first seen Oct 3, 2026

Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
jahfaliabdulrahman-dev/hermes-skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository2 other files it gives its agents.
- AGENTS.mdAGENTS.md
- dart-sdk-changelogSkill

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
Automated Fix: Run dart fix --apply --code=migrate_design_widgets to update imports and dependencies automatically.
line 45
Distinctive:
Follow the 5-phase pipeline in the Legacy Flutter App Rescue Runbook:
line 97
Distinctive:
Check toolchain → Sound Null Safety bridge &rarr.
line 98

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

Flutter SDK Changelog & Widget Migration Guide (Flutter 1.0 to Modern Flutter)

This skill provides an authoritative, structured reference for Flutter framework releases, widget deprecations, API replacements, Material 3 design migrations, the decoupling of standalone material_ui and cupertino_ui packages, and legacy Flutter codebase rescue runbooks.

🎯 Fast Flutter Widget & API Replacement Matrix

Deprecated / Obsolete API	Introduced / Deprecated In	Modern Replacement	Reference
`Color.withOpacity(o)`	Deprecated in Flutter 3.22	`Color.withValues(alpha: o)`	Widget Deprecations
`MaterialState` / `MaterialStateProperty`	Deprecated in Flutter 3.22	`WidgetState` / `WidgetStateProperty`	Widget Deprecations
`WillPopScope`	Deprecated in Flutter 3.12+	`PopScope(canPop: ..., onPopInvokedWithResult: ...)`	Widget Deprecations
`FlatButton`, `RaisedButton`, `OutlineButton`	Deprecated in Flutter 2.0	`TextButton`, `ElevatedButton`, `OutlinedButton`	Widget Deprecations
`TextTheme.headline1...6`, `bodyText1/2`	Deprecated in Flutter 3.7+	`displayLarge...small`, `bodyLarge/Medium`	Widget Deprecations
`ThemeData.accentColor`	Deprecated in Flutter 2.5+	`ColorScheme.secondary`	Widget Deprecations
`Scaffold.of(context).showSnackBar()`	Deprecated in Flutter 2.0	`ScaffoldMessenger.of(context).showSnackBar()`	Widget Deprecations
`package:flutter/material.dart`	Monolithic Flutter SDK	`package:material_ui/material_ui.dart`	Material & Cupertino Migration
`package:flutter/cupertino.dart`	Monolithic Flutter SDK	`package:cupertino_ui/cupertino_ui.dart`	Material & Cupertino Migration
`BottomNavigationBar`	Legacy M2 Navigation	`NavigationBar` (Material 3)	Material 3 Guide
`ToggleButtons`	Legacy M2 Toggle	`SegmentedButton<T>` (Material 3)	Material 3 Guide
`describeEnum(e)`	Removed in Flutter 3.47	`e.name` (Dart 2.15+ native property)	Widget Deprecations
`ContextMenuButtonType` / `item.type`	Superseded in Flutter 3.47.9	`ContextMenuButtonKind` / `item.kind` (with `_` case)	Widget Deprecations
`ReorderableListView.onReorder`	Deprecated in Flutter 3.44	`onReorderWithOldAndNewIndex`	Widget Deprecations
`PopupMenuButton`	Legacy popup menu	`MenuAnchor` / `SubmenuButton`	Material 3 Guide

⚡ Subskill Spotlights

Subskill: Standalone `material_ui` & `cupertino_ui` Package Migration

Decoupled Architecture: Transition from monolithic framework design libraries to standalone pub packages with independent release cadences.
Automated Fix: Run dart fix --apply --code=migrate_design_widgets to update imports and dependencies automatically.
Headless Core Support: Construct purely custom design systems directly against package:flutter/widgets.dart. 👉 Read the full Material & Cupertino UI Migration Guide.

Subskill: Widget Deprecations & Modernization

Predictive Back Navigation: Replace WillPopScope with PopScope for zero-stutter predictive back gestures on Android 14+ and iOS.
Wide-Gamut Colors: Replace withOpacity with withValues(alpha: ...) to eliminate 8-bit precision loss and color clipping.
Unified State Management: Replace MaterialState with universal WidgetState. 👉 Read the full Widget Deprecations & Replacements Guide.

Subskill: Material 2 to Material 3 Migration

Seed-Based Theming: Generate tonal palettes with ColorScheme.fromSeed(seedColor: ...).
Component Modernization: Migrate from BottomNavigationBar to NavigationBar, ToggleButtons to SegmentedButton, and M2 buttons to FilledButton. 👉 Read the full Material 2 to Material 3 Guide.

Subskill: Rescuing Legacy Flutter Apps (Flutter 1.x / 2.x to Modern 3.x)

5-Phase Upgrade Pipeline: Baseline toolchain check → null safety bridge → widget deprecation fixes → Material 3 update → modern state & routing. 👉 Read the full Legacy Flutter App Rescue Runbook.

📚 Table of Contents & Reference Archive

Document	Focus Area	Description
`material-ui-and-cupertino-ui-migration.md`	Package Decoupling	Complete runbook for migrating from SDK-bundled material/cupertino to standalone `material_ui` and `cupertino_ui`.
`flutter-to-dart-version-matrix.md`	Version Mapping	Full mapping of Flutter 1.0–3.50+ to bundled Dart SDKs and engine milestones.
`widget-deprecations-and-replacements.md`	Widget Dictionary	Before/After code snippets for all deprecated Flutter widgets and properties.
`material-2-to-material-3-guide.md`	UI & Theming	Comprehensive Material 3 migration guide, dynamic color schemes, and new components.
`rescuing-legacy-flutter-apps.md`	Upgrade Runbook	5-phase structured runbook for stepping legacy Flutter apps to modern Flutter.

🛠️ Recommended Runbooks

1. Migrating to Standalone `material_ui` & `cupertino_ui`

Execute dart fix --apply --code=migrate_design_widgets to rewrite imports.
Confirm pubspec.yaml dependencies include material_ui and cupertino_ui.
Consult the Material & Cupertino UI Migration Guide for localization updates and headless architectures.

2. Migrating Deprecated Widgets & Properties

Identify the deprecated widget or property (for example WillPopScope, Color.withOpacity, MaterialStateProperty).
Consult the Widget Deprecations Guide.
Replace with the modern declarative equivalent (for example PopScope, Color.withValues(alpha: ...), WidgetStateProperty).

3. Migrating to Material 3

Review the Material 2 to Material 3 Guide.
Configure ThemeData using ColorScheme.fromSeed(seedColor: ...).
Replace legacy navigation bars (BottomNavigationBar → NavigationBar) and controls (ToggleButtons → SegmentedButton).

4. Upgrading / Rescuing Legacy Flutter Apps

Determine current Flutter and Dart versions from pubspec.yaml environment block.
Follow the 5-phase pipeline in the Legacy Flutter App Rescue Runbook:
- Check toolchain → Sound Null Safety bridge → Widget deprecations → Material 3 theme → Modern routing & reactive state.

5. Answering "What's New in Flutter X.Y"

Match the Flutter version in the Flutter to Dart Version Matrix.
State the bundled Dart SDK version, major framework milestones, and engine updates.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free