aboutsummaryrefslogtreecommitdiffstats
path: root/AGENTS.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-09-11 18:51:17 +0200
committerDanilo M. <danix@danix.xyz>2026-09-11 18:51:17 +0200
commitfd0a0e63d78138b485c2440781f6c210dd3df8a2 (patch)
tree710858fdb57e28fbddc926ddd65927f8aa592d83 /AGENTS.md
parentee39bd927e056c2dae9d61230a95a05715b3a8c6 (diff)
downloadunified-desktop-theme-fd0a0e63d78138b485c2440781f6c210dd3df8a2.tar.gz
unified-desktop-theme-fd0a0e63d78138b485c2440781f6c210dd3df8a2.zip
feat(palette): generate the Kvantum theme so Qt apps follow the scheme
Qt and GTK were the one part of the desktop the palette never reached: Kvantum was pinned to a hand-installed catppuccin-macchiato-lavender directory, so pcmanfm-qt and every other Qt app stayed Macchiato no matter which scheme was selected. A Kvantum theme is a .kvconfig of colours and a .svg of widget artwork with colours baked into the paths, which looked like it needed redrawing. It did not: the SVG carries only 27 distinct colours, 12 of them palette colours and the rest neutral greys that are shading, not theme colour. Both files are now templates with the 12 as placeholders, derived from the theme this desktop was already running. Installs to ~/.config/Kvantum/udt/ under one fixed name for every scheme, so a switch needs no change to kvantum.kvconfig and leaves no stale theme behind. Adds accent_dim and accent_bright roles for Kvantum's hover and pressed states. Verified: no placeholders survive generation, the SVG still parses as XML, and pcmanfm-qt picks up the new colours on restart. Qt reads a theme at startup only, so running apps need restarting; AGENTS.md says so. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015gbjA2bmswN8jyPDKzrvqe
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