Choose two real stable releases. Boring Doc lists every indexed change between them with its evidence, impact and migration instructions, and can fetch the verified source diff from GitHub.
690 indexed changes across 11 versions: 4 breaking change, 3 removed, 13 deprecated api, 98 new feature, 162 improvement, 9 performance, 85 platform-specific, 121 developer tooling, 175 bug fix, 20 documentation.
7 high-impact items. Start with: CupertinoDynamicColor wide gamut support; SnackBar with action no longer auto-dismisses; The default page transition on Android is now PredictiveBackPageTransitionBuilder; ….
Read the 5 official migration guides first, apply `dart fix` where available, then upgrade and run your test suite. Deprecations can be scheduled; removals cannot.
Prefer stepping through stable series sequentially; each breaking-change page has a checklist, before/after code and the official guide. Verify with `flutter analyze`, `flutter test` and a profile-mode run on each target platform.
A source diff proves code changed; it does not by itself show that a public API is breaking. Use it to corroborate the announcements above.
Certain properties and methods in `CupertinoDynamicColor` were deprecated to align with the `Color` class due to wide gamut color spaces support added in Flutter 3.27.
The default behavior of a `SnackBar` with an action has changed. Previously, a `SnackBar` with an action wouldn't auto-dismiss if talkback was enabled. Now, all `SnackBar` widgets with an action default to a non-dismissible state until the user interacts with the action button.
The default page transition on Android has been updated from `ZoomPageTransitionsBuilder` to `PredictiveBackPageTransitionsBuilder`. When not using predictive back, this falls back to `FadeForwardsPageTransitionsBuilder`.
Learn how to migrate your Flutter iOS app, add-to-app integration, or plugin to Apple's required UIScene lifecycle.
Remove deprecated `AssetManifest.json` file (Framework, by @matanlurey).
Remove 2023 deprecated `'platforms'` key from daemon output (Tooling, by @matanlurey).
Remove deprecated `--[no-]-disable-dds` (Tooling, by @matanlurey).
[Impeller] Optimize scale translate rectangle transforms (Other changes, by @flar).
[Impeller] Optimize scale translate rectangle transforms (Other changes, by @flar).
Delete Skia-specific performance overlay implementation (Other changes, by @flar).
[CP-beta]Add guided error for precompiled cache error (iOS, by @flutteractionsbot).
Perform OpenGL compositing in the Flutter thread and write to a framebuffer. (Linux, by @robert-ancell).
Use a fake representation of `cache/artifacts/gradle_wrapper` (Tooling, by @matanlurey).
[Impeller] Improvements to the Vulkan pipeline cache data writer (Other changes, by @jason-simmons).
Read `bin/cache/flutter.version.json` instead of `version` for `flutter_gallery` (Other changes, by @matanlurey).
[Impeller] Disable the render target cache when creating a snapshot in DlImageImpeller::MakeFromYUVTextures (Other changes, by @jason-simmons).
AI_PROVIDER (for example to openai-compatible with a local Ollama or LM Studio endpoint) to enable grounded explanations. Everything else on this page works without an AI provider.