From 730fa5836d16cac63968defc8e7f975c089e544e Mon Sep 17 00:00:00 2001 From: Kevin Moore Date: Fri, 13 Jun 2025 10:18:48 -0700 Subject: [PATCH 1/6] Update the material 3 design token docs This aligns the docs with the changes in https://github.com/flutter/flutter/pull/170000 --- .../material-design-3-token-update.md | 46 +++++++++++++++---- 1 file changed, 36 insertions(+), 10 deletions(-) diff --git a/src/content/release/breaking-changes/material-design-3-token-update.md b/src/content/release/breaking-changes/material-design-3-token-update.md index 7d4b52f8dd4..e7072d17849 100644 --- a/src/content/release/breaking-changes/material-design-3-token-update.md +++ b/src/content/release/breaking-changes/material-design-3-token-update.md @@ -5,6 +5,32 @@ description: >- the Flutter Material library. --- +# Flutter 3.33+ + +This release includes an update to `package:material_color_utilities` from +`v0.11.1` to `0.13.`. This updated package includes algorithm changes that align +with the colors changes that were shipped in Flutter 3.27 (see below). + +The algorithm changes affect the same properties: + +- `onPrimaryContainer` +- `onSecondaryContainer` +- `onTertiaryContainer` +- `onErrorContainer` + +The changes will be reflected when generating scheme using + +- `ColorScheme.fromSeed` +- `ColorScheme.fromImageProvider` +- `ThemeData(colorScheme:..)` + +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. + +# Flutter 3.27 + ## Summary The Material Design tokens updated the mapping of @@ -14,10 +40,10 @@ Testing identified this change as [non-breaking][] in Flutter, but some customers might notice this small change. The update affected the following color properties: -* `onPrimaryContainer` (Primary10 to Primary30) -* `onSecondaryContainer` (Secondary10 to Secondary30) -* `onTertiaryContainer` (Tertiary10 to Tertiary30) -* `onErrorContainer` (Error10 to Error30) +- `onPrimaryContainer` (Primary10 to Primary30) +- `onSecondaryContainer` (Secondary10 to Secondary30) +- `onTertiaryContainer` (Tertiary10 to Tertiary30) +- `onErrorContainer` (Error10 to Error30) Widgets that have been using these roles as their default values might look different. @@ -73,7 +99,7 @@ final chip = ChipTheme( ), ), child: ActionChip( - label: const Text('action chip'), + label: const Text('action chip'), onPressed: () {} ) ); @@ -88,14 +114,14 @@ In stable release: 3.27 API documentation: -* [`ColorScheme`][] -* [`ThemeData`][] -* [`Chip`][] +- [`ColorScheme`][] +- [`ThemeData`][] +- [`Chip`][] Relevant PRs: -* [Update tokens to v5.0.0][] -* [Update tokens to v6.1.0][] +- [Update tokens to v5.0.0][] +- [Update tokens to v6.1.0][] [`ColorScheme`]: {{site.api}}/flutter/material/ColorScheme-class.html [`ThemeData`]: {{site.api}}/flutter/material/ThemeData-class.html From 7c8b5a39cf818239b94d38ef2ce9a51b363f158e Mon Sep 17 00:00:00 2001 From: Kevin Moore Date: Fri, 13 Jun 2025 11:12:28 -0700 Subject: [PATCH 2/6] Update src/content/release/breaking-changes/material-design-3-token-update.md Co-authored-by: Shams Zakhour (ignore Sfshaza) <44418985+sfshaza2@users.noreply.github.com> --- .../release/breaking-changes/material-design-3-token-update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/release/breaking-changes/material-design-3-token-update.md b/src/content/release/breaking-changes/material-design-3-token-update.md index e7072d17849..526af98e78e 100644 --- a/src/content/release/breaking-changes/material-design-3-token-update.md +++ b/src/content/release/breaking-changes/material-design-3-token-update.md @@ -7,7 +7,7 @@ description: >- # Flutter 3.33+ -This release includes an update to `package:material_color_utilities` from +This release updates `package:material_color_utilities` from `v0.11.1` to `0.13.`. This updated package includes algorithm changes that align with the colors changes that were shipped in Flutter 3.27 (see below). From e2e299d24a41c38dbc2e62b1c62341158ccafcdb Mon Sep 17 00:00:00 2001 From: Kevin Moore Date: Fri, 13 Jun 2025 11:12:37 -0700 Subject: [PATCH 3/6] Update src/content/release/breaking-changes/material-design-3-token-update.md Co-authored-by: Shams Zakhour (ignore Sfshaza) <44418985+sfshaza2@users.noreply.github.com> --- .../release/breaking-changes/material-design-3-token-update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/release/breaking-changes/material-design-3-token-update.md b/src/content/release/breaking-changes/material-design-3-token-update.md index 526af98e78e..a4da1cfb374 100644 --- a/src/content/release/breaking-changes/material-design-3-token-update.md +++ b/src/content/release/breaking-changes/material-design-3-token-update.md @@ -9,7 +9,7 @@ description: >- This release updates `package:material_color_utilities` from `v0.11.1` to `0.13.`. This updated package includes algorithm changes that align -with the colors changes that were shipped in Flutter 3.27 (see below). +with the colors changes shipped in Flutter 3.27 (see below). The algorithm changes affect the same properties: From 434ab735d7772aa8acceaba60fff48b1ad3315f1 Mon Sep 17 00:00:00 2001 From: Kevin Moore Date: Fri, 13 Jun 2025 11:12:42 -0700 Subject: [PATCH 4/6] Update src/content/release/breaking-changes/material-design-3-token-update.md Co-authored-by: Shams Zakhour (ignore Sfshaza) <44418985+sfshaza2@users.noreply.github.com> --- .../release/breaking-changes/material-design-3-token-update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/release/breaking-changes/material-design-3-token-update.md b/src/content/release/breaking-changes/material-design-3-token-update.md index a4da1cfb374..c7486ed0e77 100644 --- a/src/content/release/breaking-changes/material-design-3-token-update.md +++ b/src/content/release/breaking-changes/material-design-3-token-update.md @@ -18,7 +18,7 @@ The algorithm changes affect the same properties: - `onTertiaryContainer` - `onErrorContainer` -The changes will be reflected when generating scheme using +The changes will be reflected when generating a scheme using - `ColorScheme.fromSeed` - `ColorScheme.fromImageProvider` From 5fd4f9602852d227396a2a53ba3100a6edfec21a Mon Sep 17 00:00:00 2001 From: Kevin Moore Date: Fri, 13 Jun 2025 11:16:02 -0700 Subject: [PATCH 5/6] use star for bullets --- .../material-design-3-token-update.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/src/content/release/breaking-changes/material-design-3-token-update.md b/src/content/release/breaking-changes/material-design-3-token-update.md index c7486ed0e77..69091601109 100644 --- a/src/content/release/breaking-changes/material-design-3-token-update.md +++ b/src/content/release/breaking-changes/material-design-3-token-update.md @@ -13,16 +13,16 @@ with the colors changes shipped in Flutter 3.27 (see below). The algorithm changes affect the same properties: -- `onPrimaryContainer` -- `onSecondaryContainer` -- `onTertiaryContainer` -- `onErrorContainer` +* `onPrimaryContainer` +* `onSecondaryContainer` +* `onTertiaryContainer` +* `onErrorContainer` The changes will be reflected when generating a scheme using -- `ColorScheme.fromSeed` -- `ColorScheme.fromImageProvider` -- `ThemeData(colorScheme:..)` +* `ColorScheme.fromSeed` +* `ColorScheme.fromImageProvider` +* `ThemeData(colorScheme:..)` 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 @@ -40,10 +40,10 @@ Testing identified this change as [non-breaking][] in Flutter, but some customers might notice this small change. The update affected the following color properties: -- `onPrimaryContainer` (Primary10 to Primary30) -- `onSecondaryContainer` (Secondary10 to Secondary30) -- `onTertiaryContainer` (Tertiary10 to Tertiary30) -- `onErrorContainer` (Error10 to Error30) +* `onPrimaryContainer` (Primary10 to Primary30) +* `onSecondaryContainer` (Secondary10 to Secondary30) +* `onTertiaryContainer` (Tertiary10 to Tertiary30) +* `onErrorContainer` (Error10 to Error30) Widgets that have been using these roles as their default values might look different. @@ -114,14 +114,14 @@ In stable release: 3.27 API documentation: -- [`ColorScheme`][] -- [`ThemeData`][] -- [`Chip`][] +* [`ColorScheme`][] +* [`ThemeData`][] +* [`Chip`][] Relevant PRs: -- [Update tokens to v5.0.0][] -- [Update tokens to v6.1.0][] +* [Update tokens to v5.0.0][] +* [Update tokens to v6.1.0][] [`ColorScheme`]: {{site.api}}/flutter/material/ColorScheme-class.html [`ThemeData`]: {{site.api}}/flutter/material/ThemeData-class.html From b336f87afa2e7cb4d62aa3366d801d618613e88f Mon Sep 17 00:00:00 2001 From: Kevin Moore Date: Fri, 13 Jun 2025 11:16:35 -0700 Subject: [PATCH 6/6] oops --- .../release/breaking-changes/material-design-3-token-update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/release/breaking-changes/material-design-3-token-update.md b/src/content/release/breaking-changes/material-design-3-token-update.md index 69091601109..c46bf81cccc 100644 --- a/src/content/release/breaking-changes/material-design-3-token-update.md +++ b/src/content/release/breaking-changes/material-design-3-token-update.md @@ -8,7 +8,7 @@ description: >- # Flutter 3.33+ This release updates `package:material_color_utilities` from -`v0.11.1` to `0.13.`. This updated package includes algorithm changes that align +`v0.11.1` to `0.13.0`. This updated package includes algorithm changes that align with the colors changes shipped in Flutter 3.27 (see below). The algorithm changes affect the same properties: