docs(desktop): document Umbriel compositor configuration

docs/chezmoi/data.mdx

@@ -41,6 +41,7 @@ One manifest per platform, plus a `shared` block. Any edit to the file changes t
 | pacman | `niri`, `noctalia`, `xwayland-satellite`, `polkit-gnome`, `uwsm`, `xdg-user-dirs`; Wayland utilities `wl-clipboard`, `cliphist`, `wtype`, `ydotool`, `grim`, `slurp`, `hyprpicker`, `pamixer`, `brightnessctl`, `libnotify`; apps `nautilus`, `imv`, `mpv`, `evince`, `chromium`, `obsidian`; strata runtime deps `bubblewrap`, `desktop-file-utils`, `fontconfig`, `gstreamer`, `gst-libav`, `gst-plugins-base`, `gst-plugins-good`, `gtk4`, `gtksourceview5`, `gvfs`, `poppler-glib`, `xdg-utils` |
 | AUR (or a sync repo with the same name) | `vicinae-bin`, `tldraw-offline-bin`; desktop apps `beeper-bin`, `fastmail`, `1password`, `brave-origin-bin`, `claude-desktop`, `spotify` |
 | `[omarchy]` repo (`packages.arch.desktop.omarchy`, only when `pacman-conf -l` lists that repo) | `herdr`, `flea`, `voxtype-bin`, `xdg-terminal-exec`, `hyprland-preview-share-picker` |
+| `[cachyos]` repo (`packages.arch.desktop.cachyos`, only when `pacman-conf -l` lists that repo) | `umbriel` (the AUR `umbriel` is a placeholder and `umbriel-git` conflicts with the repo build) |
 
 Hyprland, Waybar and the `omarchy-*` commands come with the Omarchy install and are not declared. `niri-dynamic-workspaces` (niri startup) has no package; install it by hand. strata (the folder handler) has no package either; [15-tools](/chezmoi/scripts#15-tools) runs its installer.
 

docs/chezmoi/externals-and-ignore.mdx

@@ -130,8 +130,14 @@ mise tool versions stay local to each machine and are not managed.
 .config/niri/**
 .config/hypr
 .config/hypr/**
+.config/umbriel
+.config/umbriel/**
+.config/uwsm
+.config/uwsm/**
 .config/noctalia
 .config/noctalia/**
+.config/vicinae
+.config/vicinae/**
 .config/niri-dynamic-workspaces
 .config/niri-dynamic-workspaces/**
 .config/fontconfig
@@ -141,6 +147,7 @@ mise tool versions stay local to each machine and are not managed.
 .config/systemd/**
 .local/bin/kitty-day-save
 .local/bin/niri-launch
+.local/bin/umbriel-launch
 .config/fish/auto-Niri.fish
 .local/bin/cp-appid
 .local/bin/projects-sync
@@ -157,6 +164,14 @@ The block is emitted, and these paths skipped, unless the OS is `linux` and the
 
 See [Desktop](/desktop/niri) for what the layer contains. Gaps in the gate: the block lists `niri-launch` but not its siblings (`niri-launch-ai`, `niri-launch-browser`, `niri-launch-terminal`, `niri-launch-webapp`), and the waybar config (`dot_config/waybar/`) is not gated at all, so it applies on every role. `dot_config/niri/scripts/` is covered by `.config/niri/**`.
 
+### Generated theme files
+
+```txt
+.config/umbriel/noctalia.toml
+```
+
+Noctalia's umbriel template rewrites this file on every theme change, so it stays out of the repo on every machine. `config.toml` includes it as an optional file; see [Umbriel](/desktop/umbriel#theme).
+
 ### Secrets in runtime state
 
 ```txt

docs/chezmoi/scripts.mdx

@@ -49,7 +49,7 @@ Seven scripts run during `chezmoi apply`. Five live in `.chezmoiscripts/`, a dir
 
 1. Uses `pacman` directly when running as root, otherwise `sudo pacman`.
 2. `pacman -T` filters each list down to names no installed package provides (so `mise-bin` satisfies `mise`, `yazi-git` satisfies `yazi`), then `pacman -S --needed --noconfirm` installs the rest of `packages.arch.pacman`.
-3. For roles `desktop` and `laptop`, the same for `packages.arch.desktop.pacman`, and, when `pacman-conf -l` lists an `omarchy` repo, for `packages.arch.desktop.omarchy`.
+3. For roles `desktop` and `laptop`, the same for `packages.arch.desktop.pacman`, and for `packages.arch.desktop.omarchy` / `packages.arch.desktop.cachyos` when `pacman-conf -l` lists an `omarchy` / `cachyos` repo.
 4. Builds the AUR list: `packages.arch.desktop.aur` plus `packages.arch.aur` for `desktop`/`laptop`, only `packages.arch.aur` for other roles, then drops every name `pacman -T` says is already provided. Desktop apps already installed from a sync repo (CachyOS, `[omarchy]`) are therefore neither rebuilt nor replaced.
 5. If anything is left and neither `yay` nor `paru` is installed, bootstraps `yay`: from a sync repo when `pacman -Si yay` finds one (CachyOS, chaotic-aur), otherwise by building `yay-bin` from the AUR with `makepkg -si` (installs `git` and `base-devel` first; skipped as root, since makepkg refuses root).
 6. Runs `yay -S --needed --noconfirm` on the remaining names, falling back to `paru`. yay prefers a sync repo over the AUR when both have the name. If no helper could be bootstrapped it prints `warning: no yay/paru and none could be bootstrapped — skipping AUR packages: …` and continues.