Developer
Log in

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

WhereTokensNeedsStudio DarkStudio Light
Text on the window backgroundcolor.text on color.window4.5:1 16.63 13.76
Text on panelscolor.text on color.surface4.5:1 15.89 15.18
Text in inputs and buttonscolor.text on color.surface.raised4.5:1 14.72 16.82
Text on cards and rowscolor.text on color.surface.card4.5:1
Text in menuscolor.text on color.surface.overlay4.5:1 14.07 16.82
Text on recessed areascolor.text on color.surface.sunken4.5:1 16.92 12.78
Text on selected rowscolor.text on color.selection over color.surface4.5:1 9.57 13.02
Text on a hovered buttoncolor.text on color.hover over color.surface.raised4.5:1 13.06 15.23
Secondary text on panelscolor.text.secondary on color.surface4.5:1 7.15 5.97
Secondary text in inputs and buttonscolor.text.secondary on color.surface.raised4.5:1 6.62 6.62
Secondary text on cards and rowscolor.text.secondary on color.surface.card4.5:1
Secondary text on the window backgroundcolor.text.secondary on color.window4.5:1 7.48 5.41
Captions on panelscolor.text.tertiary on color.surface4.5:1 4.87 4.56
Placeholder text in inputscolor.text.tertiary on color.surface.raised4.5:1 4.51 5.05
Disabled text (not required)color.text.disabled on color.surface.raisednot required 1.98 2.01
Text on the accent (primary buttons)color.accent.text on color.accent4.5:1 11.10 11.10
Text on a hovered primary buttoncolor.accent.text on color.accent.hover4.5:1 12.42 9.84
Text on a pressed primary buttoncolor.accent.text on color.accent.pressed4.5:1 9.33 8.56
LIVE badge textcolor.live.text on color.live4.5:1 4.99 5.16
Go live button text while reconnectingcolor.warning.text on color.warning4.5:1 6.95 6.95
Tooltip textcolor.tooltip.text on color.tooltip4.5:1 12.64 16.82
Links on panelscolor.accent.strong on color.surface4.5:1 11.34 4.99
Error text on panelscolor.danger on color.surface4.5:1 5.45 4.50
Error text on cards and rowscolor.danger on color.surface.card4.5:1
Text of delete buttonscolor.danger.text on color.danger4.5:1 5.46 4.99
"Allowed" status textcolor.success on color.surface.card4.5:1
Focus ring around inputscolor.focus on color.surface.raised3:1 6.03 4.05
Checked boxes and sliderscolor.accent.strong on color.surface3:1 11.34 4.99
On-air dot in the scenes listcolor.live on color.surface3:1 3.71 4.65
Selected layer outline in the previewcolor.preview.selection on color.preview.backdrop3: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.live LIVE red
  • color.danger Error red
  • color.warning Warning amber
  • color.success Success 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 against color.surface.raised at 3:1 or more.
  • Reduced motion is respected by Studio's own animation; a theme has no motion of its own.

to open · ↑ ↓ to move · Esc to close