docs(config): document terminal palette theming

commit: 7995fb397cfc8758f1acc738515d5e2a202c423d
author: brice · 3mo ago · 2026-07-17 09:07 UTC
parent: ce901de
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

1 file · +7 -1

M docs/configuration.md +7 -1


@@ -3,8 +3,10 @@
3	3		vev reads `~/.config/vev/config` (`$XDG_CONFIG_HOME` respected). No file means defaults. The daemon picks up changes within a couple of seconds; no restart needed.
4	4
5	5		```text
6		-	# Theme: auto follows the client; dark/light force built-in palettes.
	6	+	# Theme: auto follows the client; dark/light use neutral built-in defaults.
7	7		theme = auto
	8	+	# In auto mode, inherit the terminal's ANSI blue for chrome accents.
	9	+	theme.palette = on
8	10
9	11		# Palette placement: auto, center, top-left, top, top-right, left, right,
10	12		# bottom-left, bottom, or bottom-right.

@@ -66,6 +68,10 @@ code.detach = DET
66	68
67	69		Invalid values log a warning and keep the last valid value.
68	70
	71	+	## Theme
	72	+
	73	+	With `theme = auto`, vev follows the terminal's foreground, background, light/dark scheme, and ANSI palette as the terminal reports changes. `theme.palette = on` is the default and uses the terminal's blue for chrome accents when available; vev falls back to neutral foreground/background blends when the color is unavailable or lacks contrast. Set it to `off` for blend-only styling. Forced `theme = dark` or `theme = light` modes are always blend-only.
	74	+
69	75		## Bindings
70	76
71	77		Key specs: `alt+<char>`, `alt+space`, `alt+left/right/up/down`, `alt+1` through `alt+9`. Configuring an action replaces all of its built-in aliases (set `focus-pane-left` and the Alt+Arrow alias is gone). Tab switching also accepts the top-row symbols of non-QWERTY layouts, so AZERTY works without extra config.

 vev reads `~/.config/vev/config` (`$XDG_CONFIG_HOME` respected). No file means defaults. The daemon picks up changes within a couple of seconds; no restart needed.
 ```text
-# Theme: auto follows the client; dark/light force built-in palettes.
+# Theme: auto follows the client; dark/light use neutral built-in defaults.
 theme = auto
+# In auto mode, inherit the terminal's ANSI blue for chrome accents.
+theme.palette = on
 # Palette placement: auto, center, top-left, top, top-right, left, right,
 # bottom-left, bottom, or bottom-right.
 Invalid values log a warning and keep the last valid value.
+## Theme
+With `theme = auto`, vev follows the terminal's foreground, background, light/dark scheme, and ANSI palette as the terminal reports changes. `theme.palette = on` is the default and uses the terminal's blue for chrome accents when available; vev falls back to neutral foreground/background blends when the color is unavailable or lacks contrast. Set it to `off` for blend-only styling. Forced `theme = dark` or `theme = light` modes are always blend-only.
 ## Bindings
 Key specs: `alt+<char>`, `alt+space`, `alt+left/right/up/down`, `alt+1` through `alt+9`. Configuring an action replaces all of its built-in aliases (set `focus-pane-left` and the Alt+Arrow alias is gone). Tab switching also accepts the top-row symbols of non-QWERTY layouts, so AZERTY works without extra config.