Theming
Contrast and accessibility
A theme is only finished when everyone can read it. These are the exact pairs Theme Studio checks, computed here for both built-in themes when the site is built.
The rules
- Text must reach 4.5:1 against the background it sits on (WCAG 2 success criterion 1.4.3). All of Studio's text is under the large-text sizes, so the lower large-text ratio never applies.
- Marks that carry meaning without being text, such as focus rings, checked boxes and the selected layer's outline, must reach 3:1 (success criterion 1.4.11).
- Disabled text is listed but never fails: WCAG exempts inactive controls.
- Translucent colors are composited first. A hover wash or a selection is laid over what's underneath it before the ratio is measured, the same way Studio draws it.
Every pair
| Where | Tokens | Needs | Studio Dark | Studio Light |
|---|---|---|---|---|
| Text on the window background | color.text on color.window | 4.5:1 | 16.63 | 13.76 |
| Text on panels | color.text on color.surface | 4.5:1 | 15.89 | 15.18 |
| Text in inputs and buttons | color.text on color.surface.raised | 4.5:1 | 14.72 | 16.82 |
| Text on cards and rows | color.text on color.surface.card | 4.5:1 | ||
| Text in menus | color.text on color.surface.overlay | 4.5:1 | 14.07 | 16.82 |
| Text on recessed areas | color.text on color.surface.sunken | 4.5:1 | 16.92 | 12.78 |
| Text on selected rows | color.text on color.selection over color.surface | 4.5:1 | 9.57 | 13.02 |
| Text on a hovered button | color.text on color.hover over color.surface.raised | 4.5:1 | 13.06 | 15.23 |
| Secondary text on panels | color.text.secondary on color.surface | 4.5:1 | 7.15 | 5.97 |
| Secondary text in inputs and buttons | color.text.secondary on color.surface.raised | 4.5:1 | 6.62 | 6.62 |
| Secondary text on cards and rows | color.text.secondary on color.surface.card | 4.5:1 | ||
| Secondary text on the window background | color.text.secondary on color.window | 4.5:1 | 7.48 | 5.41 |
| Captions on panels | color.text.tertiary on color.surface | 4.5:1 | 4.87 | 4.56 |
| Placeholder text in inputs | color.text.tertiary on color.surface.raised | 4.5:1 | 4.51 | 5.05 |
| Disabled text (not required) | color.text.disabled on color.surface.raised | not required | 1.98 | 2.01 |
| Text on the accent (primary buttons) | color.accent.text on color.accent | 4.5:1 | 11.10 | 11.10 |
| Text on a hovered primary button | color.accent.text on color.accent.hover | 4.5:1 | 12.42 | 9.84 |
| Text on a pressed primary button | color.accent.text on color.accent.pressed | 4.5:1 | 9.33 | 8.56 |
| LIVE badge text | color.live.text on color.live | 4.5:1 | 4.99 | 5.16 |
| Go live button text while reconnecting | color.warning.text on color.warning | 4.5:1 | 6.95 | 6.95 |
| Tooltip text | color.tooltip.text on color.tooltip | 4.5:1 | 12.64 | 16.82 |
| Links on panels | color.accent.strong on color.surface | 4.5:1 | 11.34 | 4.99 |
| Error text on panels | color.danger on color.surface | 4.5:1 | 5.45 | 4.50 |
| Error text on cards and rows | color.danger on color.surface.card | 4.5:1 | ||
| Text of delete buttons | color.danger.text on color.danger | 4.5:1 | 5.46 | 4.99 |
| "Allowed" status text | color.success on color.surface.card | 4.5:1 | ||
| Focus ring around inputs | color.focus on color.surface.raised | 3:1 | 6.03 | 4.05 |
| Checked boxes and sliders | color.accent.strong on color.surface | 3:1 | 11.34 | 4.99 |
| On-air dot in the scenes list | color.live on color.surface | 3:1 | 3.71 | 4.65 |
| Selected layer outline in the preview | color.preview.selection on color.preview.backdrop | 3:1 | 12.21 | 8.73 |
Use the same tokens for the same jobs in an extension and your dock passes whenever the theme does.
Status colors stay status
LIVE, errors, warnings and success must never be mistaken for the accent. Theme Studio flags a status color that's closer to the accent than a CIEDE2000 difference of 20:
color.liveLIVE redcolor.dangerError redcolor.warningWarning ambercolor.successSuccess green
Color vision
Theme Studio previews the theme as people with protanopia, deuteranopia or tritanopia see it, using Machado, Oliveira and Fernandes' 2009 model at full strength. Check that on-air, recording and error states still read as different from each other and from the accent.
Motion and focus
These belong to Studio and its UI kit rather than to a theme, but a theme shouldn't fight them:
- Focus is drawn with
color.focus. Keep it visible againstcolor.surface.raisedat 3:1 or more. - Reduced motion is respected by Studio's own animation; a theme has no motion of its own.

