Nuguland config → appearance selects dark/light mode and bar orientation.
Nugu generates and installs palette variants; runtime switching belongs to Nuguland and never imports these generators.
The just mode recipes remain compatibility/diagnostic wrappers for selection, toggle, read-only status and startup preparation.
Missing or invalid mode state means dark; runtime operations never edit tracked configuration.
State lives in $XDG_STATE_HOME/nugu, defaulting to ~/.local/state/nugu.
~/.nugu-runtime points there because Niri expands ~, not XDG variables.
Preparation refuses an unrelated existing path at that location.
The Niri session launcher calls Nuguland's runtime before UWSM starts the compositor; Quickshell also prepares before startup.
Both select preinstalled Niri/aerc variants, without Nugu source available.
Desktop profiles may retain ~/.config/nugu for compatibility wrappers; it is not a runtime generator dependency.
Niri watches its generated colour-only include; Nuguland watches the mode file.
aerc loads the runtime styleset and receives its native SIGHUP reload, preserving the running process.
WezTerm follows native desktop appearance, without the retired cache override.
Zed, Ghostty and Neovide already select system appearance; Yazi and terminal Neovim follow their terminal's palette.
Layout, bindings, modules and timeouts stay in each consumer's configuration.
base.toml → nugu.nu → palette-derived dark/light colours.
just quickshell installs both Nuguland palettes into ../quickshell/nuguland/nugu.json; generation is separate from runtime mode selection.
just niri still generates both standalone Niri variants into ../niri/themes/, without selecting either.
just test-mode checks commands, preparation, startup handoff and round-trip invariance in a private home.
just ui-test bar in ../quickshell/nuguland checks live shell/compositor switching, native terminal selection through a private settings-portal boundary, and aerc's rendered ANSI colours.
Actual desktop portal delivery and final visual acceptance remain live-desktop owner checks.
Termux
base.toml → nugu.nu → termux.nu → output/termux/nugu-{dark,light}.properties.
Run mise run nugu-termux from the dotfiles root to generate both variants into ../termux/themes/.
Generation does not select a theme.
The Nushell command termux-theme dark or termux-theme light selects one manually and reloads Termux.
See Termux setup and recovery.
Validate generation and switching with mise run termux-test from the dotfiles root.
spindraw
base.toml → nugu.nu → spindraw.nu → one CSS file with spindraw's roles as custom properties.
Run just spindraw <spindraw>/assets/nugu.css here; it writes only that file and leaves output/ alone.
The OS preference picks light or dark; <html data-theme="light|dark"> overrides it.
spindraw's deno task gate:nugu checks both modes, every role and the contrast of text roles.
TODO
helix
wezterm
linux console
LS_COLORS
hypr
firefox
nushell
ui.important_globalbrighter (dark only?)
ui.accent brighter (dark only?)
ui.minor darker (dark only?)
# nugu
Personal color theme for various applications.
## Desktop mode
Nuguland **config → appearance** selects dark/light mode and bar orientation.
Nugu generates and installs palette variants; runtime switching belongs to Nuguland and never imports these generators.
The `just mode` recipes remain compatibility/diagnostic wrappers for selection, toggle, read-only status and startup preparation.
Missing or invalid mode state means dark; runtime operations never edit tracked configuration.
State lives in `$XDG_STATE_HOME/nugu`, defaulting to `~/.local/state/nugu`.
`~/.nugu-runtime` points there because Niri expands `~`, not XDG variables.
Preparation refuses an unrelated existing path at that location.
The Niri session launcher calls Nuguland's runtime before UWSM starts the compositor; Quickshell also prepares before startup.
Both select preinstalled Niri/aerc variants, without Nugu source available.
Desktop profiles may retain `~/.config/nugu` for compatibility wrappers; it is not a runtime generator dependency.
Niri watches its generated colour-only include; Nuguland watches the mode file.
aerc loads the runtime styleset and receives its native SIGHUP reload, preserving the running process.
WezTerm follows native desktop appearance, without the retired cache override.
Zed, Ghostty and Neovide already select system appearance; Yazi and terminal Neovim follow their terminal's palette.
Layout, bindings, modules and timeouts stay in each consumer's configuration.
`base.toml` → `nugu.nu` → palette-derived dark/light colours.
`just quickshell` installs both Nuguland palettes into `../quickshell/nuguland/nugu.json`; generation is separate from runtime mode selection.
`just niri` still generates both standalone Niri variants into `../niri/themes/`, without selecting either.
`just test-mode` checks commands, preparation, startup handoff and round-trip invariance in a private home.
`just ui-test bar` in `../quickshell/nuguland` checks live shell/compositor switching, native terminal selection through a private settings-portal boundary, and aerc's rendered ANSI colours.
Actual desktop portal delivery and final visual acceptance remain live-desktop owner checks.
## Termux
`base.toml` → `nugu.nu` → `termux.nu` → `output/termux/nugu-{dark,light}.properties`.
Run `mise run nugu-termux` from the dotfiles root to generate both variants into `../termux/themes/`.
Generation does not select a theme.
The Nushell command `termux-theme dark` or `termux-theme light` selects one manually and reloads Termux.
See [Termux setup and recovery](../termux/README.md).
Validate generation and switching with `mise run termux-test` from the dotfiles root.
## spindraw
`base.toml` → `nugu.nu` → `spindraw.nu` → one CSS file with spindraw's roles as custom properties.
Run `just spindraw <spindraw>/assets/nugu.css` here; it writes only that file and leaves `output/` alone.
The OS preference picks light or dark; `<html data-theme="light|dark">` overrides it.
spindraw's `deno task gate:nugu` checks both modes, every role and the contrast of text roles.
## TODO
* [x] helix
* [x] wezterm
* [x] linux console
* [ ] LS\_COLORS
* [x] hypr
* [ ] firefox
* [ ] nushell
* `ui.important_global` *brighter* (~dark~ only?)
* __ui.accent brighter__ (**dark** only?)
* _ui.minor darker_ (<em>dark</em> only?)