Developer
Log in

Theming

Theme Studio

Theme Studio is a window inside Velum Studio for making themes. Every token on the left, the real app restyled live on the right, and checks that tell you what fails before anyone else sees it.

Open it from Appearance: New theme… starts a theme from the selected one, and Edit theme… opens one of yours.

Every token, on the left

The tokens, in their groups (Surfaces, Text, Accent and status, Preview, Chrome, Type, Shape and spacing). Each row says where its value comes from ("From Studio Dark", or "Set here") and has a reset button that goes back to the inherited value.

  • Colors: click the dot for a color picker (with transparency), or type any value the file accepts. The link button picks another token instead, and the percentage next to it is how much of that token's color shows through, written as "{color.accent} @ 22%".
  • Numbers: drag a field left or right to change it (Shift moves faster, Alt slower), or click it to type.
  • The accent's hover and pressed colors follow the accent, a step lighter and a step darker, until you set one of them yourself.

The real app, on the right

Not a mock-up: the header with LIVE and REC on, Scenes, Layers, the Inspector on your first layer, the Chat panel's own rows (messages, a follow, a sub, support, a redemption card, a raid), and a dock built from standard controls, the way an extension's is. It shows your own scenes and layers. It's there to look at; clicks and keys don't reach it.

Checks, on every change

Under the preview, Theme Studio checks the theme each time anything changes:

  • Contrast. Every pair of text (or a mark like a focus ring) and the background it sits on somewhere in the app, against WCAG AA: 4.5:1 for text, 3:1 for marks that aren't text. A failing pair is named with its ratio, for example "Captions on panels: 3.67, needs 4.5". Disabled text is listed but never fails, because WCAG exempts inactive controls. The full list is on Contrast and accessibility.
  • Status colors against the accent. The LIVE red, error red, warning amber and success green must read as status, not as the accent. One closer to the accent than a CIEDE2000 difference of 20 is flagged.
  • Color vision. See the preview as people with protanopia, deuteranopia or tritanopia do (Machado, Oliveira and Fernandes' 2009 model, at full strength).

Start from

  • Studio Dark or Studio Light: that built-in, with nothing set.
  • An accent color: every color token is built around it, for the dark or light appearance. Switch with the Dark/Light control right after and it's built again for the other. Each color moves only as far as it must for every contrast pair to pass, so a starter theme always passes.
  • A picture: brand art, a logo, a screenshot. Studio finds its main colors, marks the one it would use as the accent (the most colorful one that covers a fair share of the picture), and shows the dark and light themes it makes. Pick another color if you like.

Export

Export .velumtheme… writes one file to share or install, with a preview of the theme and an icon made from it. See Sharing: .velumtheme.

The file stays yours

Theme Studio writes the same JSON file a text editor would, and Studio watches it: edits made by hand apply at once, even while Theme Studio is open, and Theme Studio picks them up.

to open · ↑ ↓ to move · Esc to close