Skip to main content
LazyWorktree includes 21 built-in themes and supports custom themes with inheritance.

​
Theme Selection

Set the theme in your configuration file: 
theme: dracula
Or via command-line flag: 
lazyworktree --theme nord
Leave the theme setting empty to enable auto-detection based on your terminal background colour: 
theme: ""  # Auto-detect (rose-pine for dark, dracula-light for light)

​
Built-in Themes

LazyWorktree includes 21 carefully crafted themes:
ThemeBackgroundBest For
draculaDark (#282A36)Dark terminals, vibrant colours, default fallback
dracula-lightWhite (#FFFFFF)Light terminals, Dracula colours, default light theme
narnaCharcoal (#0D1117)Dark terminals, blue highlights
clean-lightWhite (#FFFFFF)Light terminals, cyan accent
catppuccin-latteSoft white (#EFF1F5)Catppuccin Latte light palette
rose-pine-dawnWarm white (#FAF4ED)Rosé Pine Dawn warm palette
one-lightLight grey (#FAFAFA)Atom One Light
everforest-lightBeige (#F3EFDA)Everforest nature light
solarized-darkDeep teal (#002B36)Classic Solarized dark palette
solarized-lightCream (#FDF6E3)Classic Solarized light palette
gruvbox-darkDark grey (#282828)Gruvbox dark, warm accents
gruvbox-lightSand (#FBF1C7)Gruvbox light, earthy tones
nordMidnight blue (#2E3440)Nord calm cyan accents
monokaiOlive black (#272822)Monokai bright neon accents
catppuccin-mochaMocha (#1E1E2E)Catppuccin Mocha pastels
modernZinc (#18181B)Sleek modern dark theme with violet accents
tokyo-nightStorm (#24283B)Tokyo Night Storm with blue highlights
one-darkDark (#282C34)Atom One Dark classic palette
rose-pineMidnight (#191724)Rosé Pine dark and moody
ayu-mirageMirage (#212733)Ayu Mirage modern look
everforest-darkDark (#2D353B)Everforest nature dark
kanagawaWave (#1F1F28)Kanagawa Wave inspired by Japanese art

​
Custom Themes

Define custom themes that inherit from built-in themes or create entirely new colour schemes.

​
Inherit from Built-in Theme

Override specific colours whilst inheriting the rest: 
custom_themes:
  my-dark:
    base: dracula
    accent: "#FF6B9D"
    text_fg: "#E8E8E8"

  my-light:
    base: dracula-light
    accent: "#0066CC"

​
Complete Custom Theme

Define all 11 colour fields for a completely custom theme: 
custom_themes:
  completely-custom:
    accent: "#00FF00"
    accent_fg: "#000000"
    accent_dim: "#2A2A2A"
    border: "#3A3A3A"
    border_dim: "#2A2A2A"
    muted_fg: "#888888"
    text_fg: "#FFFFFF"
    success_fg: "#00FF00"
    warn_fg: "#FFFF00"
    error_fg: "#FF0000"
    cyan: "#00FFFF"

​
Inherit from Custom Theme

Custom themes can inherit from other custom themes: 
custom_themes:
  base-custom:
    base: dracula
    accent: "#FF0000"
  derived:
    base: base-custom
    accent: "#00FF00"

​
Colour Fields

All custom theme colour fields (use snake_case in YAML):
FieldDescription
accentPrimary accent colour (highlights, selected items)
accent_fgForeground colour for text on accent background
accent_dimDimmed accent colour (selected rows/panels)
borderBorder colour
border_dimDimmed border colour
muted_fgMuted text colour (less important text)
text_fgPrimary text colour
success_fgSuccess/positive indicator colour
warn_fgWarning indicator colour
error_fgError indicator colour
cyanCyan accent colour

​
Colour Format

Colour values must be in hex format: #RRGGBB or #RGB

​
Inheritance Rules

  • When using a base theme, only specify colours you want to override
  • When not using a base, all 11 colour fields are required
  • Custom themes appear alongside built-in themes
  • Cannot override built-in theme names

​
Syntax Themes

When using delta as your git_pager, LazyWorktree automatically selects an appropriate syntax theme to match your UI theme. To view available delta syntax themes: 
lazyworktree --show-syntax-themes
You can override the syntax theme manually: 
git_pager: delta
git_pager_args:
  - --syntax-theme
  - "OneHalfDark"

Build docs developers (and LLMs) love

Get started for freeTalk to us