diff --git a/docs/design.md b/docs/design.md index 588b53904..6cf7e4689 100644 --- a/docs/design.md +++ b/docs/design.md @@ -40,6 +40,8 @@ The rule, condensed: text that _names_ a surface or a group is `medium`. Text th Foreground is for the thing being acted on: row titles, section headings, the selected sidebar item. `foregroundMuted` is for context: hints, descriptions, secondary metadata, idle sidebar items, placeholders, status text. +`foregroundExtraMuted` is reserved for passive chrome that must sit behind muted text, such as an always-visible window control. Use the solid token instead of lowering SVG opacity; per-path opacity makes overlapping icon strokes render unevenly. Interactive hover and pressed states return to `foreground`. + Accent is the one CTA per surface. A `