// Diagnose and fix visual/theming issues in Blue95 (XFCE, Chicago95 GTK theme, icon themes, xfconf defaults) and wire fixes into the build pipeline
| name | theme-troubleshooting |
| description | Diagnose and fix visual/theming issues in Blue95 (XFCE, Chicago95 GTK theme, icon themes, xfconf defaults) and wire fixes into the build pipeline |
Guide the full workflow for diagnosing visual or styling bugs in Blue95, applying fixes, wiring them into the build pipeline and drafting upstream PRs.
CHICAGO95_SHA) in files/scripts/20-chicago95.sh..diff files in files/scripts/ and are applied in
20-chicago95.sh with patch -p1. Reference: 20-chicago95-xfwm4.diff (xfwm4 theme),
20-chicago95-notifyd.diff (xfce4-notifyd CSS icon fix).files/system/etc/skel/.config/xfce4/xfconf/xfce-perchannel-xml/<channel>.xmlfiles/system/usr/share/xfconf-profile/default.json
(applied by run_after_01-xfconf-profile.sh via chezmoi on every login)files/system/ map verbatim onto / in the image.files/system/usr/share/winblues/chezmoi/ and are applied
per-user on first login (gate: ~/.local/state/winblues/chezmoi-blue95)./usr over /etc for system-wide changes; use chezmoi only for true $HOME-only
settings.Identify the GTK widget and CSS node.
Identify the icon lookup path (if icon-related).
/usr/share/themes/Chicago95/ and /usr/share/icons/Chicago95/`.Identify the xfconf key (if a runtime value issue).
xfconf-query -c <channel> -lv lists all keys.~/Projects/winblues/xfce-mirror/<daemon>/
to find the compiled-in default that xfconf will fall back to if the key is absent.
If the relevant project is not there, clone it (e.g., from https://github.com/xfce-mirror/xfce4-panel.git)Live-test the fix.
/usr/share/themes/Chicago95/ to
~/.themes/Chicago95/ (same relative path), edit there, then restart the relevant
daemon (e.g. pkill xfce4-notifyd).xfconf-query -c <channel> -p <key> -s <value> --create -t <type>.~/Projects/winblues/Chicago95/ (the pinned upstream clone).cd ~/Projects/winblues/Chicago95
git diff > ~/Projects/winblues/blue95/files/scripts/20-chicago95-<name>.diff
apply_patch call in files/scripts/20-chicago95.sh (follow the existing
pattern for 20-chicago95-xfwm4.diff / 20-chicago95-notifyd.diff).patch --dry-run -p1.files/system/etc/skel/.config/xfce4/xfconf/xfce-perchannel-xml/<channel>.xml
(new users).files/system/usr/share/xfconf-profile/default.json (existing users).
Format: "<channel>/<key>": "<value>".files/system/usr/share/icons/Chicago95/ at the
correct category/size path..diff file instead.After confirming the fix works locally:
~/Projects/winblues/Chicago95 on a branch.grassmunk/Chicago95 with:
xfce-notify: force regular icon rendering to prevent symbolic monochrome| File | Purpose |
|---|---|
files/scripts/20-chicago95.sh | Builds/patches Chicago95; set CHICAGO95_SHA here |
files/scripts/20-chicago95-*.diff | Patch files applied against the Chicago95 clone |
files/system/etc/skel/.config/xfce4/xfconf/xfce-perchannel-xml/ | xfconf XML defaults for new users |
files/system/usr/share/xfconf-profile/default.json | xfconf-profile defaults for existing users |
files/system/usr/share/winblues/chezmoi/ | Per-user dotfiles (chezmoi, first-login only) |
~/.themes/Chicago95/ | Live user override for testing before committing |
vendor/Chicago95/ | Pinned Chicago95 clone edit here, then diff. May not exist. |
vendor/xfce-mirror/ | XFCE source. May need to clone correct components. |
org.mozilla.firefox) — Chicago95 maps
legacy names (firefox → Netscape globe). Using modern names breaks theming.-symbolic icons are always monochrome in GTK3 unless you force
-gtk-icon-style: regular in CSS or provide a non-symbolic fallback.default.json fall back to daemon compiled-in defaults, which
may differ from what you expect — always check the source.