aboutsummaryrefslogtreecommitdiffstats
path: root/AGENTS.md
diff options
context:
space:
mode:
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md16
1 files changed, 14 insertions, 2 deletions
diff --git a/AGENTS.md b/AGENTS.md
index b022a38..412fe41 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -39,8 +39,20 @@ Generated files are gitignored, because tracking them would turn every scheme
switch into a diff. Editing one is pointless: the next install overwrites it.
The generated set is `rofi/udt/palette.rasi`, `templates/dunstrc`,
`templates/conky.conf`, `templates/waybar/theme.css`,
-`templates/terminal/kitty-theme.conf`, `templates/homepage/custom.css` and
-`bin/udt_colors.py`.
+`templates/terminal/kitty-theme.conf`, `templates/homepage/custom.css`,
+`templates/kvantum/theme.{kvconfig,svg}` and `bin/udt_colors.py`.
+
+Qt and GTK apps reach the palette through Kvantum. Its theme is a `.kvconfig`
+of colours plus a `.svg` of widget artwork with the colours baked into the
+paths, so both are templates: the twelve palette colours are placeholders and
+the fifteen neutral greys are left alone, because those are shading rather than
+theme colour. It installs to `~/.config/Kvantum/udt/` under one fixed name for
+every scheme, so switching needs no change to `kvantum.kvconfig` and leaves no
+stale theme behind. Derived from `catppuccin-macchiato-lavender`, which this
+desktop was already running by hand.
+
+**Qt apps only read a theme at startup**, so a running one keeps the old
+colours until restarted. `install.sh` cannot signal them and does not try.
The homepage stylesheet is the one output that leaves this machine.
`install.sh` scp's it to `homepage:hp-stage/`, with a five second timeout and a