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.
37 indexed changes across 9 versions: 5 breaking change, 5 deprecated api, 27 bug fix.
5 high-impact items. Start with: Material Theme System Updates; .flutter-plugins-dependencies replaces .flutter-plugins; Localized messages are generated into source, not a synthetic package; ….
Read the 10 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.
`CardTheme`, `DialogTheme` and `TabBarTheme` were refactored to conform to Flutter's conventions for component themes. `CardThemeData`, `DialogThemeData` and `TabBarThemeData` were added to define overrides for the defaults of the component visual properties.
The `flutter` tool will no longer output the `.flutter-plugins` metadata file, and only output `.flutter-plugins-dependencies`.
The `flutter` tool will no longer generate a synthetic `package:flutter_gen` or modify the `package_config.json` of the app.
Unless a user-defined `goldenFileComparator` is set, either manually in a test, or using a `flutter_test_config.dart` file, Android and iOS devices and emulators/simulators have a new default that proxies to the local host filesystem, fixing a long-standing bug (#143299).
The formula for `SpringDescription` changed to correct an earlier error, affecting underdamped springs (damping ratio less than 1) with mass values other than 1. Springs created prior to this change may exhibit different bouncing behaviors after upgrading.
`SystemContextMenuController.show` is deprecated. The same functionality can be achieved by passing the result of calling `SystemContextMenu.getDefaultItems` to `SystemContextMenuController.showWithItems`.
`ExpansionTileController` is deprecated. The same functionality can be achieved by using `ExpansibleController` instead.
When routes are pushed, developers can await them to be notified when they are popped. However, this didn't work when they were removed because the associated future was never completed.
The `ThemeData.indicatorColor` parameter was deprecated in favor of the `TabBarThemeData.indicatorColor` parameter.
The `InputDecoration.maintainHintHeight` parameter was deprecated in favor of the `InputDecoration.maintainHintSize` parameter.
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.