Theme tokens
Every color in Vela comes from one of these tokens. Use them in a theme file's colors, in appearance.colorCustomizations, or find them in the theme editor.
Defaults are written as expressions over other tokens:
| Expression | Meaning |
|---|---|
#RRGGBB | A fixed color. |
token.name | The value of another token. |
mix(a, b, 30%) | a blended 30% of the way toward b. |
transparent(a, 20%) | a with its opacity multiplied by 20%. |
contrast(a) | White, or a near-black tinted with a's hue, whichever reads better on a. |
So you only need to set the tokens you care about; the rest follow. See How defaults work.
Always current
This reference is generated from Vela's token registry (the same table as in THEMES.md) each time the site is built.
Window
Base colors most other tokens derive from.
| Token | Description | Dark default | Light default |
|---|---|---|---|
window.background | Base background of the window. Most surfaces derive from it. | #292D3E | #FAFAFA |
window.foreground | Base text color. Most text colors derive from it. | #BFC7D5 | #3E525C |
window.border | Outer window border and the edges of floating panels. | pane.divider | pane.divider |
pane.divider | Dividers between the sidebar, conversation and member list. | mix(window.background, #000000, 30%) | mix(window.background, window.foreground, 12%) |
Title bar
The toolbar area above the conversation.
| Token | Description | Dark default | Light default |
|---|---|---|---|
titleBar.background | Background of the title bar / toolbar above the conversation. | chat.background | chat.background |
titleBar.foreground | Channel name and toolbar icons. | chat.foreground | chat.foreground |
titleBar.secondaryForeground | Topic and other secondary title bar text. | mix(titleBar.foreground, titleBar.background, 40%) | mix(titleBar.foreground, titleBar.background, 33%) |
titleBar.border | Line under the title bar. | pane.divider | pane.divider |
Sidebar
The network and channel list.
| Token | Description | Dark default | Light default |
|---|---|---|---|
sidebar.background | Sidebar background. Usually a slight tint of window.background. | mix(window.background, #000000, 16%) | mix(window.background, window.foreground, 4.5%) |
sidebar.foreground | Names of channels and queries with no unread activity, and general sidebar text. | mix(window.foreground, sidebar.background, 20%) | mix(window.foreground, sidebar.background, 15%) |
sidebar.secondaryForeground | Secondary sidebar text: server names, counts, parted channels. | mix(sidebar.foreground, sidebar.background, 40%) | mix(sidebar.foreground, sidebar.background, 20%) |
sidebar.headerForeground | Section and network headers. | mix(sidebar.foreground, sidebar.background, 30%) | mix(sidebar.foreground, sidebar.background, 22%) |
sidebar.hoverBackground | Row under the pointer. | transparent(sidebar.foreground, 7.0%) | transparent(sidebar.foreground, 7.0%) |
sidebar.activeBackground | The selected channel or query. | mix(sidebar.background, accent, 22%) | mix(sidebar.background, accent, 18%) |
sidebar.activeForeground | Text of the selected channel or query. | sidebar.unreadForeground | sidebar.unreadForeground |
sidebar.unreadForeground | Names of channels and queries with unread messages. | window.foreground | window.foreground |
sidebar.highlightForeground | Names of channels and queries with unread mentions of you. | accentText | accentText |
sidebar.badgeBackground | Unread-count badge. | mix(sidebar.background, sidebar.foreground, 20%) | mix(sidebar.background, sidebar.foreground, 20%) |
sidebar.badgeForeground | Text of the unread-count badge. | sidebar.unreadForeground | sidebar.unreadForeground |
sidebar.highlightBadgeBackground | Badge counting unread mentions of you. | accent | accent |
sidebar.highlightBadgeForeground | Text of the mention badge. | accentForeground | accentForeground |
sidebar.disconnectedForeground | Networks and channels while disconnected. | mix(sidebar.foreground, sidebar.background, 50%) | mix(sidebar.foreground, sidebar.background, 50%) |
sidebar.border | Edge between the sidebar and the conversation. | pane.divider | pane.divider |
Rail
The collapsed, icon-only sidebar.
| Token | Description | Dark default | Light default |
|---|---|---|---|
rail.background | Background of the collapsed sidebar. | sidebar.background | sidebar.background |
rail.foreground | Icons and initials in the collapsed sidebar. | sidebar.foreground | sidebar.foreground |
rail.inactiveForeground | Icons of disconnected or idle networks in the collapsed sidebar. | sidebar.secondaryForeground | sidebar.secondaryForeground |
rail.activeBackground | Selected item in the collapsed sidebar. | sidebar.activeBackground | sidebar.activeBackground |
rail.activeIndicator | Indicator bar next to the selected item. | accent | accent |
rail.badgeBackground | Activity badge in the collapsed sidebar. | sidebar.highlightBadgeBackground | sidebar.highlightBadgeBackground |
rail.badgeForeground | Text of the activity badge. | sidebar.highlightBadgeForeground | sidebar.highlightBadgeForeground |
rail.border | Edge of the collapsed sidebar. | sidebar.border | sidebar.border |
Tabs
Vivaldi-style tab stacks used when navigation is set to tabs.
| Token | Description | Dark default | Light default |
|---|---|---|---|
tab.barBackground | Strip behind the tabs. | sidebar.background | sidebar.background |
tab.border | Strip border and the outline of an attached tab. | titleBar.border | titleBar.border |
tab.foreground | Text of read tabs. | sidebar.foreground | sidebar.foreground |
tab.unreadForeground | Text of tabs with unread messages. | sidebar.unreadForeground | sidebar.unreadForeground |
tab.highlightForeground | Text of tabs with mentions. | sidebar.highlightForeground | sidebar.highlightForeground |
tab.inactiveForeground | Muted, parted or offline tabs. | sidebar.disconnectedForeground | sidebar.disconnectedForeground |
tab.hoverBackground | Hovered tab. | sidebar.hoverBackground | sidebar.hoverBackground |
tab.activeBackground | Selected tab that opens into the conversation. | chat.background | chat.background |
tab.activeForeground | Text of the selected attached tab. | chat.foreground | chat.foreground |
tab.activeIndicator | Accent line on the selected tab. | accent | accent |
tab.pillBackground | Selected floating tab (title bar and pill shapes). | sidebar.activeBackground | sidebar.activeBackground |
tab.pillForeground | Text of a selected floating tab. | sidebar.activeForeground | sidebar.activeForeground |
tab.separator | Rule between tabs. | pane.divider | pane.divider |
tab.serverBackground | Background of the server (network) row. | rail.background | rail.background |
tab.serverActiveBackground | Selected network in the server row. | rail.activeBackground | rail.activeBackground |
tab.groupBackground | Segmented network group in the title bar. | transparent(sidebar.foreground, 7.0%) | transparent(sidebar.foreground, 7.0%) |
Chat
The conversation view.
| Token | Description | Dark default | Light default |
|---|---|---|---|
chat.background | Conversation background. | window.background | window.background |
chat.foreground | Message text. Keep at least 4.5:1 contrast with chat.background. | window.foreground | window.foreground |
chat.secondaryForeground | Secondary conversation text such as hostnames and metadata. | mix(chat.foreground, chat.background, 35%) | mix(chat.foreground, chat.background, 35%) |
chat.timestamp | Message timestamps. | mix(chat.foreground, chat.background, 45%) | mix(chat.foreground, chat.background, 45%) |
chat.link | Links in messages. | accentText | accentText |
chat.selfNick | Your own nickname on your messages. | accentText | accentText |
chat.selfMessageBackground | Background behind your own messages. | chat.background | chat.background |
chat.highlightBackground | Background of messages that mention you. | mix(chat.background, chat.highlightBorder, 12%) | mix(chat.background, chat.highlightBorder, 10%) |
chat.highlightBorder | Bar along the edge of messages that mention you. | chat.mention | chat.mention |
chat.mention | Your nickname where it's mentioned in message text. | accentText | accentText |
chat.notice | NOTICE messages. | mix(chat.foreground, status.warning, 55.0%) | mix(chat.foreground, status.warning, 55.0%) |
chat.action | /me action messages. | mix(chat.foreground, accentText, 35%) | mix(chat.foreground, accentText, 35%) |
chat.event | Membership and state events (joins, parts, modes…) unless a more specific token is set. | chat.secondaryForeground | chat.secondaryForeground |
chat.event.join | Join events. | mix(chat.event, status.success, 40%) | mix(chat.event, status.success, 40%) |
chat.event.part | Part events. | mix(chat.event, status.error, 35%) | mix(chat.event, status.error, 35%) |
chat.event.quit | Quit events. | chat.event.part | chat.event.part |
chat.event.nick | Nickname changes. | chat.event | chat.event |
chat.event.mode | Mode changes. | chat.event | chat.event |
chat.event.topic | Topic changes. | chat.event | chat.event |
chat.error | Errors shown in the conversation. | status.error | status.error |
chat.serverMessage | Server messages: MOTD, numerics, connection progress. | chat.secondaryForeground | chat.secondaryForeground |
chat.dayDivider | Line separating days. | mix(chat.background, chat.foreground, 12%) | mix(chat.background, chat.foreground, 12%) |
chat.dayDividerForeground | Date label on the day divider. | chat.secondaryForeground | chat.secondaryForeground |
chat.unreadMarker | Line and label marking the first unread message. | accent | accent |
chat.hoverBackground | Message under the pointer. Usually translucent. | transparent(chat.foreground, 4%) | transparent(chat.foreground, 4%) |
chat.selectionBackground | Selected text and selected messages. Usually translucent. | transparent(accent, 30%) | transparent(accent, 25%) |
chat.findMatchBackground | Matches when searching the conversation. Usually translucent. | transparent(status.warning, 35%) | transparent(status.warning, 35%) |
chat.codeBackground | Background of inline code and preformatted text. | mix(chat.background, chat.foreground, 7.0%) | mix(chat.background, chat.foreground, 5%) |
chat.codeForeground | Inline code and preformatted text. | chat.foreground | chat.foreground |
Input
The message composer.
| Token | Description | Dark default | Light default |
|---|---|---|---|
input.containerBackground | The bar around the message field. | chat.background | chat.background |
input.background | The message field. | mix(input.containerBackground, chat.foreground, 6%) | mix(input.containerBackground, #FFFFFF, 70%) |
input.foreground | Text typed in the message field. | chat.foreground | chat.foreground |
input.placeholder | Placeholder text in the empty message field. | mix(input.foreground, input.background, 50%) | mix(input.foreground, input.background, 42%) |
input.border | Border of the message field. | mix(input.background, input.foreground, 12%) | mix(input.background, input.foreground, 15%) |
input.focusBorder | Border of the message field while it has focus. | focusBorder | focusBorder |
input.iconForeground | Buttons and icons inside the composer. | mix(input.foreground, input.background, 35%) | mix(input.foreground, input.background, 35%) |
Member list
The channel member list.
| Token | Description | Dark default | Light default |
|---|---|---|---|
memberList.background | Member list background. | sidebar.background | sidebar.background |
memberList.foreground | Member nicknames (when nick colors are off). | sidebar.foreground | sidebar.foreground |
memberList.headerForeground | Group headers such as “Operators” and member counts. | sidebar.headerForeground | sidebar.headerForeground |
memberList.prefixForeground | Mode prefixes (~ & @ % +) before nicknames. | memberList.headerForeground | memberList.headerForeground |
memberList.awayForeground | Members who are away. | mix(memberList.foreground, memberList.background, 45%) | mix(memberList.foreground, memberList.background, 36%) |
memberList.hoverBackground | Row under the pointer. | sidebar.hoverBackground | sidebar.hoverBackground |
memberList.border | Edge between the member list and the conversation. | pane.divider | pane.divider |
Embeds
Link previews and inline media cards.
| Token | Description | Dark default | Light default |
|---|---|---|---|
embed.background | Link preview card background. | mix(chat.background, chat.foreground, 4%) | mix(chat.background, chat.foreground, 3%) |
embed.border | Link preview card border. | mix(chat.background, chat.foreground, 12%) | mix(chat.background, chat.foreground, 12%) |
embed.accent | Bar along the edge of a link preview. | accent | accent |
embed.title | Link preview title. | chat.link | chat.link |
embed.description | Link preview description. | mix(chat.foreground, embed.background, 15%) | mix(chat.foreground, embed.background, 15%) |
embed.siteName | Site name above the link preview title. | chat.secondaryForeground | chat.secondaryForeground |
embed.placeholderBackground | Placeholder shown while an image or video loads. | mix(embed.background, chat.foreground, 6%) | mix(embed.background, chat.foreground, 6%) |
Reactions, replies & typing
IRCv3 message reactions, reply quotes and typing indicators.
| Token | Description | Dark default | Light default |
|---|---|---|---|
reaction.background | Reaction pill. | mix(chat.background, chat.foreground, 6%) | mix(chat.background, chat.foreground, 6%) |
reaction.foreground | Reaction count. | chat.foreground | chat.foreground |
reaction.border | Reaction pill border. | mix(chat.background, chat.foreground, 12%) | mix(chat.background, chat.foreground, 12%) |
reaction.selfBackground | Reaction pill you've added. | mix(chat.background, accent, 18%) | mix(chat.background, accent, 14.0%) |
reaction.selfBorder | Border of a reaction pill you've added. | mix(chat.background, accent, 60%) | mix(chat.background, accent, 60%) |
reply.quoteBar | Bar beside the quoted message a reply refers to. | mix(chat.background, chat.foreground, 25%) | mix(chat.background, chat.foreground, 25%) |
reply.foreground | Quoted message text in a reply. | chat.secondaryForeground | chat.secondaryForeground |
reply.background | Background of the quoted message in a reply. | transparent(chat.background, 0%) | transparent(chat.background, 0%) |
typing.foreground | “… is typing” indicator. | chat.secondaryForeground | chat.secondaryForeground |
Controls
Accent, buttons, scrollbars and popovers.
| Token | Description | Dark default | Light default |
|---|---|---|---|
accent | The theme's accent: selection, badges, buttons, focus rings. | #C792EA | #39ADB5 |
accentText | The accent when used as text or thin lines on chat.background (links, your nick, mentions). Set it when accent is too light or dark to read. | accent | mix(accent, #000000, 36%) |
accentForeground | Text and icons drawn on accent-colored fills. | contrast(accent) | contrast(accent) |
focusBorder | Focus ring of focused controls. | accent | accent |
button.background | Primary button. | accent | accent |
button.foreground | Primary button text. | accentForeground | accentForeground |
button.hoverBackground | Primary button under the pointer. | mix(button.background, #FFFFFF, 12%) | mix(button.background, #000000, 10%) |
button.secondaryBackground | Secondary button. | mix(window.background, window.foreground, 12%) | mix(window.background, window.foreground, 8%) |
button.secondaryForeground | Secondary button text. | window.foreground | window.foreground |
scrollbar.thumb | Scrollbar thumb. | transparent(window.foreground, 20%) | transparent(window.foreground, 20%) |
scrollbar.thumbHover | Scrollbar thumb under the pointer. | transparent(window.foreground, 35%) | transparent(window.foreground, 35%) |
popover.background | Popovers, autocomplete lists and tooltips drawn by Vela. | mix(window.background, #FFFFFF, 5%) | mix(window.background, #FFFFFF, 80%) |
popover.foreground | Text in popovers. | window.foreground | window.foreground |
popover.border | Popover border. | mix(popover.background, popover.foreground, 12%) | mix(popover.background, popover.foreground, 12%) |
Status
Semantic colors for connection state and feedback.
| Token | Description | Dark default | Light default |
|---|---|---|---|
status.success | Connected state and success messages. | #C3E88D | #3D7D1E |
status.warning | Connecting/away state and warnings. | #FFCB6B | #A86400 |
status.error | Disconnected state and errors. | #FF6B81 | #D32F2F |
Settings window
The Settings window.
| Token | Description | Dark default | Light default |
|---|---|---|---|
settings.background | Settings window content background. | window.background | window.background |
settings.sidebarBackground | Settings window sidebar. | sidebar.background | sidebar.background |
settings.foreground | Settings labels and text. | window.foreground | window.foreground |
settings.secondaryForeground | Settings help text and captions. | mix(settings.foreground, settings.background, 40%) | mix(settings.foreground, settings.background, 33%) |
settings.border | Settings section separators. | pane.divider | pane.divider |
settings.controlBackground | Text fields and grouped rows in Settings. | input.background | input.background |
Nick colors
nickColors is an array of colors. Each nickname is hashed (case-insensitively, RFC 1459 case mapping) to one entry, so a nick keeps its color across launches.
- Dark default:
#F07178#F78C6C#FFCB6B#C3E88D#7FDBCA#89DDFF#82AAFF#B4A5FF#C792EA#FF9CAC#E6B07E#A8D8A0 - Light default:
#C62828#BF4A12#8C6200#4E7A12#1B7D4F#00727C#1565C0#3949AB#6A3FB5#9C27B0#AD1457#7D5A3C
IRC colors
ircColors maps mIRC color indexes to colors. 0–15 default to mIRC's classic values; 16–98 to the standard extended palette.
| Index | Name | Default |
|---|---|---|
| 0 | White | #FFFFFF |
| 1 | Black | #000000 |
| 2 | Blue | #00007F |
| 3 | Green | #009300 |
| 4 | Red | #FF0000 |
| 5 | Brown | #7F0000 |
| 6 | Magenta | #9C009C |
| 7 | Orange | #FC7F00 |
| 8 | Yellow | #FFFF00 |
| 9 | Light Green | #00FC00 |
| 10 | Cyan | #009393 |
| 11 | Light Cyan | #00FFFF |
| 12 | Light Blue | #0000FC |
| 13 | Pink | #FF00FF |
| 14 | Grey | #7F7F7F |
| 15 | Light Grey | #D2D2D2 |
| 16–98 | Extended palette | see modern.ircdocs.horse |