material_color_utilities
Algorithms and utilities that power the Material Design 3 color system, including choosing theme colors from images and creating tones of colors; all in a new color space.
0.13.1
7.5M downloads/mo
#79 most downloaded on pub.dev
material-foundation/material-color-utilities
What this package is like to depend on
Last release 13 days ago
10 Aug 2026
Release timing varies
gaps range from 2 weeks to 1.2 years
Nearly every release is documented
notes for 20 of 20 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
20 releases · first in 2021
1 release in the last 12 months
see the full history below
Release timeline
20 releases · Oct 2021 to Aug 2026Releases
latest 20-
0.13.110 Aug 2026Release notes
Open source →Changed
- Use
MathUtils.sanitizeDegreesDoublefor hue value calculation inCam16.
Fixed
- Fix documentation link for deprecated
Schemeclass.
- Use
-
0.13.004 Jun 2025Release notes
Open source →Changed
- Make all
MaterialDynamicColorsfieldsfinal. - Require Dart 3.5.
- Optimize ARGB and HCT color conversions in
DynamicSchemeconstructors. - Unify
errorPaletteparameter handling acrossDynamicSchemeconstructors. - Make
Schemeinternal implementation details private.
Deprecated
- Deprecate legacy
CorePaletteclass in favor ofCorePalettes.
- Make all
-
0.12.006 Jun 2024Release notes
Open source →Changed
- Update
MaterialDynamicColorsto use the expressive on-colors spec.
- Update
-
0.11.113 Mar 2024 -
0.11.011 Mar 2024Release notes
Open source →Changed
- Update
TonalPalette.fromListso that it provides colors at any tone, not only atcommonTones.
- Update
-
0.10.011 Mar 2024 -
0.9.011 Mar 2024Release notes
Open source →Added
- Add getters for
DynamicScheme.
Changed
- Move
DynamicSchemefromscheme/todynamiccolor/.
- Add getters for
-
0.8.029 Jun 2023 -
0.7.022 Jun 2023Release notes
Open source →Changed
-
Update
DynamicColorto conform to the new contrast requirements.- Modify API for
DynamicColor.
- Modify API for
-
-
0.6.016 Jun 2023Release notes
Open source →Added
-
Add key color to tonal palette.
-
Add key colors to the Material dynamic colors:
primaryPaletteKeyColorsecondaryPaletteKeyColortertiaryPaletteKeyColorneutralPaletteKeyColorneutralVariantPaletteKeyColor
Changed
- Scheme updates to align with recent Android Sys UI changes:
SchemeExpressive:- Primary hue + 240 from 120
- Neutral hue + 15
- Neutral variant hue + 15
SchemeTonalSpot:- Primary chroma = 36 from 40
SchemeVibrant:- Neutral chroma = 10 from 8
Fixed
- Fix outline when in dark mode to be tone 60.
-
-
0.5.003 May 2023 -
0.4.003 May 2023Release notes
Open source →Added
- Add
labelanddescriptionto eachVariant. - Add
xFixedMaterial dynamic colors.
Changed
- Update monochrome scheme to new spec.
Fixed
- Fix
inverseSurfacetone value.
- Add
-
0.3.013 Mar 2023Release notes
Open source →Added
-
Add 4 new components:
-
contrast: UseContrastfor utility methods. -
dislike: UseDislikeAnalyzerfor checking and fixing universally disliked colors. -
dynamiccolor: UseDynamicColorandMaterialDynamicColorsfor colors from aDynamicScheme, that adjust based on UI state (dark theme, style, preferences, contrast requirements, etc.) -
temperature: UseTemperatureCachefor analogous & complementary colors.
-
-
scheme: AddDynamicSchemeand its subclasses:SchemeExpressiveSchemeMonochromeSchemeNeutralSchemeTonalSpotSchemeVibrantSchemeFidelitySchemeContent
-
hct: AddinViewingConditionstohct, for color relativity. -
utilities: AddlstarFromYmethod, utility which is the inverse ofyFromLstar.
Changed
- Export all public API in
material_color_utilities.dart. - Bump minimum Flutter SDK version to
2.17.0.
Fixed
- Fix missing
hashCodeoverride forHct. - Fix
TonalPaletteequality operator when different constructors are used (#56).
-
-
0.2.005 Aug 2022Release notes
Open source →Added
- Add support for content color.
- Add
outlineVariantandscrimcolors.
Changed
- Rename
CamSolvertoHctSolver.
Fixed
- Correct
repositoryin pubspec.
-
0.1.525 Apr 2022Release notes
Open source →Added
- Introduce
CamSolver, a fast solver for the HCT equation. Highly performant, but a small breaking change. - Add explanation and link to
dynamic_colorpackages. - Add
operator ==andtoStringoverrides toHct.
Changed
- Improve documentation for
color_utils.dart. - Rename
HctColortoHct.
Fixed
- Fix README import.
- Introduce
-
0.1.421 Jan 2022Release notes
Open source →Added
- Allow creation of
Schemefrom aCorePalettewithlightFromCorePaletteanddarkFromCorePalette
- Allow creation of
-
0.1.310 Dec 2021 -
0.1.202 Dec 2021Release notes
Open source →Changed
- Update
Schemetonal values. - Move
matcherto pubspec'sdev_dependencies.
- Update
-
0.1.128 Oct 2021Release notes
Open source →Changed
- Update pubspec
description.
Fixed
- Fix
matcherversion incompatibility with Flutter stable.
- Update pubspec
-
0.1.028 Oct 2021