Themes

jolt supports extensive theming with 300+ importable themes from iTerm2 Color Schemes, plus the ability to create your own.

Appearance Modes

jolt supports three appearance modes:

Mode	Description
Auto	Follow system appearance
Dark	Always use dark theme variant
Light	Always use light theme variant

Toggle with t key or set in config:

appearance = "auto"  # or "dark" or "light"

Built-in Themes

jolt includes several built-in themes:

default — Clean, minimal theme
dracula — Popular dark purple theme
nord — Arctic, bluish theme
gruvbox — Retro, warm theme
tokyo-night — Modern dark theme
catppuccin — Pastel dark theme

Switching Themes

Quick Switch

Press t to cycle through appearance modes (Auto → Dark → Light).

Theme Picker

Press T (shift+t) to open the theme picker:

Browse themes with ↑/↓
Preview in real-time
Press Enter to apply
Press / to search

Via Config

theme = "dracula"

Via Command Line

jolt --theme nord

Importing iTerm2 Themes

jolt can import themes from the iTerm2 Color Schemes collection.

From Theme Picker

Press T to open theme picker
Press i to open import dialog
Search for a theme name
Select and import

Via CLI

# List available iTerm2 themes
jolt theme list --iterm2

# Search for themes
jolt theme list --search dracula

# Import a theme
jolt theme import "Dracula"

Imported themes are saved to your themes directory:

macOS: ~/Library/Application Support/jolt/themes/
Linux: ~/.config/jolt/themes/

Theme Structure

Themes are TOML files with color definitions:

[dark]
background = "#282a36"
foreground = "#f8f8f2"
border = "#44475a"
accent = "#bd93f9"

# Battery gauge colors
battery_high = "#50fa7b"
battery_medium = "#f1fa8c"
battery_low = "#ff5555"

# Energy impact colors
impact_low = "#50fa7b"
impact_moderate = "#f1fa8c"
impact_elevated = "#ffb86c"
impact_high = "#ff5555"

[light]
# Light mode colors...

Color Tokens

Token	Usage
`background`	Main background
`foreground`	Default text
`border`	Panel borders
`accent`	Highlights, selection
`muted`	Secondary text
`battery_high`	Battery > 50%
`battery_medium`	Battery 20-50%
`battery_low`	Battery < 20%
`impact_low`	Low energy impact
`impact_moderate`	Moderate impact
`impact_elevated`	Elevated impact
`impact_high`	High impact

Creating Custom Themes

See Custom Themes for a complete guide on creating your own themes.

Theme Validation

jolt validates themes for contrast and accessibility:

# Check all themes for issues
jolt theme check

# Check specific theme
jolt theme check --theme my-theme

Warnings are shown for:

Insufficient contrast ratios
Missing required colors
Invalid color values