Skip to content

Theming

strix ships several themes and lets you add your own. A theme controls both the UI chrome (borders, selection, status colours) and the diff colours, and selects a syntax-highlighting theme for code.

Choosing a theme

In ~/.config/strix/config.toml:

theme = "tokyo-night"

Or per-invocation:

strix --theme gruvbox

Built-in themes

Name Description
tokyo-night Dark, blue-accented (the default)
dark Neutral dark
light Neutral light
catppuccin Catppuccin Mocha
gruvbox Gruvbox dark

Custom themes

Drop a .toml file in ~/.config/strix/themes/ and reference it by file stem (my-theme.tomltheme = "my-theme"). Colours are hex strings:

base = "tokyo-night"            # preset to start from (default: tokyo-night)
syntax = "base16-ocean.dark"    # bundled syntect theme for code highlighting

[colors]
bg = "#1a1b26"
fg = "#a9b1d6"
dim = "#565f89"
border = "#292e42"
border_focused = "#7aa2f7"
staged = "#9ece6a"
unstaged = "#e0af68"
untracked = "#7dcfff"
selection_bg = "#283457"
add = "#9ece6a"
add_bg = "#202c26"
del = "#f7768e"
del_bg = "#312027"
hunk = "#7dcfff"

Any colour you omit falls back to the base preset's value, so a partial theme is fine.

Note

Themes use 24-bit colour. On a terminal without truecolor the palette degrades to the nearest 256-colour approximation.