flutter-sdk-changelog
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.
How do I install this agent skill?
npx skills add https://github.com/randalschwartz/dart-sdk-skills --skill flutter-sdk-changelogIs this agent skill safe to install?
- Gen Agent Trust Hubfail
This skill provides a guide for Flutter SDK migrations and widget deprecations. A security concern exists because the skill references a domain (flutterreleases.com) that is blacklisted by automated scanners for malicious activity. Additionally, the skill presents speculative or non-standard framework changes as authoritative SDK requirements, which could mislead developers into adopting third-party dependencies.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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 | Deprecated in Flutter 3.50 (Introduced 3.44) | package:material_ui/material_ui.dart | Material & Cupertino Migration |
package:flutter/cupertino.dart | Deprecated in Flutter 3.50 (Introduced 3.44) | package:cupertino_ui/cupertino_ui.dart | Material & Cupertino Migration |
DropdownButtonFormField(onChanged: cond ? fn : null) | Updated in Flutter 3.50 (material_ui 1.8.0) | DropdownButtonFormField(enabled: cond, onChanged: fn) | Widget Deprecations |
TextStyle.getParagraphStyle() (without hyphens) | Updated in Flutter 3.50 | Add Hyphens? hyphens parameter (Hyphens.manual / Hyphens.hidden) | Widget Deprecations |
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_widgetsto 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
WillPopScopewithPopScopefor zero-stutter predictive back gestures on Android 14+ and iOS. - Wide-Gamut Colors: Replace
withOpacitywithwithValues(alpha: ...)to eliminate 8-bit precision loss and color clipping. - Unified State Management: Replace
MaterialStatewith universalWidgetState. 👉 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
BottomNavigationBartoNavigationBar,ToggleButtonstoSegmentedButton, and M2 buttons toFilledButton. 👉 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_widgetsto rewrite imports. - Confirm
pubspec.yamldependencies includematerial_uiandcupertino_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
ThemeDatausingColorScheme.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.yamlenvironment 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/randalschwartz/dart-sdk-skills/flutter-sdk-changelog">View flutter-sdk-changelog on skillZs</a>