Theme Token Reference

Quick reference for all SilkCircuit theme tokens.

What Are Theme Tokens?

Theme tokens are semantic color names that adapt to different theme variants. Instead of hardcoding colors, Git-Iris uses tokens like accent.primary that map to colors in the active theme.

Available Themes

Git-Iris ships 39 builtin themes through opaline, the underlying theme engine. Run git-iris themes for the full list with descriptions. Themes are grouped by family:

Family	Variants	Notes
SilkCircuit	silkcircuit-neon (default), silkcircuit-soft, silkcircuit-vibrant, silkcircuit-glow, silkcircuit-dawn (light)	Native Git-Iris design language
Dracula	dracula
Nord	nord
Tokyo Night	tokyo-night, tokyo-night-moon, tokyo-night-storm
Catppuccin	catppuccin-mocha, catppuccin-macchiato, catppuccin-frappe, catppuccin-latte (light)
Gruvbox	gruvbox-dark, gruvbox-light
Ayu	ayu-dark, ayu-mirage, ayu-light
Rosé Pine	rose-pine, rose-pine-moon, rose-pine-dawn (light)
Kanagawa	kanagawa-wave, kanagawa-dragon, kanagawa-lotus (light)
Everforest	everforest-dark, everforest-light
Flexoki	flexoki-dark, flexoki-light
GitHub	github-dark-dimmed, github-light
Solarized	solarized-dark, solarized-light
Night/Light Owl	night-owl, light-owl
Other classics	monokai-pro, one-dark, one-light, palenight

Using Themes

There is no git-iris config --theme flag. Set the theme in your config file, or pass the global --theme flag on any invocation.

# List every available theme
git-iris themes

# Override for a single invocation (works on any subcommand)
git-iris studio --theme silkcircuit-glow
git-iris gen --theme silkcircuit-dawn --print

# Make it your default by editing ~/.config/git-iris/config.toml:
#
#   theme = "silkcircuit-glow"

Token Categories

Text Tokens

Token	Purpose	Default (Neon)
text.primary	Primary text	#f8f8f2
text.secondary	Secondary text	#bcbcca
text.muted	De-emphasized text	#82879f
text.dim	Very subtle text	#6e7daf

Background Tokens

Token	Purpose	Default (Neon)
bg.base	Main background	#121218
bg.panel	Panel background	#181820
bg.code	Code block background	#1e1e28
bg.highlight	Highlighted areas	#37324b
bg.elevated	Raised surfaces	#37324b
bg.active	Active/focused state	#3c2d55
bg.selection	Selected items	#3c3c50

Accent Tokens

Token	Purpose	Default (Neon)
accent.primary	Primary brand color	#e135ff (Electric Purple)
accent.secondary	Secondary brand color	#80ffea (Neon Cyan)
accent.tertiary	Tertiary brand color	#ff6ac1 (Coral)
accent.deep	Deep accent	#bd93f9 (Purple 400)

Semantic Tokens

Token	Purpose	Default (Neon)
success	Success states	#50fa7b (Green)
error	Error states	#ff6363 (Red)
warning	Warning states	#f1fa8c (Yellow)
info	Information	#80ffea (Cyan)

Git Status Tokens

Token	Purpose	Default (Neon)
git.staged	Staged files	#50fa7b (Green)
git.modified	Modified files	#f1fa8c (Yellow)
git.untracked	Untracked files	#6e7daf (Gray)
git.deleted	Deleted files	#ff6363 (Red)

Diff Tokens

Token	Purpose	Default (Neon)
diff.added	Added lines	#50fa7b (Green)
diff.removed	Removed lines	#ff6363 (Red)
diff.hunk	Hunk headers	#80ffea (Cyan)
diff.context	Context lines	#6e7daf (Gray)

Border Tokens

Token	Purpose	Default (Neon)
border.focused	Focused panel border	#80ffea (Cyan)
border.unfocused	Unfocused panel border	#82879f (Gray)

Code Highlighting Tokens

Token	Purpose	Default (Neon)
code.hash	Commit hashes	#ff6ac1 (Coral)
code.path	File paths	#80ffea (Cyan)
code.keyword	Keywords	#e135ff (Purple)
code.function	Function names	#80ffea (Cyan)
code.string	String literals	#ff99ff (Pink)
code.number	Numbers	#ff6ac1 (Coral)
code.comment	Comments	#6e7daf (Gray)
code.type	Type names	#f1fa8c (Yellow)
code.line_number	Line numbers	#6e7daf (Gray)

Mode Tokens

Token	Purpose	Default (Neon)
mode.active	Active mode tab	#e135ff (Purple)
mode.inactive	Inactive mode tabs	#6e7daf (Gray)
mode.hover	Hovered mode tab	#80ffea (Cyan)

Style Tokens

Styles combine colors with modifiers (bold, italic, etc.).

Common Styles

Style	Description
keyword	Keywords (bold, primary accent)
file_path	File paths (secondary accent)
file_path_bold	File paths (bold)
commit_hash	Commit hashes (coral)
line_number	Line numbers (dim)
cursor_line	Current line highlight
selected	Selected item
active_selected	Active selected item (bold)
focused_border	Focused panel border
unfocused_border	Unfocused panel border
success_style	Success messages
error_style	Error messages
warning_style	Warning messages
info_style	Info messages
dimmed	Dimmed text
muted	Muted text
inline_code	Inline code blocks
mode_active	Active mode tab (bold)
mode_inactive	Inactive mode tab
mode_hover	Hovered mode tab
git_staged	Staged file
git_modified	Modified file
git_untracked	Untracked file
git_deleted	Deleted file
diff_added	Added diff lines
diff_removed	Removed diff lines
diff_hunk	Diff hunk headers
diff_context	Diff context lines
author	Author names
timestamp	Timestamps

Gradient Tokens

Gradients interpolate between colors. Access with gradient(name, t) where t is 0.0-1.0.

Gradient	Colors	Purpose
primary	Purple → Cyan	Brand gradient
warm	Coral → Yellow	Warm accents
success_gradient	Green → Cyan	Success transitions
error_gradient	Red → Coral	Error transitions
aurora	Purple → Pink → Cyan	5-stop aurora effect

Color Values by Theme

SilkCircuit Neon (Default)

Token	Hex	RGB
accent.primary	#e135ff	225, 53, 255
accent.secondary	#80ffea	128, 255, 234
accent.tertiary	#ff6ac1	255, 106, 193
success	#50fa7b	80, 250, 123
error	#ff6363	255, 99, 99
warning	#f1fa8c	241, 250, 140
text.primary	#f8f8f2	248, 248, 242
bg.base	#121218	18, 18, 24

SilkCircuit Soft

Muted variant with lower saturation for extended use.

SilkCircuit Glow

Enhanced brightness with glowing accent colors.

SilkCircuit Vibrant

Maximum saturation for high-contrast displays.

SilkCircuit Dawn (Light)

Light variant with warm pastel tones.

Creating Custom Themes

Theme File Structure

[meta]
name = "My Theme"
author = "Your Name"
variant = "dark"  # or "light"

[palette]
purple_500 = "#e135ff"
cyan_400 = "#80ffea"

[tokens]
"text.primary" = "#f8f8f2"
"accent.primary" = "purple_500"  # Reference palette

[styles]
keyword = { fg = "accent.primary", bold = true }

[gradients]
primary = ["purple_500", "cyan_400"]

Theme Location

Place custom themes in:

~/.config/git-iris/themes/mytheme.toml

Then load with the global --theme flag, or set it as your default in ~/.config/git-iris/config.toml:

# One-off
git-iris studio --theme mytheme

# Persistent default — add to ~/.config/git-iris/config.toml
#
#   theme = "mytheme"

Terminal Requirements

True Color Support

Git-Iris uses 24-bit true color (RGB). Ensure your terminal supports it:

# Test true color support
printf "\x1b[38;2;255;100;0mTRUECOLOR\x1b[0m\n"

If you see "TRUECOLOR" in orange, your terminal supports it.

Recommended Terminals

Terminal	Support
iTerm2	Full
Alacritty	Full
WezTerm	Full
Kitty	Full
Terminal.app	Full (macOS 10.15+)
Windows Terminal	Full
tmux	Full (with tmux-256color)

Tmux Configuration

Add to ~/.tmux.conf:

set -g default-terminal "tmux-256color"
set -ga terminal-overrides ",*256col*:Tc"

Token Usage Examples

In Custom Themes

[tokens]
"accent.primary" = "#e135ff"
"accent.secondary" = "#80ffea"

[styles]
# Use tokens in styles
my_style = { fg = "accent.primary", bg = "bg.panel", bold = true }

Programmatic Access

Themes are accessed internally via the theme API:

use git_iris::theme;

let theme = theme::current();
let color = theme.color("accent.primary");
let style = theme.style("keyword");

Quick Reference Tables

Essential Tokens

Use Case	Token
Headings	accent.primary
Links	accent.secondary
Success	success
Errors	error
Warnings	warning
Added code	diff.added
Removed code	diff.removed
File paths	code.path
Commit hashes	code.hash

Panel-Specific

Panel	Focused Border	Background
Any	border.focused	bg.panel
Any (unfocused)	border.unfocused	bg.panel
Code view	border.focused	bg.code
Highlighted line	-	bg.highlight