Icon Delivery Formats

## The model: an icon is painted by its context A **single-color icon** is a shape with one paint. If that paint is a fixed color stored in the file, the icon is one color forever. If the paint instead resolves to the **current foreground color** of whatever contains it — the color the surrounding text uses — the same file renders correctly everywhere the text does. Every platform a design system targets supports this model. On the web, a vector icon's paint can refer to the current text color; on native mobile, an image can be marked as a template or tintable asset and colored by the view that shows it. The mechanism differs; the decision is the same: **the icon asset carries shape, and the context supplies color**. ## What inheriting buys a music app Consider the play button, the like button and the download icon in a track row: - **States.** The button already changes its text color for idle, pressed, selected and disabled. An inheriting icon follows along; a fixed one needs a variant per state. - **Surfaces and themes.** The same row appears on a light library screen and on a dark now-playing screen. The container's foreground color changes with the surface, and the icon follows. - **High-contrast settings.** When a platform setting forces text to a limited set of high-contrast colors, icons painted with the current foreground color follow the forced color; icons with a baked fill may keep a color that now disappears. - **Asset count.** One file per glyph instead of one per glyph per color. Hundreds of icons times several colors is the difference between a set and a warehouse. | Approach | Files per glyph | Follows states and themes | Risk | |---|---|---|---| | Inherits foreground color | 1 | Yes, automatically | Wrong only if the container's color is wrong | | Fixed fill per color | 1 per color | Only if someone picks the right file | Missing variants, drift between copies | | Fixed fill, recolored at runtime by filters | 1 | Partially | Fragile, hard to match exact colors | ## Where it goes wrong in practice The usual failure is not the model but the **export**. Design editors commonly export icons with a concrete fill — often black — on every path. If the delivery pipeline passes that through: 1. The icon looks fine on light surfaces, so nobody notices in review. 2. On the dark now-playing screen it stays black and nearly vanishes. 3. A partial fix — one path left with a hard-coded fill — produces icons that are half-tinted, which is worse because it looks like a drawing error. The fix belongs in the pipeline: single-color icons have every fixed fill and stroke color removed or replaced with the inheriting paint, and a check fails the build if any remains. ## When not to inherit Inheritance is a default, not a law: - **Multicolor artwork** — a partner speaker brand's logo in the connected-devices list, album-art thumbnails, illustrated empty states — has colors that carry identity or meaning. Treat it as an image with its own colors, not as a tintable icon. - **An icon whose color must differ from its text**, such as a warning icon beside neutral text, should get its color from the container or from a semantic color passed to the icon — still not from a color baked into the file. - **Two-tone icons** need two paints. Systems handle these with two named layers, each mapped to a color role, rather than with a fixed second color. ## What it does not solve Inheriting color makes an icon follow its text; it does not guarantee the result is legible. An icon in a pale secondary text color may still fall below the contrast an informative icon needs, and whether an icon is informative or decorative is a separate decision. Inheritance removes a whole class of theming bugs, and leaves the color choices themselves to be checked. ## What the icon contract should say A design system makes the model explicit so every team applies it the same way: - Single-color icons are delivered **without any fixed color** and always take the current foreground color. - The icon component accepts an optional **semantic color** (for example success, warning, muted) for the rare case where an icon must differ from its text, and never a raw color value. - Multicolor artwork lives in a **separate group** with its colors intact, and is documented as an image, not an icon. - The pipeline check that strips fills runs on every export, so a new icon cannot quietly reintroduce a baked color. With those four rules, a music app can add a new surface, a new state or a new theme without touching a single icon file.