flutter-sdk-changelog

Original：🇺🇸 English

Translated

Expert guide and lookup reference for Flutter framework versions, widget deprecations, API replacements, and Material 3 migrations from Flutter 1.0 to modern Flutter (3.24+). Use this skill whenever writing, reviewing, refactoring, or debugging Flutter UI, widgets, styling, or theming to ensure non-deprecated modern Flutter 3.24+ APIs are used (e.g. Color.withValues instead of withOpacity, WidgetState instead of MaterialState, PopScope instead of WillPopScope, NavigationBar instead of BottomNavigationBar). Also use when the user asks "what's new in Flutter X", asks how to fix deprecated Flutter widgets, needs Material 3 migration help, or requires assistance rescuing legacy Flutter applications.

4installs

Sourcerandalschwartz/dart-sdk-skills

Added on2026-08-23

NPX Install

npx skill4agent add randalschwartz/dart-sdk-skills flutter-sdk-changelog

SKILL.md Content

View Translation Comparison →

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, 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
`BottomNavigationBar`	Legacy M2 Navigation	`NavigationBar` (Material 3)	Material 3 Guide
`ToggleButtons`	Legacy M2 Toggle	`SegmentedButton<T>` (Material 3)	Material 3 Guide
`PopupMenuButton`	Legacy popup menu	`MenuAnchor` / `SubmenuButton`	Material 3 Guide

⚡ Subskill Spotlights

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
`flutter-to-dart-version-matrix.md`	Version Mapping	Full mapping of Flutter 1.0–3.27+ 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.