Skip to content

Themes

Customize Worktray's semantic color and interface tokens with a .theme file.

The theme editor opens .theme text files — Worktray’s own appearance, expressed as portable JSON. Unlike a .css file, a theme can actually restyle the app.

Interactive theme editorAdjust the palette, fonts, and radius on the Design tab and watch the live light/dark preview update. Applying to the workbench only works inside Worktray itself, so there's no Apply button here.
  • Edit exposes the theme as JSON and can Format valid content.
  • Design provides visual controls: start from a preset, adjust the palette (light, dark, neutral, accent, and danger colors), set fonts and corner radius, and see a live preview, with an advanced tokens section for fine-grained overrides.
  • Apply activates a valid theme; while it’s live the button reads Applied ✓ and clicking it reverts to the built-in theme. Apply is disabled until the JSON is valid.

Themes live in your user-scoped Settings space, separate from workspace files. Applying a theme that sits in an ordinary tray first copies it into Settings (the button says so), keeping your preferences distinct from tray data. Once a theme is applied, editing it restyles the app live so you can tune colors and see the result immediately.