diff --git a/src/content/release/breaking-changes/index.md b/src/content/release/breaking-changes/index.md index 5dd7e348eab..7c3cf38b2d0 100644 --- a/src/content/release/breaking-changes/index.md +++ b/src/content/release/breaking-changes/index.md @@ -41,12 +41,14 @@ They're sorted by release and listed in alphabetical order: * [`$FLUTTER_ROOT/version` replaced by `$FLUTTER_ROOT/bin/cache/flutter.version.json`][] * [Stop generating `AssetManifest.json`][] * [Deprecate `TextField.canRequestFocus`][] +* [Material 3 tokens update][] [`FontWeight` also controls the weight attribute of variable fonts]: /release/breaking-changes/font-weight-variation [UISceneDelegate adoption]: /release/breaking-changes/uiscenedelegate [Stop generating `AssetManifest.json`]: /release/breaking-changes/asset-manifest-dot-json [`$FLUTTER_ROOT/version` replaced by `$FLUTTER_ROOT/bin/cache/flutter.version.json`]: /release/breaking-changes/flutter-root-version-file [Deprecate `TextField.canRequestFocus`]: /release/breaking-changes/can-request-focus +[Material 3 tokens update]: /release/breaking-changes/material-color-utilities ### Released in Flutter 3.38 diff --git a/src/content/release/breaking-changes/material-color-utilities.md b/src/content/release/breaking-changes/material-color-utilities.md new file mode 100644 index 00000000000..3cd41c330af --- /dev/null +++ b/src/content/release/breaking-changes/material-color-utilities.md @@ -0,0 +1,43 @@ +--- +title: Material Color Utilities update in Flutter +description: >- + The latest Material Color Utilities have been applied to the Flutter Material + library. +--- + +{% render "docs/breaking-changes.md" %} + +## Summary + +This release updates `package:material_color_utilities` from +`v0.11.1` to `0.13.0`. This updated package includes algorithm changes that align +with the [Material 3 tokens update](/release/breaking-changes/material-design-3-token-update). + +The algorithm changes affect the same properties: + +* `onPrimaryContainer` +* `onSecondaryContainer` +* `onTertiaryContainer` +* `onErrorContainer` + +The changes will be reflected when generating a scheme using + +* `ColorScheme.fromSeed` +* `ColorScheme.fromImageProvider` +* `ThemeData(colorScheme:..)` + +## Migration guide + +In general, we believe the colors generated will be more legible and visually +appealing, but if you want to maintain the previous colors when upgrading +you will have to manually set those properties to their desired color after +generating. + +## Timeline + +* Landed in version: TBD +* In stable release: TBD + +## References + +* Relevant PR: [Update material_color_utilities to v0.13.0](https://github.com/flutter/flutter/pull/170000)