Theme editor
The theme editor changes any color in Vela, with a live preview of the whole app as you go. Open it with Theme → Theme Editor…, Settings → Appearance → Customize…, or by right-clicking a theme in the gallery and choosing Customize in Theme Editor… to start from that theme.
Start from a theme
At the top of the editor:
- Theme name is the name that appears in your theme list.
- Type is Dark or Light. It decides the defaults for colors you don't set, and whether macOS draws menus and alerts light or dark.
- Start from loads another theme's colors as your starting point.
When you start from a built-in theme, the copy gets a new name ("Nord Custom"), so saving never overwrites the original.
Change colors
The left column groups Vela's color tokens by the part of the window they color: Window, Title bar, Sidebar, Rail, Tabs, Chat, Input, Member list, Embeds, Reactions, Controls, Status and Settings window. You can also show All tokens, only the ones Set in this theme, or the ones with Contrast issues, or search by name.
Each token shows:
- a color well and a hex field (
#RRGGBB, or#RRGGBBAAwith transparency); - what it colors and its default, which is often a formula over other tokens, such as
mix(window.background, #000000, 16%); - a contrast warning when text in that color would be hard to read on its background;
- a reset button that goes back to the default.
You only need to set a few colors. Leave a token alone and it's derived from the others: set window.background, window.foreground and accent, and the sidebar, member list, badges and links follow. See How defaults and fallbacks work.
Below the tokens are the nick colors (the palette nicknames are drawn from; add, remove or reset colors) and the mIRC colors 0–15 used by colored text from other IRC clients. Right-click a color to reset it.
Preview, save, export
Every Vela window shows your changes as you make them, including this one. Nothing is saved until you choose:
| Button | Does |
|---|---|
| Save (⌘S) | Saves the theme to your Themes folder and makes it your theme (for the current mode, if you match the system appearance). |
| Export… | Saves a copy as a .json file you can share or contribute. |
| Revert | Undoes every change since the theme was loaded or last saved. |
| Close (⌘W) | Closes the editor. If there are unsaved changes, Vela asks whether to save them. |
Closing without saving puts your previous theme back.
TIP
Overrides from appearance.colorCustomizations in settings.json don't apply inside the editor's preview, so you always see the theme exactly as it's written.
Saved themes are ordinary theme files, so you can keep refining them in a text editor. See Creating themes.