Themes

Press T for a theme picker with a live preview, or set theme in configuration.

Built-in

github-dark, github-light, rose-pine, rose-pine-dawn, catppuccin-mocha, catppuccin-latte, tokyo-night, dracula, gruvbox-dark, solarized-dark, solarized-light, nord, one-dark, one-light, gruvbox-light, catppuccin-frappe, catppuccin-macchiato, tokyo-night-storm, tokyo-night-day, kanagawa, everforest-dark, ayu-mirage, nightfox.

theme = "auto" (the default) picks light or dark from the terminal background.

Your own themes

Put a file at ~/.config/gitty/themes/<name>.toml. A theme names a [palette] and overrides only what differs:

inherit = "github-dark"

[palette]
accent = "#ff79c6"

Palette keys

Key	Required
bg	yes
fg	yes
muted	yes
accent	yes
border	yes
red	yes
green	yes
yellow	yes
blue	yes
magenta	yes
cyan	yes
panel	no
orange	no

inherit = "<theme>" layers your file over another theme, so a personal theme is usually two or three lines.

The top bar’s pull request badge takes its colours from pr_open, pr_draft, pr_merged and pr_closed under [ui].

Colour depth

Colours are truecolor where the terminal supports it and the nearest xterm-256 colour entry elsewhere. Highlighting stores capture names rather than colours, so switching themes never re-highlights anything.