Developer
Log in

Theming

Theming

Velum Studio's whole look comes from one small set of design tokens. A theme is a JSON file that sets some of them; everything else comes from the theme it extends. A useful theme can be three lines.

Make one in a minute

  1. Open Appearance (the gear in the top-right corner, or Ctrl+,).
  2. Pick the theme you want to start from and click New theme…. Theme Studio opens with a new theme based on it, already saved in your themes folder.
  3. Change a few colors. The whole app follows as you drag, and the file is saved a moment after you stop.

To change one of your themes later, select it in Appearance and click Edit theme…. Built-in themes can't be edited in place; make a new theme from them.

What Theme Studio writes

The same small file you could write by hand:

JSONmy-studio-dark.json
{
  "format": "velum-theme/1",
  "id": "my-studio-dark",
  "name": "My Studio Dark",
  "author": "",
  "appearance": "dark",
  "extends": "studio-dark",
  "tokens": {
    "color.accent": "#FF375F",
    "color.accent.hover": "#FF5E73",
    "color.accent.pressed": "#EC1C51"
  }
}

Open it in any text editor at any time, even while Theme Studio is open: every save applies instantly, and Theme Studio picks up what you changed.

The two built-in themes

Studio Dark, as Theme Studio previews it
Studio Dark, as Theme Studio previews it
Studio Light, as Theme Studio previews it
Studio Light, as Theme Studio previews it

Studio Dark sets every token. Studio Light extends it and sets only what changes for a light appearance, which makes it the best example of how small a theme can be. Both ship as .velumtheme bundles, read by the same code as yours.

Where themes live

OS Folder
Windows %APPDATA%\CLEARLYlogic\Velum Studio\themes
macOS ~/Library/Application Support/com.legendremedia.velumstudio/themes
Linux ~/.config/velum-studio/themes

Drop a .json file in and it shows up in Appearance. A .velumtheme installs with a double-click.

One contract for everything

The tokens are the same contract extensions read. Every color, size and font an extension draws with comes from the active theme, never from literals, so a theme restyles every reviewed extension along with Studio itself. That's the whole point of the token-only rule.

In this section

to open · ↑ ↓ to move · Esc to close