Files
nixos-setup/configs/ABOUTME.md
T
2026-10-20 15:50:41 -04:00

41 lines
3.4 KiB
Markdown

# configs/
Application configuration files that are symlinked into `~/.config/` via
`system.userActivationScripts` (using `skygUtils.makeHyperlinkScriptToConfigs`
from `modules/skyg-utils.nix`).
Most entries link `~/.config/<name>` -> `configs/<name>`. Some are host-scoped
and live under `configs/<hostName>/` — e.g. the Hyprland module links
`~/.config/hypr` -> `configs/<hostName>/hypr` (defaulting to the machine's
hostName). `makeHyperlinkScriptToConfigs` takes an optional `targetPath` for
these cases where the source subdir and `~/.config` target differ.
## Contents
| Path | Description |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `niri/` | Niri Wayland compositor config (legacy shared location — will be removed after hosts migrate to `<hostName>/niri/`) |
| `fwbook/niri/` | Niri config for `fwbook`; linked to `~/.config/niri` by the `skyg.nixos.desktop.tiler.niri` module (mirrors the hyprland pattern) |
| `fwbook/hypr/` | Hyprland config for `fwbook` (scrolling layout; Omarchy/nixarchy shell — noctalia binds+rules parked in `conf/noctalia/`); linked to `~/.config/hypr` |
| `fwbook/omarchy/` | Omarchy (nixarchy) shell config for `fwbook` (`shell.json`, plugins, backgrounds); linked to `~/.config/omarchy` by `hosts/fwbook/packages.nix` |
| `hl-fwdesk/hypr/` | Hyprland config for `hl-fwdesk` (Steam console); **baked into the build** via `mountAsSource`, linked to `~/.config/hypr` |
| `hl-pi1/hypr/` | Hyprland config for `hl-pi1` (clock box); linked to `~/.config/hypr` |
| `hl-fws1/hypr/` | Hyprland config for `hl-fws1` (remote slim desktop); **baked into the build** via `mountAsSource`, linked to `~/.config/hypr` |
| `hl-pi1/quickshell/` | Quickshell configs for `hl-pi1` (full-screen clock + calendar); linked to `~/.config/quickshell` |
| `fwbook/quickshell/` | Quickshell configs for `fwbook` (scrolling overview); linked to `~/.config/quickshell` |
| `extra.nu` | Extra NuShell config sourced at shell startup |
| `fwbook.knsv` | fwbook-specific Kanshi display profile |
| `hypr-types/hl.lua` | Shared EmmyLua type stubs for the `hl` global; each host's Hyprland `.luarc.json` points here via `workspace.library` |
| `pki/` | Public certs of the lab internal CA (`lab-ca.crt` + issued leaves), managed by `skyg ca`; **not** symlinked to `~/.config` — see `pki/ABOUTME.md` |
## Notes
- Changes here take effect on next login or when the activation script runs
- These are **not** NixOS options — they are plain config files managed as repo content
- The symlink mechanism is defined in `modules/skyg-utils.nix`
- Hosts can embed their config in the build by setting
`configLink.mountAsSource = true`; the dir is then read from the flake's
store path (`skyg.rootDir`) instead of the live `~/nixos-setup/configs`
checkout. See `modules/nixos/desktop/tiler/hyprland.nix`.