Algorithms and utilities that power the Material Design 3 (M3) color system, including choosing theme colors from images and creating tones of colors; all in a new color space.

A common use case for this library is extracting a single color from an image. Here's how to do that:

Coming soon

The library is built out of multiple components

• each with its own folder

• each as small as possible

• Not all consumers will need every component — ex. MDC doesn’t need quantization/scoring/image extraction

• Turns a wallpaper into N colors
• Celebi, which runs Wu, then WSMeans

• Rank colors for suitability for theming
• Quantize buckets a wallpaper into 128 colors
• Enables deduplicating and ranking that output.

• Mapping from roles, i.e. names like primary, to colors.

• Tonal Palette — range of colors that varies only in tone
• Core Palette — set of tonal palettes needed to create Material color schemes

• Hue, chroma, tone
• A new color space based on CAM16 x L*
• Accounts for viewing conditions

• Color interpolation in HCT
• Harmonizing, animations, gradients

• Color — conversions between color spaces needed to implement HCT/CAM16
• Math — functions for ex. ensuring hue is between 0 and 360, clamping, etc.

Learn about the M3 color system.

The Material Theme Builder Figma plugin and web tool are recommended for design workflows. The Material Theme Builder delivers dynamic color to where design is done. Designers can take an existing design, and see what it looks like under different themes, with just a couple clicks.