feat(keyboard): multi-layout cycle bind + summer-bar language parity

SUPER+SHIFT+K → hyprctl switchxkblayout current next, rendered only
when the session layout has a comma — the same gate as the Waybar
language indicator. Bind data is a separate multiLayoutBinds list in
keybinds.nix (still one source); hyprland.nix and the rofi cheatsheet
gate on the identical condition, so bind and cheatsheet cannot drift.
`current` targets the focused keyboard, so per-device-overridden
boards (single layout) are a no-op.

Parity: hyprland/language (with the keyboard glyph) added to both
summer waybar.jsonc whole-swaps + #language in their CSS. Static JSON
cannot eval-gate, so on summer themes the module shows even with one
layout — parity-over-minimalism, deliberate. Found en route:
summer-night has an idle_inhibitor the generated bar lacks (reverse
gap) — folded into backlog item 13.

Also — agent/BACKLOG.md gains items 21-24 from Bernardo's Latitude
5410 hardware QA (waybar crash on theme switch + no respawn; nameless
network-menu rows; a no-update sys-rebuild; Back-everywhere audit),
queued ahead of everything; HARDWARE-QUEUE's snapshot re-test now
carries the "update to >= a47aa3a + relogin" precondition, since
findings 5/6 match the pre-polkit-agent behavior exactly.

Verified: V0 (flake check, both summer JSONs parse) + V1 both
directions (default single-layout build renders no bind; us,de via
extendModules renders bind AND cheatsheet row). V3 cycle check queued.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

.gitea/workflows/check.yml

@@ -1,42 +1,40 @@
-# Nomarchy CI — eval + lint.
+# Nomarchy CI — the always-on net under direct-to-main pushes.
 #
-# Catches the regressions that hurt today:
-#   1. Flake stops evaluating (broken option ref, missing import, etc.).
-#      Checked per-output rather than via `nix flake check` so we can skip
-#      packages.allThemeVariants — the 22-generation linkFarm that OOMs the
-#      runner; every palette is validated one-at-a-time by the matrix (4).
-#   2. A `nomarchy-*` shell script has a syntax error or a shellcheck
-#      error-severity issue.
-#   3. `docs/SCRIPTS.md` drifts from the repo state because somebody
-#      added / removed / renamed a script and didn't run the generator
-#      (the pre-commit hook handles this, but only when enabled per-clone).
-#   4. An opt-in nomarchy.* toggle stops evaluating. `nix flake check`
-#      only evaluates the four default configs, so a bug that only fires
-#      when a toggle is flipped sails through (e.g. the impermanence
-#      systemd-stage-1 assertion). nomarchy-eval-matrix layers each toggle
-#      onto the default config and forces system.build.toplevel.
+# Scope (deliberate): the EVAL tier only. The runner behind this Gitea
+# instance is act_runner + docker containers (the legacy repo's check.yml
+# ran 57 times on it) — no systemd, no /dev/kvm — so the checks.* VM
+# tests and full toplevel builds can't run here. `nix flake check
+# --no-build` still catches most breakage (type errors, missing options,
+# bad merges, template/mkFlake drift — see docs/TESTING.md §1); the VM
+# suite stays a local/promotion gate until a KVM-capable NixOS runner
+# exists (see the commented vm-checks job at the bottom).
 #
-# Doesn't build ISOs — that needs a binary cache. Add a separate job
-# once Cachix/Attic is in place.
+# Inherited-from-legacy gotchas (learned over 57 runs, kept verbatim):
+#   - Single-user Nix (--no-daemon): no systemd in the container. The
+#     installer runs as root and honours build-users-group=nixbld from
+#     its bundled nix.conf, aborting unless the group exists AND has
+#     members — create nixbld + users first.
+#   - sandbox=false: Stylix/base16.nix do import-from-derivation; the
+#     single-user Nix in this container can't set up the build sandbox
+#     (no user namespaces), which otherwise surfaces as
+#     "path '…-source' is not valid".
+#   - Pin the Nix version: 2.34's lazy-trees git cache doesn't
+#     materialise flake-input `-source` paths into the store, breaking
+#     the same IFD reads. 2.31.5 matches what wrote flake.lock.
+#   - Plain-shell Nix install, not a JS action: act_runner's bundled act
+#     tops out at node20; a `run:` step has no node-runtime coupling.
 
 name: Check
 
 on:
   push:
-    branches: [main]
-  pull_request:
+    branches: [main, v1]
+  workflow_dispatch:
 
 jobs:
-  eval-and-lint:
+  eval:
     runs-on: ubuntu-latest
-    # Flakes for every `nix` invocation in the job (the bare `nix flake
-    # check` below relies on this; the scripts pass the flag themselves).
-    # sandbox=false because Stylix/base16.nix do import-from-derivation —
-    # eval realizes fetched `-source` paths mid-check, and the single-user
-    # Nix in this container can't set up the build sandbox (no user
-    # namespaces), which otherwise surfaces as "path '…-source' is not
-    # valid". NIX_SSL_CERT_FILE because we add nix to PATH without sourcing
-    # the installer's profile (which is what normally exports it).
+    timeout-minutes: 60
     env:
       NIX_CONFIG: |
         experimental-features = nix-command flakes
@@ -47,22 +45,6 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Install Nix
-        # Plain shell install rather than a JS action: act_runner's bundled
-        # `act` only supports up to node20, and nix-installer-action@main
-        # moved to node24 ("runs.using ... got node24"). A run step has no
-        # node-runtime coupling. Single-user (--no-daemon) needs no systemd,
-        # which the catthehacker container doesn't run as PID 1.
-        #
-        # The installer runs as root here and honours build-users-group=
-        # nixbld from its bundled nix.conf, aborting unless that group exists
-        # AND has members. Create the nixbld group + build users (what a
-        # multi-user install does) before running it.
-        #
-        # Pin the Nix version: the latest (2.34) uses lazy-trees / a git
-        # cache that doesn't materialise flake-input `-source` paths into
-        # the store, so Stylix's import-from-derivation reads fail with
-        # "path '…-source' is not valid". 2.31.5 matches the Nix that wrote
-        # flake.lock locally and evaluates the flake cleanly.
         run: |
           NIX_VERSION=2.31.5
           groupadd -r nixbld 2>/dev/null || true
@@ -73,118 +55,47 @@ jobs:
           curl -L "https://releases.nixos.org/nix/nix-${NIX_VERSION}/install" | sh -s -- --no-daemon
           echo "$HOME/.nix-profile/bin" >> "$GITHUB_PATH"
 
-      - name: Materialize flake-input sources for eval
-        # Walker's flake reads its own source tree during evaluation:
-        # importTOML resources/config.toml in its home-manager module and
-        # lib.fileset.toSource for the package src (cargoLock.lockFile =
-        # "${src}/Cargo.lock"). On a cold store the input source isn't
-        # materialised, so flake check / eval die with "path '…-source' is
-        # not valid" (works locally only because prior builds materialised
-        # it; `nix flake archive` reports the input but doesn't make the
-        # fileset-derived src readable). `nix build` of walker's src
-        # eagerly realises it — and the input it reads from — priming the
-        # store so the later eval steps find every path valid.
-        run: |
-          nix build --no-link --impure --expr 'let f = builtins.getFlake (toString ./.); in f.inputs.walker.packages.${builtins.currentSystem}.default.src'
+      - name: nix flake check (eval only)
+        # Full module-system evaluation of every output — both nixos
+        # configs, the home config, the checks.* derivations (instantiated,
+        # not run) and the downstream template through lib.mkFlake.
+        run: nix flake check --no-build
 
-      - name: Check flake outputs (except the 22-variant pre-cache package)
-        # Stand-in for `nix flake check --no-build`. That also evaluates
-        # packages.allThemeVariants — a linkFarm whose drvPath forces all 22
-        # home generations into memory at once, OOM-killing the runner. The
-        # eval matrix below already validates every palette one-at-a-time, so
-        # that package's CI value is near-zero. Here we force every other
-        # output (all 4 system closures incl. assertions, both standalone
-        # home generations, the installer VM package, the overlay, the app)
-        # and skip only allThemeVariants/default. Each tryEval is GC'd before
-        # the next, so peak memory is one config, not twenty-two.
+      - name: Python syntax (nomarchy-theme-sync)
+        # Via nix shell so the step doesn't depend on the runner image
+        # preinstalling python3.
         run: |
-          nix eval --impure --raw --expr 'let
-            f = builtins.getFlake (toString ./.);
-            lib = f.inputs.nixpkgs.lib;
-            sys = "x86_64-linux";
-            ok = x: (builtins.tryEval (builtins.seq x true)).success;
-            checks = {
-              "nixos.default"            = ok f.nixosConfigurations.default.config.system.build.toplevel.drvPath;
-              "nixos.nomarchy-installer" = ok f.nixosConfigurations.nomarchy-installer.config.system.build.toplevel.drvPath;
-              "nixos.installerVm"        = ok f.nixosConfigurations.installerVm.config.system.build.toplevel.drvPath;
-              "nixos.nomarchy-live"      = ok f.nixosConfigurations.nomarchy-live.config.system.build.toplevel.drvPath;
-              "home.nomarchy"            = ok f.homeConfigurations.nomarchy.activationPackage.drvPath;
-              "home.nixos"               = ok f.homeConfigurations.nixos.activationPackage.drvPath;
-              "packages.installerVm"     = ok f.packages.${sys}.installerVm.drvPath;
-              "overlays.default"         = ok (builtins.isFunction f.overlays.default);
-              "apps.installerVm"         = ok f.apps.${sys}.installerVm.program;
-            };
-            failed = builtins.attrNames (lib.filterAttrs (_: v: !v) checks);
-          in if failed == [] then "ALL OK"
-             else throw ("flake-output checks failed: " + builtins.concatStringsSep ", " failed)'
+          nix shell nixpkgs#python3 --command \
+            python3 -m py_compile pkgs/nomarchy-theme-sync/nomarchy-theme-sync.py
 
-      - name: Evaluate opt-in toggle / palette / home matrix
-        # flake check never flips a nomarchy.* toggle; this does. jq is
-        # provided via nix shell so the step doesn't depend on the runner
-        # image preinstalling it.
-        run: nix shell nixpkgs#jq --command ./bin/utils/nomarchy-eval-matrix
-
-      - name: Lint nomarchy-* scripts (bash -n + shellcheck)
+      - name: Shell syntax (tracked scripts)
+        # The distro's user-facing scripts are generated by Nix (their
+        # syntax is exercised by the eval + local builds); this covers the
+        # hand-written .sh files: installer helpers and maintainer tools.
         run: |
-          # Mirror what .githooks/pre-commit runs locally, but across the
-          # whole tree instead of just changed files. Pre-commit gates
-          # individual commits; CI gates branches (including --no-verify
-          # bypasses).
           set -e
           fail=0
           while IFS= read -r script; do
-            [[ -f "$script" ]] || continue
-            # Python helpers ship under the same nomarchy- prefix
-            # (e.g. nomarchy-haptic-touchpad). Skip non-bash.
-            head -1 "$script" | grep -qE '^#!.*\bbash\b' || continue
+            head -1 "$script" | grep -qE '^#!.*\b(bash|sh)\b' || continue
             if ! bash -n "$script"; then
               echo "::error file=$script::bash syntax error"
               fail=1
             fi
-            if ! nix shell nixpkgs#shellcheck --command shellcheck \
-                  --severity=error --shell=bash "$script"; then
-              echo "::error file=$script::shellcheck error-severity issue"
-              fail=1
-            fi
-          done < <(find features/scripts/utils core/system/scripts \
-                        themes/engine/scripts \
-                        -maxdepth 1 -type f -name 'nomarchy-*')
+          done < <(git ls-files '*.sh')
           exit "$fail"
 
-      - name: docs/SCRIPTS.md is up to date
-        run: |
-          # Regenerate to a temp file and compare. If different, the
-          # contributor forgot to run the generator (or skipped the
-          # pre-commit hook). Fail loudly and tell them the fix.
-          ./bin/utils/nomarchy-docs-scripts --out /tmp/SCRIPTS.regen.md
-          if ! diff -q docs/SCRIPTS.md /tmp/SCRIPTS.regen.md >/dev/null; then
-            echo "::error::docs/SCRIPTS.md is stale."
-            echo "Run: ./bin/utils/nomarchy-docs-scripts --out docs/SCRIPTS.md"
-            echo "Then commit the regenerated file."
-            echo "--- diff ---"
-            diff -u docs/SCRIPTS.md /tmp/SCRIPTS.regen.md || true
-            exit 1
-          fi
-
-      - name: installer/hardware-db.sh references real nixos-hardware modules
-        run: |
-          # Every 4th-pipe-field in HARDWARE_DB is a nixos-hardware module
-          # name. Half the DB used to point at modules that don't exist
-          # (e.g. microsoft-surface-pro-8 — there's only -pro-intel and
-          # -pro-9), which made the install fail at eval time with
-          # cryptic "attribute not found" errors on real laptops. This
-          # step catches that regression class.
-          awk -F'|' '/^  "/ { gsub(/"/,"",$4); gsub(/^[[:space:]]+|[[:space:]]+$/,"",$4); if ($4) print $4 }' \
-            installer/hardware-db.sh | sort -u > /tmp/db-refs.txt
-          nix eval --impure --json --expr '
-            let
-              nh = (builtins.getFlake (toString ./.)).inputs.nixos-hardware.nixosModules;
-            in builtins.attrNames nh' \
-            | nix shell nixpkgs#jq --command jq -r '.[]' | sort -u > /tmp/db-real.txt
-          missing=$(comm -23 /tmp/db-refs.txt /tmp/db-real.txt)
-          if [[ -n "$missing" ]]; then
-            echo "::error::hardware-db.sh references nixos-hardware modules that don't exist:"
-            printf '  - %s\n' $missing
-            echo "Either fix the name (check the actual attr in nixos-hardware) or drop the row."
-            exit 1
-          fi
+  # ── vm-checks (DISABLED until a KVM runner exists) ────────────────────
+  # The real prize: running the checks.* VM suite + a toplevel build in
+  # CI. Needs a runner on a NixOS (or at least nix + /dev/kvm) host —
+  # register one with a dedicated label, then uncomment and set runs-on
+  # to that label. Do NOT enable this against a label that doesn't
+  # exist: Gitea queues such jobs forever instead of failing.
+  #
+  # vm-checks:
+  #   runs-on: nix-kvm
+  #   timeout-minutes: 120
+  #   steps:
+  #     - uses: actions/checkout@v4
+  #     - run: nix flake check          # builds + runs the VM tests
+  #     - run: nix build .#nixosConfigurations.nomarchy.config.system.build.toplevel --no-link
+  #     - run: nix build .#homeConfigurations.nomarchy.activationPackage --no-link

.githooks/pre-commit

@@ -1,54 +0,0 @@
-#!/usr/bin/env bash
-# Nomarchy pre-commit hook.
-#
-# Enable per-clone with:
-#   git config core.hooksPath .githooks
-#
-# Two responsibilities:
-#  1. Lint changed nomarchy-* scripts (bash -n + shellcheck if available)
-#     so syntax errors and unquoted-var bugs don't ship.
-#  2. Regenerate docs/SCRIPTS.md when any nomarchy-* script under the three
-#     script directories is added, modified, or deleted in this commit, and
-#     stage the refreshed file so it lands with the change.
-
-set -e
-
-repo_root="$(git rev-parse --show-toplevel)"
-cd "$repo_root"
-
-script_dirs_re='^(features/scripts/utils|core/system/scripts|themes/engine/scripts)/nomarchy-'
-
-# 1. Lint changed scripts. bash -n catches syntax errors (always fatal).
-# shellcheck catches unquoted-var, use-before-define, missing-shebang, etc.
-# We only fail on severity=error so the long tail of pre-existing warnings
-# (info / style / warning) doesn't block commits — those can be cleaned up
-# incrementally without a flag day.
-changed_scripts=$(git diff --cached --name-only --diff-filter=ACMR \
-                  | grep -E "$script_dirs_re" || true)
-if [[ -n "$changed_scripts" ]]; then
-  while IFS= read -r script; do
-    [[ -f "$script" ]] || continue
-    # Only lint scripts with a bash shebang. nomarchy-* is a name
-    # convention, not a language guarantee — at least one Python helper
-    # ships under the same prefix (nomarchy-haptic-touchpad).
-    head -1 "$script" | grep -qE '^#!.*\bbash\b' || continue
-    if ! bash -n "$script"; then
-      echo "pre-commit: bash syntax error in $script — aborting commit." >&2
-      exit 1
-    fi
-    if command -v shellcheck >/dev/null 2>&1; then
-      if ! shellcheck --severity=error --shell=bash "$script"; then
-        echo "pre-commit: shellcheck found error-level issues in $script — aborting commit." >&2
-        echo "pre-commit: fix the reported issues, or rerun with --no-verify after a deliberate decision to ship." >&2
-        exit 1
-      fi
-    fi
-  done <<< "$changed_scripts"
-fi
-
-# 2. Regenerate the script audit doc.
-if git diff --cached --name-only --diff-filter=ACMRD | grep -qE "$script_dirs_re"; then
-  echo "pre-commit: regenerating docs/SCRIPTS.md (script change detected)…"
-  ./bin/utils/nomarchy-docs-scripts --out docs/SCRIPTS.md
-  git add docs/SCRIPTS.md
-fi

.gitignore

@@ -1,15 +1,13 @@
-# ---> Nix
-# Ignore build outputs from performing a nix-build or `nix build` command
+# Study material from the previous iteration — not part of the flake.
+# Delete the directory once everything worth porting has been ported.
+old_distro/
+
+# Nix build artifacts
 result
 result-*
 
-# Ignore automatically generated direnv output
-.direnv
+__pycache__/
+.DS_Store
 
-# Local IDE settings
-.claude/
-
-# VM and ISO artifacts
-*.qcow2
-*.qcow
-*.iso
+# Claude Code machine-local settings (permissions etc.)
+.claude/settings.local.json

CLAUDE.md

@@ -0,0 +1,25 @@
+# Nomarchy — agent entry point
+
+Nomarchy is a NixOS-based distro: rock-stable, fully reproducible, themed
+from one JSON, configured through a menu that writes into the user's own
+flake checkout. Read the README for the architecture.
+
+## If you're here to work autonomously (the loop)
+Follow **`agent/LOOP.md`** — it defines one iteration: orient
+(GOALS/BACKLOG/JOURNAL/MEMORY), take the top actionable BACKLOG item,
+verify up the V0–V3 ladder, commit+push on `main`, record. All loop state
+is git-tracked in `agent/`.
+
+## Rules that apply to every session, loop or not
+- **Honesty rule** (docs/TESTING.md): for visual/interactive changes,
+  evaluation is not rendering — state exactly what you verified and at
+  which tier. Cheap check first, always: `nix flake check --no-build`.
+- **Conventions** (`agent/CONVENTIONS.md`): in-flake state, menu
+  placement, Waybar parity with the summer whole-swaps, toggle-vs-package
+  discipline, commented template examples for opt-ins.
+- **Git:** direct commits on `main`, pushed; `v1` is the human-only
+  release pointer — never touch it. Never run `nix flake update` unless
+  the task is a lock bump. No formatter — match the aligned
+  hand-formatting.
+- Machine-specifics live in `hosts/`, the distro in `modules/`, data in
+  `themes/`, code in `pkgs/`, maintainer tools in `tools/`.

README.md

@@ -1,118 +1,418 @@
-# 👑 Nomarchy
+# Nomarchy
 
-**Nomarchy** is a professional-grade NixOS distribution that ships a highly curated Hyprland desktop on a strictly declarative, flake-based foundation. It provides a highly polished, "it just works" experience for power users who want a beautiful Wayland environment without sacrificing the reliability of NixOS.
+**The rock-solid reproducibility of NixOS 26.05. The out-of-the-box polish of
+Omarchy/Omakub.** One JSON file rules the look of the entire desktop; every
+theme change is a Home Manager generation — atomic, rollbackable, never
+partial.
 
-## ✨ Key Features
-
-- **Purely Declarative:** Your entire desktop—themes, fonts, wallpapers, and toolchains—is defined in code.
-- **Modular Merging Architecture:** Distro code and user code are strictly separated. You can update the distro core without ever touching or breaking your personal configurations.
-- **Interactive "Smart" Installer:** Detects hardware, sets up networking, localizes timezones/keymaps, and offers multi-select software profiles.
-- **Erase Your Darlings (Optional):** Optional BTRFS root-wipe on boot ensures your system stays pristine and 100% declarative.
-- **Dynamic Theming Engine:** 20+ built-in themes with instant UI feedback via IPC (swww, waybar, and stylix).
-- **Portable State (`nomarchy-sync`):** Easily backup and sync your declarative config and dynamic state (theme/wallpaper choices) to a private Git repo.
-
----
-
-## 📂 Component-Based Architecture
-
-Nomarchy uses a **Feature-Centric Directory Structure**. For a comprehensive breakdown of the system architecture, folder roles, and module logic, see the [Detailed Architecture Documentation](docs/STRUCTURE.md).
-
-Configuration, modules, and utilities are strictly organized to maintain sanity as the system grows.
-
-- **`core/`**: Foundational OS & User defaults (Bootloader, Audio, Bluetooth, core system features).
-- **`features/`**: Isolated modules containing Nix logic and raw dotfiles.
-  - **`features/apps/`**: App-specific configs (e.g., `features/apps/btop/`, `features/apps/kitty/`), each containing their own `default.nix` and standalone `config/` directory mapped via Home Manager.
-  - **`features/desktop/`**: Desktop environment components (e.g., Hyprland, Waybar).
-  - **`features/scripts/utils/`**: Consolidated repository for all custom Nomarchy bash scripts, centrally packaged and injected into the user's `PATH` with correct dependencies.
-- **`themes/`**: The global theming engine. It holds pure color data and logic. *Theme-specific app layouts* (like a custom Waybar layout) are stored directly inside the app's feature folder, solving the matrix problem of theming.
-
----
-
-## 📥 Installation
-
-### 1. Try it in a VM (Recommended)
-Verify the experience without touching your hardware:
-```bash
-./bin/utils/nomarchy-test-installer
 ```
-This builds a full graphical VM of the installer environment. Once inside, click the **Install Nomarchy** icon or run `nomarchy-install`.
-
-### 2. Build the Installer ISO
-To install on physical hardware, generate your own bootable image:
-```bash
-./features/scripts/utils/nomarchy-build-iso       # Minimal TTY installer
-./features/scripts/utils/nomarchy-build-live-iso  # Graphical try-before-install
+┌──────────────────────────────────────────────────────────────────────────┐
+│                  theme-state.json  (single source of truth)              │
+│                  lives INSIDE your flake checkout, git-tracked           │
+└───────────────────────────────────┬──────────────────────────────────────┘
+                                    │
+        nomarchy-theme-sync apply gruvbox                                   
+            1. merges the preset into the JSON (atomic write)               
+            2. runs `home-manager switch` (no sudo, no system rebuild)      
+                                    │
+                                    ▼ pure read (nomarchy.stateFile)
+┌──────────────────────────────────────────────────────────────────────────┐
+│  Home Manager bakes EVERYTHING into one read-only generation:            │
+│    Hyprland (colors/gaps/borders)      Waybar (palette or whole-swap)    │
+│    Ghostty (full ANSI palette)         btop (asset or generated)         │
+│    Stylix → GTK, Qt, cursors, fonts                                      │
+└───────────────────────────────────┬──────────────────────────────────────┘
+                                    ▼
+              wallpaper via awww (the one runtime piece:                    
+              applied post-switch + at session start, `bg next` cycles)     
 ```
-The ISO will be located at `./result/iso/nixos-*.iso`. Flash it to a USB drive and boot.
 
-### 3. Run the Installer
-Once booted into the Live environment, launch the installer:
-```bash
-nomarchy-install
+## 1. Layout
+
+Flat on purpose. Two module trees, one options file each, no hidden layers.
+
+```
+.
+├── flake.nix                      # inputs + the downstream API (exports below)
+├── lib.nix                        # nomarchy.lib.mkFlake — one-call downstream wrapper
+├── theme-state.json               # ★ THE single source of truth (git-tracked!)
+├── themes/                        # 21 presets: <slug>.json + optional <slug>/ assets
+│   ├── nord.json                  #   palette (required, works alone)
+│   └── nord/                      #   assets (optional, fixed filenames)
+│       ├── backgrounds/           #     wallpapers (auto-picked, SUPER+SHIFT+T cycles)
+│       ├── btop.theme             #     hand-made config drop (else generated)
+│       └── waybar.css             #     whole-swap: replaces the generated bar style
+├── modules/
+│   ├── nixos/                     # the distro, system side
+│   │   ├── default.nix            #   Hyprland session, Pipewire, greetd, fonts
+│   │   ├── options.nix            #   nomarchy.system.* toggles
+│   │   ├── plymouth.nix           #   boot splash, tinted from the JSON
+│   │   ├── file-manager.nix       #   Thunar GUI + gvfs/tumbler/udisks2
+│   │   └── power.nix              #   power-profiles-daemon/TLP, thermald, charge limit
+│   └── home/                      # the distro, user side
+│       ├── default.nix            #   entry point
+│       ├── options.nix            #   nomarchy.* option surface
+│       ├── theme.nix              #   JSON ingestion + wallpaper hook
+│       ├── stylix.nix             #   GTK/Qt/cursors/fonts from the same JSON
+│       ├── hyprland.nix           #   all JSON-driven
+│       ├── waybar.nix
+│       ├── ghostty.nix
+│       ├── btop.nix
+│       ├── rofi.nix               #   launcher + nomarchy-menu (calc, emoji, clip…)
+│       ├── keybinds.nix           #   single source: Hyprland binds + SUPER+? sheet
+│       ├── swaync.nix             #   notifications, same JSON
+│       ├── idle.nix               #   hyprlock + hypridle, same JSON
+│       ├── yazi.nix               #   flagship TUI file manager + plugins
+│       ├── osd.nix                #   swayosd volume/brightness OSD
+│       ├── shell.nix              #   zsh + starship + bat/eza/zoxide
+│       ├── keys.nix               #   gpg-agent fronting SSH, pinentry-qt
+│       └── fastfetch.nix          #   themed Nomarchy logo + system info
+├── hosts/
+│   ├── default/                   # reference machine (thin: boot, user, hostname)
+│   └── live.nix                   # bootable live ISO (try the distro, no install)
+├── pkgs/
+│   ├── nomarchy-theme-sync/       # state writer + rebuild dispatcher (Python)
+│   └── nomarchy-install/          # live-ISO installer (gum + disko + mkFlake)
+├── templates/downstream/          # `nix flake init -t` starter for users
+├── docs/TESTING.md                # how to verify changes (incl. AI-agent rules)
+├── docs/OVERRIDES.md              # how downstream users override defaults
+├── docs/ROADMAP.md                # design/decision records + shipped-fixes log
+├── agent/                         # autonomous-agent loop: protocol (LOOP.md),
+│                                  #   prioritized BACKLOG, journal, memory
+└── tools/                         # maintainer-only
+    ├── import-palettes.py         #   converts old-distro themes → JSON + assets
+    ├── test-live-iso.sh           #   build the ISO + boot it in QEMU
+    ├── test-install.sh            #   full offline-install regression in QEMU
+    └── vm/                        #   headless-VM helpers (QMP keys, VNC shots,
+                                   #   offline-pin gap analysis)
 ```
-The wizard will guide you through:
-- **Networking:** An interactive wizard to connect to Wi-Fi if needed.
-- **Hardware:** Optimized profiles for Dell XPS, Framework, Apple T2, and more.
-- **Storage:** Choice between Standard Ext4 or Encrypted BTRFS with optional **Impermanence**.
-- **Localization:** Searchable timezones and keyboard layout selection.
 
-### Already on NixOS?
-Layer Nomarchy onto an existing 25.11 install without reformatting — see the [Migration Guide](docs/MIGRATION.md).
+**Rule of thumb:** `modules/` is the distro (reusable, no machine specifics),
+`hosts/` is a machine, `themes/` is data, `pkgs/` is code, `tools/` is
+maintainer-only. If a new file doesn't obviously belong to one of those, it
+probably shouldn't exist.
 
----
+## 2. Try it first (live ISO)
 
-## 🛠️ Configuration & Usage
+Boot the full desktop from a USB stick or VM without installing anything:
 
-Nomarchy uses a "Downstream" model. After installation, your configuration lives in `/etc/nixos/` and is split into three main parts:
+```sh
+nix build .#nixosConfigurations.nomarchy-live.config.system.build.isoImage
+# → result/iso/*.iso — dd to a stick, or boot it in QEMU:
+tools/test-live-iso.sh
+```
 
-### 1. Distro Core (Upstream)
-Managed via the public Git repository. This is the engine. You should generally not modify files here.
+The live session auto-logs-in, seeds the flake at `~/.nomarchy`, and pins
+the locked inputs into the ISO store — so theme switching (including the
+`home-manager switch` it triggers) works **offline**, exactly like on an
+installed system. Verification checklist: [docs/TESTING.md](docs/TESTING.md).
+
+Like what you see? **`nomarchy-install`** (in a terminal) walks you through
+installing to disk: pick a disk, LUKS2 full-disk encryption **by default**
+(in exchange the desktop logs in passwordless — the passphrase already
+gates the machine), user + hostname + timezone, hardware autodetection
+(DMI → nixos-hardware profile), a hibernation-ready swapfile sized to RAM,
+then disko partitions (GPT + ESP + BTRFS subvolumes incl. `@snapshots` —
+snapper timeline snapshots are on) and `nixos-install` runs — **without a
+network** when the ISO was built from a clean tree (the target's
+`flake.lock` is composed from the rev the ISO carries). The installed
+machine gets the standard downstream layout: the flake at `~/.nomarchy`
+(`/etc/nixos` symlinks to it), one `mkFlake` call, your
+`system.nix`/`home.nix`. First boot lands in the fully themed desktop —
+the installer pre-activates the Home Manager generation. UEFI only for now.
+
+## 3. Using Nomarchy on your machine (downstream)
+
+Nomarchy is consumed as a flake input — you never fork or edit this repo:
+
+```sh
+mkdir my-machine && cd my-machine
+nix flake init -t "git+https://git.bemagri.xyz/bernardo/nomarchy.git?ref=v1"
+```
+
+You own two files day-to-day: `system.nix` and `home.nix` (plus
+`theme-state.json`, written by the CLI). Your `flake.nix` is set up once —
+later by the installer — and never hand-edited; it's a single call:
 
-### 2. Your System (`system.nix`)
-Add system-wide packages, services, and hardware tweaks here.
-*Example: Adding a persistent directory for Docker if using Impermanence:*
 ```nix
-environment.persistence."/persist" = {
-  directories = [ "/var/lib/docker" ];
+outputs = { nomarchy, ... }:
+  nomarchy.lib.mkFlake {
+    src = ./.;
+    username = "me";
+    hardwareProfile = "framework-13-7040-amd"; # optional, nixos-hardware name
   };
 ```
 
-### 3. Your User Environment (`home.nix`)
-Add user-level packages, aliases, and dotfiles here.
-*Example: Overriding the default terminal:*
-```nix
-nomarchy.home.terminal = "kitty";
+| `mkFlake` arg | Default | Purpose |
+|---|---|---|
+| `src` | — (required) | Your flake directory (`./.`) |
+| `username` | — (required) | Login name; flows into `system.nix` and names the HM config |
+| `hardwareProfile` | `null` | One [nixos-hardware](https://github.com/NixOS/nixos-hardware) module name, or a list of them (pinned + tested by Nomarchy; unknown names fail with suggestions) |
+| `system` | `"x86_64-linux"` | Platform |
+
+(Power users can skip `mkFlake` and wire `nixosModules.nomarchy` /
+`homeModules.nomarchy` / `overlays.default` by hand — the wrapper is sugar.)
+
+Two deliberately separate rebuild paths:
+
+```sh
+sudo nixos-rebuild switch --flake .#default   # system: rare
+home-manager switch --flake .#me              # desktop: every theme change, no sudo
 ```
 
-For the full list of `nomarchy.*` options you can set in `system.nix` and `home.nix`, see the [Options Reference](docs/OPTIONS.md). For custom automation, see [Runtime Hooks](docs/HOOKS.md). Hit a rebuild error? Check [Troubleshooting](docs/TROUBLESHOOTING.md). For where the project is heading next, see the [Roadmap](docs/ROADMAP.md).
+Day-to-day you'll use the shipped shortcuts instead:
 
-### Applying Changes
-After editing your files, apply them instantly. **IMPORTANT:** Nomarchy requires the `--impure` flag for evaluation. You **MUST** use the following aliases rather than standard NixOS commands:
-
-```bash
-sys-update  # Rebuilds the NixOS system (Runs: sudo nixos-rebuild switch --flake .#default --impure)
-env-update  # Reloads your Home Manager environment (Runs: home-manager switch --flake .#default --impure)
+```sh
+sys-update    # nix flake update + system rebuild (BTRFS snapshot first when available)
+home-update   # home-manager switch (no flake update, no sudo)
 ```
 
----
+**Order matters when pulling distro updates.** `home-update` does *not*
+touch the lock — it rebuilds the desktop against the **current**
+`flake.lock`. A new Nomarchy revision (new keybinds, theming, modules)
+arrives only when the lock is updated, which `sys-update` does
+(`nix flake update`). So to pull an update that affects the desktop layer:
+run `sys-update` **first** (updates the lock + rebuilds the system), **then**
+`home-update` (re-applies the desktop against the new lock). Doing them in
+the other order rebuilds the desktop against the *old* inputs and silently
+skips the new home-side changes. After a home-side keybind/config change,
+also `hyprctl reload` (or relogin) so the running session re-reads it.
 
-## 🚀 Commands & Keybindings
+Override anything via the `nomarchy.*` surface or plain NixOS/HM options:
+appearance (gaps/colors/fonts) changes through `nomarchy-theme-sync`,
+behaviour (input/misc/monitor/chrome) is `mkDefault` so a plain `home.nix`
+assignment wins, and bind/exec-once lists concatenate. Full guide with
+examples: **[docs/OVERRIDES.md](docs/OVERRIDES.md)**.
 
-The full list lives in [`docs/KEYBINDINGS.md`](docs/KEYBINDINGS.md) (auto-generated from the Hyprland configs). A few highlights:
+**Where each option goes.** `nomarchy.system.*`, `nomarchy.hardware.*`, and
+`nomarchy.services.*` are NixOS options — set them in `system.nix`. Everything
+else under `nomarchy.*` is a Home Manager option — set it in `home.nix`. The
+two tables below are split along exactly that line.
 
-| Keybinding | Action |
-| :--- | :--- |
-| `Super + Space` | **App Launcher** (Walker) |
-| `Super + Shift + Space` | **Nomarchy Menu** (Walker) |
-| `Super + Alt + Space` | **Toggle Top Bar** (Waybar) |
-| `Super + Return` | Open Terminal |
-| `Super + Q` | Close Window |
+**`home.nix`** (Home Manager — the desktop):
 
-### Utility Scripts
-Nomarchy includes dozens of productivity scripts available in your PATH. Some highlights:
-- `nomarchy-sync push <repo>`: Backup your setup to Git.
-- `nomarchy-theme-bg-next`: Cycle to the next wallpaper in the current theme.
-- `nomarchy-menu`: The central hub for all utilities and pickers.
+| Option | Default | Purpose |
+|---|---|---|
+| `nomarchy.stateFile` | — (required) | Path to your theme-state.json |
+| `nomarchy.terminal` | `"ghostty"` | Terminal for keybinds and `$TERMINAL` |
+| `nomarchy.keyboard.layout` | `"us"` | XKB layout for the Hyprland session (installer writes the matching `services.xserver.xkb` in system.nix; the console + LUKS prompt follow via the distro default) |
+| `nomarchy.keyboard.variant` | `""` | XKB variant for the session |
+| `nomarchy.keyboard.devices` | `{}` | Per-device layout overrides (Hyprland `device` blocks keyed by `hyprctl devices` name) — e.g. an external keyboard with its own layout/variant |
+| `nomarchy.keyboard.layouts` | `[]` | Extra candidate layouts; when set, a watcher prompts (rofi) for a layout on a newly-connected keyboard and remembers it per-device |
+| `nomarchy.nightlight.enable` | `false` | Scheduled blue-light filter (hyprsunset) — warm at night (`.temperature`, default 4000K) between `.sunset`/`.sunrise`, no shift by day; off by default — enable it from the menu (System › Night light; the first enable rebuilds), then toggle on/off instantly from the menu or the Waybar moon indicator (writes `settings.nightlight.on` in your flake, no rebuild) and it survives reboot, so it stays reproducible |
+| `nomarchy.updates.enable` | `false` | Passive update awareness: a background check (`.interval`, default daily) that flags when flake inputs (nixpkgs, the Nomarchy input, …) are behind upstream — and, with Flatpak on, when apps have updates (`.flatpak`) — via a Waybar indicator + notification. Never changes anything; click the indicator to run the upgrade flow |
+| `nomarchy.hyprland.enable` | `true` | Nomarchy's Hyprland config |
+| `nomarchy.waybar.enable` | `true` | Nomarchy's Waybar |
+| `nomarchy.rofi.enable` | `true` | Themed rofi launcher + `nomarchy-menu` dispatcher |
+| `nomarchy.swaync.enable` | `true` | swaync notifications, themed |
+| `nomarchy.idle.enable` | `true` | hyprlock + hypridle (idle lock 5 min, display off 10, suspend 30) |
+| `nomarchy.yazi.enable` | `true` | yazi TUI file manager, themed + curated plugins |
+| `nomarchy.osd.enable` | `true` | swayosd on-screen display for volume/brightness/mute |
+| `nomarchy.shell.enable` | `true` | zsh + starship prompt + bat/eza/zoxide (zsh is the default login shell) |
+| `nomarchy.ghostty.enable` | `true` | Nomarchy's Ghostty |
+| `nomarchy.btop.enable` | `true` | btop with per-theme colors |
+| `nomarchy.stylix.enable` | `true` | GTK/Qt/cursor theming |
+| `nomarchy.fastfetch.enable` | `true` | fastfetch fronted by the themed Nomarchy logo |
+| `nomarchy.keys.enable` | `true` | gpg-agent fronting SSH + pinentry-qt |
+| `nomarchy.displays.enable` | `true` | nwg-displays interactive monitor arranger (helper for `nomarchy.monitors`) |
+| `nomarchy.monitors` | `[]` | Declarative per-output layout → Hyprland `monitor` rules (applied on hotplug); `,preferred,auto,1` wildcard kept as fallback |
+| `nomarchy.themesDir` | Nomarchy's `themes/` | Where per-theme app overrides are probed |
 
----
-*Built with ❤️ using NixOS, Hyprland, Stylix, and the Nomarchy Community.*
+**`system.nix`** (NixOS — the machine):
+
+| Option | Default | Purpose |
+|---|---|---|
+| `nomarchy.system.plymouth.enable` | `true` | Branded boot splash, background from the theme JSON (recolors on system rebuilds) |
+| `nomarchy.system.fileManager.enable` | `true` | Thunar GUI + gvfs/tumbler/udisks2 (the "open folder" handler) |
+| `nomarchy.system.greeter.enable` | `true` | greetd/tuigreet |
+| `nomarchy.system.greeter.autoLogin` | `null` | Auto-login this user into Hyprland (installer sets it on LUKS machines) |
+| `nomarchy.system.audio.enable` | `true` | Pipewire stack |
+| `nomarchy.system.bluetooth.enable` | `true` | Bluetooth + blueman |
+| `nomarchy.system.snapper.enable` | `false` | Hourly/daily BTRFS timeline snapshots + `nixos-rebuild-snap` (installer enables it; no-op unless root is BTRFS) |
+| `nomarchy.system.power.enable` | `true` | Active power management (see below) |
+| `nomarchy.system.power.backend` | `"ppd"` | `"ppd"` (power-profiles-daemon + menu/Waybar switcher) or `"tlp"` (deeper battery tuning, no switcher) — mutually exclusive |
+| `nomarchy.system.power.laptop` | `false` | Marks a laptop, gating battery-only features; the installer sets it when a battery is present |
+| `nomarchy.system.power.thermal.enable` | `false` | thermald (Intel-only); the installer enables it on a GenuineIntel CPU |
+| `nomarchy.system.power.batteryChargeLimit` | `null` | Stop charging at this % (e.g. `80`) where the hardware supports it; needs `power.laptop` |
+| `nomarchy.hardware.intel.enable` | `false` | Intel enablement above nixos-hardware (GuC/HuC via `i915.enable_guc=3`); the installer sets it on an Intel CPU/GPU |
+| `nomarchy.hardware.intel.computeRuntime` | `false` | Opt-in: Intel GPU compute — OpenCL/Level-Zero (`intel-compute-runtime`) + oneVPL (`vpl-gpu-rt`) |
+| `nomarchy.hardware.amd.enable` | `false` | AMD enablement above nixos-hardware (amd-pstate EPP + radeonsi VA-API); installer-set on an AMD CPU/GPU |
+| `nomarchy.hardware.amd.rocm.enable` | `false` | Opt-in: ROCm HIP/OpenCL GPU compute (multi-GB); pair with `.gfxOverride` (e.g. `"11.0.0"`) for an unlisted iGPU |
+| `nomarchy.hardware.fingerprint.enable` | `false` | fprintd for a detected fingerprint reader (installer-set); enroll with `fprintd-enroll` |
+| `nomarchy.hardware.fingerprint.pam` | `false` | Opt-in: use the fingerprint for login + sudo (PAM) |
+| `nomarchy.hardware.npu.enable` | `false` | Opt-in/experimental: load the on-die NPU driver (`amdxdna`/`intel_vpu`); userspace runtime is BYO |
+| `nomarchy.hardware.latestKernel` | `false` | Opt-in: ship `linuxPackages_latest` instead of the default kernel — for very new hardware whose drivers landed recently |
+| `nomarchy.services.tailscale.enable` | `false` | Opt-in: Tailscale mesh VPN (then `sudo tailscale up`) |
+| `nomarchy.services.syncthing.enable` | `false` | Opt-in: Syncthing file sync as the login user (GUI at `127.0.0.1:8384`) |
+| `nomarchy.services.podman.enable` | `false` | Opt-in: rootless Podman (`docker` aliased to it) |
+| `nomarchy.services.flatpak.enable` | `false` | Opt-in: Flatpak + the Flathub remote |
+| `nomarchy.services.pika.enable` | `false` | Opt-in: Pika Backup (GUI Borg backups) |
+| `nomarchy.services.steam.enable` | `false` | Opt-in: Steam via `programs.steam` (32-bit libs, controller udev, Remote-Play ports) |
+| `nomarchy.services.libvirt.enable` | `false` | Opt-in: libvirt/KVM + virt-manager GUI (login user added to `libvirtd`) |
+| `nomarchy.services.obs.enable` | `false` | Opt-in: OBS Studio + a v4l2loopback virtual camera (selectable as a webcam in Zoom/Teams) |
+| `nomarchy.services.docker.enable` | `false` | Opt-in: rootful Docker (user in `docker` group); don't enable alongside podman |
+| `nomarchy.services.kdeconnect.enable` | `false` | Opt-in: KDE Connect phone integration (opens its firewall ports) |
+| `nomarchy.services.gamemode.enable` | `false` | Opt-in: Feral GameMode performance daemon (`gamemoderun`) |
+| `nomarchy.services.adb.enable` | `false` | Opt-in: Android adb/fastboot tools (systemd handles device udev rules) |
+| `nomarchy.services.wireshark.enable` | `false` | Opt-in: Wireshark Qt GUI (user in `wireshark` group, capture without root) |
+| `nomarchy.services.ollama.enable` | `false` | Opt-in: Ollama local LLM runtime on `127.0.0.1:11434` (CPU; GPU via `services.ollama.acceleration`) |
+| `nomarchy.services.printing.enable` | `false` | Opt-in: CUPS + Avahi/mDNS network printer discovery |
+| `nomarchy.services.openrgb.enable` | `false` | Opt-in: OpenRGB daemon for RGB peripheral/motherboard lighting |
+| `nomarchy.services.restic.enable` | `false` | Opt-in: scheduled daily restic backup (set `.repository` + `.passwordFile`; 7/4/6 retention; list/restore via the `restic-nomarchy` wrapper) |
+
+Beyond the `nomarchy.*` surface, the system layer turns on the usual
+desktop services with `lib.mkDefault` (override natively). Two worth
+calling out: **`services.fwupd.enable`** is on by default for firmware
+updates via LVFS — it only refreshes metadata, never flashes on its own,
+so run `fwupdmgr update` to apply; disable with `services.fwupd.enable =
+false;` on machines without real firmware (VMs/headless). And
+**`services.earlyoom`** is on by default so running out of memory kills
+the offending process (with a desktop notification) instead of freezing
+the desktop — process-level on purpose, since a Hyprland session is one
+cgroup and systemd-oomd would kill all of it (oomd is disabled
+accordingly). Opt out with `services.earlyoom.enable = false;`.
+
+## 4. How theming works
+
+### Pure JSON ingestion
+
+The trap with "read a mutable file from Nix" is pure evaluation: flakes
+cannot read arbitrary `$HOME` paths without `--impure` (the old prototype
+required it — never again). Nomarchy's convention: **the state file lives
+inside the consuming flake** and is wired via
+`nomarchy.stateFile = ./theme-state.json;`. Reading it is pure — it's flake
+source. It must be git-tracked (`nomarchy-theme-sync` runs
+`git add --intent-to-add` after every write as a safety net).
+
+### One change = one generation
+
+`nomarchy-theme-sync apply <theme>` merges the preset into the JSON and runs
+`home-manager switch` (override the command with `$NOMARCHY_REBUILD`, or pass
+`--no-switch` to only write). Everything is baked: Hyprland, Waybar, Ghostty,
+btop, and — via Stylix, mapped onto base16 roles — GTK, Qt, cursors and
+fonts. No runtime patching means no partial states, and `home-manager
+generations` is also your theme history. Waybar even restyles in place: it
+re-reads `style.css` when the symlink flips.
+
+The **wallpaper** is the one runtime piece (awww — nixpkgs' swww — is
+imperative; nothing in Nix consumes the path): applied at session start and
+after every switch via a tiny activation hook, cycled instantly with
+`bg next`.
+
+### Config the menu writes (not just themes)
+
+The in-flake-state model isn't only for appearance. **Feature toggles you flip
+from the menu are written into a `settings.*` section of the *same* state file**
+— git-tracked, reproducible, never stashed in `~/.local/state`. The menu is just
+an ergonomic writer for your flake, so version-controlling your downstream
+reproduces the machine, settings and all. Where a toggle can take effect without
+a rebuild it does: the menu writes the key (`--no-switch`) and flips the running
+service, which reads the *live* flake state at session start, so the choice is
+both instant and survives reboot.
+
+**Night light** is the first to use this — enable it from the menu (System ›
+Night light; the first enable rebuilds to install hyprsunset), then on/off is
+instant. Internally it's two keys: `settings.nightlight.installed` (sticky —
+gates the unit, the first enable rebuilds) and `settings.nightlight.on` (the
+instant on/off). Expect more `nomarchy.*` toggles to migrate to this pattern.
+
+**Auto-commit (opt-in):** System › Auto-commit makes every `apply`/`set`
+mutation also `git commit` theme-state.json in your flake — *only* that
+file, so unrelated dirty work is never swept up — turning your settings
+history into `git log`. Off by default; the toggle is instant (nothing in
+Nix consumes the flag), the off-write is itself committed so history stays
+consistent, and wallpaper cycling (`bg next`) is deliberately excluded —
+the current wallpaper rides along with the next real commit.
+
+### Per-theme app assets (`themes/<slug>/`)
+
+Recoloring covers 95% of theming; the rest is one optional assets directory
+per theme — a single place to look, unlike the old distro's split:
+
+| Asset | Mechanism |
+|---|---|
+| `backgrounds/` | wallpapers; empty `wallpaper` in the state means "first one"; `bg next` cycles |
+| `btop.theme` | baked into the generation (generated from the palette when absent) |
+| `waybar.css` | **whole-swap**: replaces the generated bar style entirely (probed at eval time, self-contained) |
+| `waybar.jsonc` | whole-swap for the bar *layout* (must be plain JSON) |
+| `rofi.rasi` | **whole-swap**: replaces the generated launcher/menu theme entirely |
+
+Six ported themes ship a `waybar.css` identity (catppuccin, lumon, nord,
+retro-82, summer-day, summer-night). Custom user themes can live in
+`$NOMARCHY_PATH/themes/` (preset lookup) and `nomarchy.themesDir` (eval-time
+asset probe).
+
+## 5. Day-to-day
+
+```sh
+nomarchy-theme-sync list               # 21 presets (nord, gruvbox, rose-pine, …)
+nomarchy-theme-sync apply kanagawa     # whole desktop, one generation (~a switch)
+nomarchy-theme-sync set ui.gapsOut 16  # tweak one knob (also a switch)
+nomarchy-theme-sync bg next            # cycle wallpapers — instant, no rebuild
+nomarchy-theme-sync bg auto            # back to the theme's default wallpaper
+nomarchy-theme-sync get colors.accent
+sys-update                             # update inputs + rebuild the system (snapshots first)
+home-update                            # rebuild just the desktop layer
+```
+
+Keybinds: `SUPER+Return` terminal · `SUPER+D` launcher · `SUPER+T` theme
+picker · `SUPER+SHIFT+T` next wallpaper · `SUPER+X` power menu ·
+`SUPER+E` file manager (yazi) · `SUPER+N` notifications · `SUPER+CTRL+V`
+clipboard history · `SUPER+Q`
+close · `SUPER+1..9` workspaces · `Print` region screenshot.
+
+Shell aliases (zsh, gated on `nomarchy.shell.enable`) — `alias` lists them
+all; the curated set:
+
+```sh
+# navigation
+..   ...   ....                 # cd up 1 / 2 / 3 levels
+
+# git
+g    gst                        # git · git status -sb
+ga   gaa                        # git add · git add -A
+gc   gcm                        # git commit · git commit -m
+gco  gsw   gb                   # checkout · switch · branch
+gd   gds                        # diff · diff --staged
+gl   glg                        # log graph (last 20 · all branches)
+gp   gpl   gf                   # push · pull · fetch --all --prune
+
+# nix  (system/home rebuilds keep their full sys-update / home-update names)
+ns   nr                         # nix shell · nix run   (e.g. ns nixpkgs#ripgrep)
+nfu  nfc                        # nix flake update · check
+nsearch    ngc                  # nix search nixpkgs · nix-collect-garbage -d
+
+# misc
+path                            # print $PATH, one entry per line
+reload                          # exec zsh (reload the shell)
+```
+
+## 6. Extending
+
+- **New theme:** drop a JSON into `themes/` (schema = any existing preset),
+  plus an optional `themes/<slug>/` assets directory.
+- **New themed value:** add the key to `theme-state.json` and consume it in
+  the Nix modules. One place — there is no second renderer to keep in sync.
+- **Importing more old-distro palettes:**
+  `tools/import-palettes.py <palettes-dir> themes/`.
+- **New opt-in feature (convention):** when a feature is off by default and
+  needs the user to set `nomarchy.*` options (e.g. night light, per-device
+  keyboard layouts, monitor layout, power management), ship a **commented**
+  example of it in `templates/downstream/home.nix` or `system.nix`. New
+  installs then enable it by uncommenting + tweaking, rather than hunting the
+  docs for the option name.
+- **Applications:** the starter complete-workstation set (LibreOffice, VS
+  Code, GIMP, Inkscape) lives in the `home.packages` list in your
+  `home.nix` — it's a plain package list, so curate it directly: delete a
+  line to slim the machine, uncomment an extra (a browser, email, full TeX
+  Live), or add your own. No `nomarchy.apps.*` toggles — a package list is
+  already its own opt-out, so the distro doesn't impose these or wrap them.
+
+## Roadmap & known issues
+
+The prioritized queue of what's next lives in
+**[agent/BACKLOG.md](agent/BACKLOG.md)**; the detailed design/decision
+records and the log of shipped fixes stay in
+**[docs/ROADMAP.md](docs/ROADMAP.md)**. Development runs on an
+agent-driven loop — see **[agent/LOOP.md](agent/LOOP.md)**. Kept out of
+the README so this stays a focused entry point.

agent/BACKLOG.md

@@ -0,0 +1,254 @@
+# Backlog — the prioritized task queue
+
+The forward-looking half of the old docs/ROADMAP.md, reworked as a queue
+agents can execute. Detailed design notes and decision records stay in
+`docs/ROADMAP.md` (referenced as "ROADMAP § <item>"); this file is *what's
+next, in what order*.
+
+**Rules:**
+- Agents take the topmost actionable item (see LOOP.md). Finished items
+  are **deleted** here — the journal + git log are the record; durable
+  design notes get a ✓-entry in docs/ROADMAP.md if worth keeping.
+- Item numbers are **stable IDs** — never renumbered or reused. A gap in
+  the sequence means shipped (or dropped) work; new items take the next
+  free number regardless of tier.
+- Tags: `[blocked:hw]` needs real hardware (see HARDWARE-QUEUE.md) ·
+  `[human]` needs Bernardo · `[stuck]` two failed attempts, needs help ·
+  `[big]` must be split before starting.
+- Agents may append to **PROPOSED** and **Decisions** freely; only
+  Bernardo moves items *out* of PROPOSED into the tiers.
+
+---
+
+## NOW
+
+*Items 21–24: real-hardware QA findings from the Latitude 5410
+(Bernardo, 2026-07-04) — bugs found on metal outrank the queue.*
+
+### 21. Waybar crash on theme switch — no respawn
+Reported: after a theme switch on the Latitude, Waybar crashed and
+never came back (exec-once = no supervisor; a crash orphans the session
+until relogin). Two halves: (a) **resilience** — Waybar must respawn on
+crash regardless of cause. exec-once a small supervisor loop (restart
+with backoff; must not fight `pkill -x waybar` intentional stops), or
+re-attempt the systemd user unit with an IPC-readiness gate (the naive
+unit raced Hyprland IPC on relogin — see waybar.nix's comment). (b)
+**root cause** — the switch path both flips `style.css` (Waybar's
+`reload_style_on_change` picks it up) *and* sends SIGUSR2
+(`nomarchy-theme-sync`), a double-reload during the config/css symlink
+flip; suspect the race crashes Waybar's reload. Consider: drop the
+SIGUSR2 when `reload_style_on_change` is on, or replace reload with a
+clean restart on switch. **Verify:** V2 (kill waybar in the themed-VM
+recipe → respawns; switch theme → bar survives); V3 re-check on the
+Latitude.
+
+### 22. Network menu shows nameless/weird entries
+Reported: `networkmanager_dmenu` lists entries with no names (likely
+hidden-SSID APs rendered as blank rows, possibly other adapters/
+duplicate BSSIDs). Investigate its config.ini surface for filtering,
+or patch the list source; blank rows in a themed picker read as
+breakage. **Verify:** V1 (config renders) — behavior needs Wi-Fi
+hardware → V3 on the Latitude.
+
+### 23. `sys-rebuild` — rebuild without updating the lock
+Reported: there's no way to rebuild the system *without* `sys-update`'s
+`nix flake update` (home-update already skips the lock; the system side
+lacks the twin). Add `sys-rebuild` (snapshot-first like sys-update,
+rebuild against the current lock, no update) alongside `sys-update`;
+document both in README §5 + the motd cheat sheet if it lists them.
+**Verify:** V1 + eval that both scripts land on PATH.
+
+### 24. "Back" audit — every list menu ends in ↩ Back
+Reported: some submenu items/tools still lack a Back option. The "Back
+everywhere" pass covered the hand-rolled dmenu lists at the time; audit
+what's been added since (VPN, Display, power-profile, printers…) and
+the external/plugin modules (networkmanager_dmenu, rofi-pulse-select,
+rofi-calc/emoji modi) — hand-rolled lists get the shared `back` helper;
+external modi that can't take an injected row get documented as such
+(and Esc always works). **Verify:** V1 + a grep-the-generated-script
+audit listing which menus have/lack Back; V3 spot-check.
+
+### 6. Full docs review & restructure
+ROADMAP § Full docs review. The roadmap/backlog split is done (this
+file); remaining: reconcile every README option table against the live
+`nomarchy.*` surface; drift pass over docs/OVERRIDES.md, docs/TESTING.md,
+templates/downstream/README.md; read the install/first-run story end to
+end; add a short **recovery runbook** (desktop won't start → boot an
+older generation / `nomarchy-snapshots` / greetd journal — the pieces
+exist, the story isn't written). Site-vs-markdown is a Decision (below).
+**Verify:** V0 + a mechanical option-surface diff (eval the options,
+compare to the tables — consider making that a permanent check).
+
+## NEXT
+
+### 8. Complete-workstation viewers + default applications
+New. The template ships mpv but **no PDF viewer and no image viewer**,
+and nothing sets xdg-mime defaults — so "open a PDF/photo" falls to
+whatever GTK guesses (GIMP for images). Two halves: (a) add a themed,
+lightweight PDF viewer + image viewer to the template's active
+`home.packages` (candidates: zathura or GNOME Papers; imv or loupe —
+prefer what Stylix themes well); (b) a mime-defaults module setting
+`xdg.mimeApps` associations (browser/PDF/image/video/text, `mkDefault`)
+— real config, so unlike bare packages this *is* module territory, but
+it must degrade gracefully when the user deletes a package from the
+suite. **Verify:** V1 + assert the rendered mimeapps.list; V3 queue an
+open-a-file smoke.
+
+### 9. Update & rollback UX
+New; extends the update-awareness story to the other half: what changed,
+and how do I get back. (a) `sys-update` prints a human diff of what the
+update changed (`nvd diff` between system generations, or `nix store
+diff-closures`); (b) a **System → Rollback** menu flow: desktop = pick a
+recent `home-manager generations` entry and activate it (the theme
+history is already generations); system = point at the boot-menu
+generation flow + `nomarchy-snapshots` rather than reimplementing it —
+destructive steps keep the typed-`yes` gate. **Why:** informative +
+rock-stable means undo is one menu away, not a Nix lesson. **Verify:**
+V1; V2 for the generation-activate path in a VM.
+
+### 10. `nomarchy-doctor` — one-shot health check
+New. A single command (+ System-menu entry) that checks the things that
+actually break user machines and prints a themed pass/fail sheet:
+failed systemd units (system + user), disk space (/, /boot, the nix
+store), state-file parses + is git-tracked, downstream flake dirty/
+diverged, last rebuild generation age, snapper timeline running (when
+enabled). Read-only, no auto-fixing; each failure prints the one command
+that fixes it. Optionally later: a self-gating Waybar warning fed by the
+same script. **Verify:** V2 — a VM check with an induced failure.
+
+### 11. State-file validation & friendly errors
+New; "the user never has to master Nix" must include *error messages*.
+A hand-edited theme-state.json (trailing comma, wrong type, unknown
+theme slug) today surfaces as a raw Nix eval stack. Add (a) `nomarchy-
+theme-sync validate` + validate-before-write on every set/apply; (b) an
+eval-time schema assertion in `theme.nix` whose message says the field,
+the problem, and the fix in plain language. **Verify:** V1 + a corpus of
+broken-state fixtures round-tripped through validate; V2 if cheap.
+
+### 12. Screen recording in the Capture submenu
+New; screenshots ship, recording doesn't — a standard workstation need.
+Extend `nomarchy-menu capture`: record region/full → `wl-screenrec`
+(fallback `wf-recorder`), saved next to Screenshots, with a self-gating
+Waybar recording indicator that stops the recording on click (the only
+sane "stop" surface). Optional audio toggle. Parity rule applies.
+**Verify:** V1 + `bash -n`; V2 headless if the software-GL recipe
+supports it, else V3 queue.
+
+### 13. Small niceties batch (one slice per iteration)
+Each is a small, self-contained polish item in the existing patterns:
+- **Idle-inhibit (caffeine) toggle:** Waybar `idle_inhibitor` module
+  (blocks hypridle lock/suspend during video/presentations) in the
+  GENERATED bar — summer-night already has one (reverse parity gap
+  found 2026-07-04); add to summer-day too + cheatsheet mention.
+- **Low-battery notifications:** the bar colors at 25/10% but nothing
+  *notifies*; gate on `power.laptop` (poweralertd, or a small upower
+  watcher consistent with how the bar reads state).
+- **Color picker:** `hyprpicker` → clipboard as a Tools › entry +
+  `SUPER+CTRL` bind; pairs naturally with theme work.
+
+### 14. Automated upstream lock bumps (maintainer CI, slices b+c) `[big]`
+ROADMAP § Automated upstream lock bumps — the scheduled half (the
+checks-on-push workflow shipped; see item 20 for the runner status):
+weekly job runs `nix flake update` (within pinned release branches) →
+full check suite → lands on `main` on green; `v1` promotion stays
+human. Plus the fast-lane note for security bumps. Note the current
+runner is eval-only (no KVM) — a green bump run guards eval, not the VM
+suite, until item 20's stretch runner exists.
+
+### 20. KVM runner → VM suite in CI `[human]`
+The remaining stretch of the CI item — checks-on-push is live and
+**green** (run #58; runner = gitea/act_runner docker, eval tier).
+Register a second runner on a host with `/dev/kvm` + nix (host-mode
+label `nix-kvm`), then an agent uncomments the workflow's `vm-checks`
+job: the `checks.*` VM suite + real toplevel/HM builds on every push
+(also upgrades item 14's bump gate from eval-only to the full suite).
+
+### 15. Display profiles — docked/undocked switching
+ROADMAP § Display / monitor management, remaining: true profile
+switching of the *same* outputs (multi-layout toggles, beyond
+per-output hotplug rules), optionally workspace-to-monitor binding.
+Design first (state-file shape, menu surface) — write the plan into
+this entry before coding.
+
+### 16. Greeter theming from the JSON
+ROADMAP § Greeter. tuigreet themed from theme-state.json at system
+rebuild (same model as Plymouth's tint). Scope: tuigreet only (no SDDM).
+
+### 17. Launch-or-focus UX scripts
+ROADMAP § launch-or-focus. Hyprland dispatch scripts: a bind launches an
+app or focuses its existing window. Curate which apps get binds;
+cheatsheet entries via keybinds.nix.
+
+### 18. "nomarchy" control center + first-boot welcome `[big]`
+ROADMAP § control center. A single front-end over the common toggles on
+the same `nomarchy-theme-sync` surface, + a first-boot guided
+"pick your theme / essentials" flow. Needs a design pass (TUI vs GUI)
+→ write options into Decisions before implementing. Note: items 9–11
+(rollback menu, doctor, validation) are natural panels of it — design
+them as composable commands, not dead ends.
+
+### 19. Look & Feel menu category
+ROADMAP § Menu system, remaining: group Theme + night-light (+ wallpaper
+cycle, future appearance toggles) under a Look & Feel submenu once it
+earns ≥3 entries — keep the root at six.
+
+## LATER
+
+- **Wallpapers artifact split** (ROADMAP § Faster switches — decided,
+  deferred): pinned `Nomarchy-wallpapers` input so a state write stops
+  re-copying 86 MB. Follow-on: pre-built theme variants if switches are
+  still slow after.
+- **Installer round 2** (ROADMAP § Installer): multi-disk BTRFS RAID,
+  impermanence, BIOS/legacy boot.
+- **Boot-from-snapshot**: a systemd-boot equivalent of grub-btrfs.
+- **Night-light geo mode**: lat/long auto sunset/sunrise (means wlsunset).
+- **Per-theme icon overrides** / more icon packs (ROADMAP § Icon themes).
+- **MIPI/IPU software-ISP camera** support (no-UVC machines).
+- **OCR screenshot-to-text**: a Capture › entry (grim region → tesseract
+  → clipboard) — cheap once recording (#12) reshapes the submenu.
+- **Auto-timezone Waybar tooltip** showing the detected zone (optional).
+- **VPN exit-node richer display** (country/city) (optional).
+- **NixOS release bump → v2** `[human]`: deliberate, hand-edited, never
+  automated; the previous attempt was discarded (2026-06-22) over a
+  Hyprland OOM blocker — see MEMORY.md before retrying (NOW#3 should
+  also soften that blocker class).
+
+## PROPOSED (agent suggestions — await human triage)
+
+*Agents: append here with a one-paragraph pitch (what/why/cost). Do not
+implement. Bernardo moves accepted items into a tier.*
+
+- **Portal/Flatpak camera picker still lists the internal IR sensor**
+  (ROADMAP § Webcam follow-up). The shipped IR-hide is a *WirePlumber
+  v4l2* rule, but Flatpak/portal apps consume cameras via the
+  **libcamera** path, where both sensors remain visible — a Flatpak
+  Zoom user can still pick the black IR "camera". Options, roughly
+  ascending cost: (a) do nothing — document it (portal camera support
+  is still rare in practice); (b) a WirePlumber *libcamera* monitor
+  rule disabling GREY-only nodes — needs verifying that libcamera
+  monitor rules can match early enough (the v4l2 investigation found
+  only `device.api` binds pre-rule, which is why surgical scoping
+  failed before — same wall likely applies); (c) a libcamera
+  configuration/udev quirk hiding the IR sensor at the libcamera layer
+  itself. Cost: (b)/(c) need a T14s-style RGB+IR machine to verify →
+  pairs with a hardware-queue session. Recommend (a) now, (b)
+  investigated when the T14s is next available.
+
+## Decisions `[human]`
+
+Open calls only Bernardo can make; agents add options/evidence but never
+decide.
+
+- **Formatter adoption:** repo deliberately has none; `nixfmt-rfc-style`
+  would flatten the aligned hand-formatting of ~33 files. Adopt or
+  declare never?
+- **Docs site vs Markdown-in-repo** (from the docs-review item).
+- **Control center form factor:** TUI (gum/ratatui-style) vs GUI vs
+  "the rofi menu *is* the control center, just add a first-boot flow".
+- **zram swap:** faster under pressure and pairs with NOW#3, but it
+  interacts with the hibernation-swapfile story (resume device/priority
+  ordering) — adopt, adopt-with-hibernation-guard, or skip?
+- **Default browser:** the template comments Firefox out; item #8's mime
+  defaults need *something* to point `text/html` at — ship a browser
+  active in the suite, or leave browserless-by-default and let mime
+  defaults degrade?

agent/CONVENTIONS.md

@@ -0,0 +1,70 @@
+# Conventions — how Nomarchy code is written
+
+The standing rules an agent must follow while coding. GOALS.md says what
+we're building; this says how. Details/rationale live in docs/ROADMAP.md's
+decision records and the README.
+
+## Repo layout (the rule of thumb)
+`modules/` is the distro (reusable, no machine specifics) · `hosts/` is a
+machine · `themes/` is data · `pkgs/` is code · `tools/` is maintainer-only
+· `agent/` is loop state. If a new file doesn't obviously belong to one of
+those, it probably shouldn't exist.
+
+## Nix style
+- **No formatter.** Files use deliberate aligned hand-formatting — match
+  the surrounding style exactly; never reflow a file you're only touching
+  a line of.
+- Distro defaults use `lib.mkDefault` so a plain downstream assignment
+  wins; bind/exec lists concatenate. Behaviour options overridable,
+  appearance flows from the state JSON.
+- Options live in the existing surfaces: `nomarchy.system.*` /
+  `nomarchy.hardware.*` / `nomarchy.services.*` (NixOS, `system.nix`),
+  everything else `nomarchy.*` (HM, `home.nix`). Update the README tables
+  when the surface changes.
+
+## Feature design
+- **In-flake state:** any user-settable config gets a menu writer that
+  lands it in `theme-state.json` (`settings.*`), git-tracked. No
+  `~/.local/state`, no side files. Instant-effect where possible
+  (`--no-switch` + flip the service; the service reads the *live* working
+  tree at start — the night-light `ExecCondition` pattern). Rebuild-baked
+  values graduate via `mkDefault` reads of the settings key.
+- **Toggle vs package:** a `nomarchy.*` toggle only when there's real
+  config behind it (units, groups, udev, firewall). A bare package goes
+  in the downstream template's `home.packages` — opt-out is deleting the
+  line.
+- **Opt-in features** ship a commented example in
+  `templates/downstream/home.nix` or `system.nix`.
+- **Menu:** new entries go in the right submenu (Tools › / System ›; root
+  stays six entries), end lists with the shared `↩ Back`, self-gate on
+  the feature's availability, and add the direct
+  `SUPER+CTRL+<mnemonic>` bind in `keybinds.nix` (single source — it
+  feeds both Hyprland and the SUPER+? cheatsheet).
+- **Waybar:** new indicators self-gate (hidden when irrelevant), use
+  named `writeShellScriptBin`s on PATH (so static configs can exec them
+  by bare name), and are added to **both** the generated `waybar.nix`
+  config **and** the summer-day/night `waybar.jsonc` whole-swaps (the
+  parity rule).
+- **Theming:** every new visual surface consumes the palette from the
+  state JSON. There is no second renderer to keep in sync — add the key
+  to the JSON, consume it in the module.
+
+## Testing
+- docs/TESTING.md is canonical; LOOP.md's ladder (V0–V3) sets the
+  required tier. Cheap first: `nix flake check --no-build`, `bash -n`,
+  `py_compile`.
+- Prefer a permanent `checks.*` runNixOSTest over a one-off manual poke;
+  reusable recipes (headless Hyprland with software GL, QMP screenshots,
+  udev-event fakes) are indexed in MEMORY.md and demonstrated by the
+  existing checks (`distro-id`, `hardware-toggles`,
+  `battery-charge-limit`).
+- The honesty rule: report exactly what you verified and at which tier.
+
+## Git
+- `main` is development (direct commits, pushed); `v1` is the release
+  pointer — **human-only, fast-forward-only, never touched by agents**.
+- Commit style: `feat|fix|test|docs|chore(scope): summary`, body with
+  what/why + verification tier + what remains. Bookkeeping (`agent/`
+  updates) rides in the same commit as the change.
+- `flake.lock` moves only when the task *is* a lock bump, and only within
+  the pinned release branches.

agent/GOALS.md

@@ -0,0 +1,58 @@
+# Goals — what "done" looks like for Nomarchy
+
+The north star every loop iteration serves. When two options conflict,
+the earlier pillar wins.
+
+## The four pillars (in priority order)
+
+1. **Rock-stable.** A workstation you never fight. Everything is a NixOS/HM
+   generation — atomic, rollbackable, never partial. `nix flake check` is
+   green at every commit on `main`. Regressions are caught by the VM-test
+   suite (`checks.*`), not by users. `v1` only ever advances after human
+   on-hardware QA.
+2. **Reproducible, with zero hidden state.** The downstream flake checkout
+   *is* the machine. All user-settable config is menu-writable into the
+   git-tracked state file (`theme-state.json` `settings.*`) — never
+   `~/.local/state`, never `~/.config` side files. Re-cloning your flake
+   reproduces the machine, settings and all.
+3. **Effortless to configure.** The user never has to learn Nix. Every
+   common knob is reachable from `nomarchy-menu` (SUPER+M); the menu is an
+   ergonomic writer for the flake. Where a toggle can take effect without a
+   rebuild, it must (`--no-switch` + flip the running service).
+4. **Beautiful.** One JSON themes the entire desktop coherently — Hyprland,
+   Waybar, Ghostty, btop, rofi, GTK/Qt, boot splash, greeter. Every new
+   surface follows the palette. Informative, self-gating Waybar modules
+   (they hide when irrelevant). No unthemed corner survives contact with
+   the theme switcher.
+
+## Quality bars (non-negotiable)
+
+- **The honesty rule** (docs/TESTING.md): for anything visual, "the Nix
+  evaluates" is not "it renders". Verify at the highest tier you can reach
+  (see LOOP.md's verification ladder) and *state the tier you reached*.
+  Never claim a check you didn't run.
+- **Parity rule:** any module added to the generated Waybar config must
+  also be added to the summer-day/night `waybar.jsonc` whole-swaps.
+- **Menu placement:** new menu entries go in the right category submenu
+  (Tools › / System ›), with a direct `SUPER+CTRL+<mnemonic>` bind and
+  self-gating where applicable. The root picker stays six entries.
+- **Opt-in features** ship a commented example in
+  `templates/downstream/{home,system}.nix`.
+- **Option surface discipline:** a toggle exists only when there is real
+  config behind it. Bare package installs go in the template's
+  `home.packages` (opt-out = delete the line), never a `nomarchy.apps.*`.
+
+## Non-goals (do not drift into these)
+
+- **No binary cache.** Compile-from-source is a deliberate values call;
+  automation targets the config/lock channel, not artifact distribution.
+- **No second theming pipeline.** The dispatcher owns menu structure; the
+  renderer (rofi) stays swappable. No GTK4 launcher.
+- **No nixpkgs major bump on `main`.** Lock updates stay within the pinned
+  release branch; a release jump is a deliberate `v2`, hand-edited by the
+  maintainer (the last attempt was discarded over a Hyprland OOM — see
+  agent/MEMORY.md).
+- **No repo-wide reformat.** The `.nix` files use deliberate aligned
+  hand-formatting; adopting a formatter is an open maintainer decision
+  (BACKLOG.md § Decisions), not a cleanup.
+- **No multi-DE.** Hyprland is the desktop.

agent/HARDWARE-QUEUE.md

@@ -0,0 +1,85 @@
+# Hardware queue — V3 checks only a human can run
+
+Everything shipped at V1/V2 whose final verification needs real hardware.
+Agents **append** (newest at the bottom of a section) with exact steps;
+Bernardo runs them and either checks off (`[x]` + date + verdict) or files
+the failure as a NOW bug in BACKLOG.md. Machines: the **AMD dev box**
+(Ryzen AI laptop: AMD + fingerprint + NPU), the **Latitude 5410** (Intel
+QA machine), the **T14s** (webcam case).
+
+## Any machine (dev box is fine)
+- [ ] **Battery charge limit re-apply on unplug** — `sudo nixos-rebuild
+      switch` with `power.batteryChargeLimit = 80`, physically unplug/replug
+      AC, confirm `charge_control_end_threshold` re-reads 80. (udev trigger
+      already VM-verified.)
+- [ ] **SSH_AUTH_SOCK for GUI clients** — after relogin, launch a GUI git
+      client (or `rofi`-launched terminal-less app) and confirm it reaches
+      gpg-agent's SSH socket without an interactive shell parent.
+- [ ] **Night-light full cycle** — first menu enable rebuilds + hyprsunset
+      starts; later toggles are instant (no rebuild); an *off* survives
+      reboot (ExecCondition); stopping hyprsunset restores gamma.
+- [ ] **Auto-timezone** — enable from the menu; confirm geoclue finds the
+      zone, `/etc/localtime` updates, and the Waybar clock refreshes
+      (SIGUSR2 watcher) — also after a manual `timedatectl set-timezone`.
+- [ ] **Keyboard layout cycle bind** — with a comma layout (e.g.
+      `nomarchy.keyboard.layout = "us,de"`), SUPER+SHIFT+K cycles the
+      focused keyboard's layout, the Waybar `󰌌` indicator follows, and
+      the row shows in the SUPER+? cheatsheet.
+- [ ] **Keyboard hotplug picker (re-verify after in-flake graduation)** —
+      plug an external keyboard post-login, pick a layout in rofi, confirm
+      it applies per-device only, persists in `settings.keyboard.devices`,
+      and graduates into a `device{}` block on the next rebuild.
+- [ ] **Snapshots restore/rollback** — ⚠ PRECONDITION: update to main ≥
+      a47aa3a and RELOGIN first (the polkit agent starts with the session).
+      Bernardo's 2026-07-04 Latitude findings 5/6 ("btrfs-assistant still
+      crashes", "menu snapshots shows nothing") match the PRE-fix behavior
+      exactly: no agent → pkexec fails silently (= menu does nothing), and
+      a direct unprivileged run crashes (= the libbtrfsutil bug). If either
+      still reproduces ON THE FIXED BUILD after relogin, reopen BACKLOG
+      item 4 as [stuck]. Then: `nomarchy-menu snapshot` now opens
+      the **btrfs-assistant GUI**: a *themed* polkit prompt must appear
+      (hyprpolkitagent — first on-hardware outing) and the GUI must open
+      as root. Also exercise the fzf fallback in a terminal
+      (`sudo nomarchy-snapshots`): browse/diff, restore a file
+      (`undochange`), and a root-config rollback behind the typed-`yes`
+      gate. Bonus check: any other pkexec flow now prompts instead of
+      silently failing.
+- [ ] **Update awareness** — with `nomarchy.updates.enable`, let the timer
+      fire (or start the unit): indicator appears only when inputs are
+      behind, notification only on count growth, click opens the upgrade
+      flow.
+- [ ] **VPN menu live paths** — import a real WireGuard `.conf` and an
+      `.ovpn` via System → VPN, toggle up/down (● / ○ state), and the
+      Tailscale block: up/down + exit-node without sudo (operator grant).
+- [ ] **Printer menu** — with `nomarchy.services.printing`, System →
+      Printers opens system-config-printer; add a printer, test page.
+- [ ] **GRUB UEFI ISO theme render** — boot the ISO on UEFI hardware:
+      composed splash background, palette menu in the lower third, accent
+      timeout bar.
+- [ ] **Visual theme pass** — live ISO: all six identity themes (bars) +
+      the four authored rofi `.rasi` (nord/retro-82/lumon/kanagawa) look
+      right, not just parse.
+- [ ] **Auto-commit on a real machine** — System › Auto-commit toggles on
+      (row shows state, notification fires); a theme apply from SUPER+T then
+      shows a `nomarchy: apply theme …` commit in `~/.nomarchy` (`git log`);
+      unrelated dirty files in the checkout stay uncommitted; toggle off is
+      itself the last commit. Also: the "Auto timezone (on/off)" row label
+      now reflects the real state (the `= true` comparison fix).
+
+## AMD dev box only
+- [ ] **AMD runtime bits** — VA-API (`vainfo` → radeonsi), amd-pstate EPP
+      active and PPD switching governors; opt-ins: ROCm (`rocminfo`, a GPU
+      PyTorch/Ollama smoke) and the XDNA NPU driver loading.
+- [ ] **Fingerprint** — `fprintd-enroll` + (opt-in PAM) login/sudo.
+
+## Latitude 5410 only
+- [ ] **Media keys + gestures** (from dccceb4) — volume/brightness keys
+      drive the OSD; touchpad gestures work.
+- [ ] **v1 QA batch on-hardware pass** (583708d batch was QEMU-verified) —
+      general smoke before the next `main → v1` promotion.
+
+## T14s only
+- [ ] **Webcam IR-hide end-to-end on Nomarchy** — installer detects the
+      RGB+IR pair, bakes `hardware.camera.hideIrSensor`; `wpctl status`
+      shows one colour source; an app picker lists one camera; Howdy-style
+      direct `/dev/video2` reads still work.

agent/JOURNAL.md

@@ -0,0 +1,179 @@
+# Journal — append-only iteration log
+
+One entry per iteration, **newest first**. This is the loop's short-term
+memory: the next session reads the last 3–5 entries to orient. Keep an
+entry under ~15 lines; durable lessons go to MEMORY.md, not here.
+
+Template:
+
+```markdown
+## YYYY-MM-DD — <task title> (<commit sha, or "no commit">)
+- **Task:** which BACKLOG item (or QA sweep / bootstrap / escalation)
+- **Did:** what changed, in 2–4 lines
+- **Verified:** tier reached (V0/V1/V2) + the actual commands/checks run
+- **Pending:** V3 queued? follow-ups filed? anything [stuck]?
+- **Next suggestion:** what the following iteration should probably take
+```
+
+---
+
+## 2026-07-04 — Keyboard cycle bind + parity (iteration #6) + Latitude triage
+- **Task:** BACKLOG NOW#5; mid-iteration Bernardo delivered Latitude
+  5410 hardware-QA findings (the machine got a real session!).
+- **Did:** `multiLayoutBinds` in keybinds.nix (SUPER+SHIFT+K →
+  `switchxkblayout current next`), gated in hyprland.nix AND the rofi
+  cheatsheet on the same comma-in-layout condition; `hyprland/language`
+  + `#language` CSS added to both summer whole-swaps (shows even
+  single-layout there — static JSON can't gate; deliberate). Reverse
+  parity gap found (summer-night has idle_inhibitor, generated bar
+  doesn't) → folded into item 13. **Triage:** four new NOW items from
+  hardware: #21 Waybar crash on theme switch + no respawn (top),
+  #22 nameless network-menu entries, #23 `sys-rebuild` (no-update
+  rebuild), #24 Back-everywhere audit.
+- **Verified:** V0 (JSON + flake check) + V1 both directions
+  (single-layout build: no bind; `us,de` via extendModules: bind + the
+  cheatsheet row render; summer JSONs parse).
+- **Pending:** V3 cycle-bind check queued; items 21/22/24 carry V3
+  re-checks on the Latitude.
+- **Next suggestion:** #21 (waybar crash — stability pillar, user-hit).
+
+## 2026-07-04 — Webcam follow-ups (loop iteration #5, quick item)
+- **Task:** BACKLOG NOW#7 (Bernardo asked for "a quick item").
+- **Did:** template `home.packages` gains a commented "Webcam tuning"
+  pair (cameractrls GUI, v4l-utils CLI — bare packages, so template not
+  toggle, per the option-surface rule); the portal/Flatpak libcamera IR
+  gap is written up as a PROPOSED item with three options (recommend:
+  document-only now, libcamera-rule investigation when the T14s is
+  available). CI runs #60/#61 confirmed green (earlyoom + snapshot fix).
+- **Verified:** V0 (flake check — template evals through mkFlake;
+  changes are comments + agent docs).
+- **Next suggestion:** NOW#5 (keyboard cycle bind + summer parity) —
+  the last code item in NOW besides the docs pass.
+
+## 2026-07-04 — Snapshot GUI un-broken + polkit agent (loop iteration #4)
+- **Task:** BACKLOG NOW#4 — btrfs-assistant segfault.
+- **Did:** re-diagnosed instead of overriding. gdb: crash is in
+  libbtrfsutil's *unprivileged* subvolume iteration (btrfs-progs 6.17.1;
+  upstream fix `886571653` post-6.17.1; symbol versions verified — not
+  ABI drift). VM A/B: root works (exit 0), user crashes (139). The
+  launcher runs it as root → GUI fine *if* pkexec can prompt — and the
+  distro shipped **no polkit agent** (all pkexec silently failed; the
+  actual root cause of "GUI is dead"). Shipped: hyprpolkitagent
+  (exec-once, Stylix-themed Qt), menu re-pointed to the launcher with
+  the fzf flow as fallback, `checks.snapshot-gui` canary (root path +
+  offscreen event loop on real btrfs). No btrfs-progs patch — root-side
+  flows don't hit the bug; the fix arrives with a lock bump.
+- **Verified:** V0 + V2 (snapshot-gui check, run for real) + V1 (HM
+  generation renders the agent exec-once; menu bash -n).
+- **Pending:** V3 queued — first on-hardware themed polkit prompt.
+- **Next suggestion:** NOW#5 (keyboard cycle bind + summer parity).
+
+## 2026-07-04 — CI is green (run #58) — item 20 main half closed
+- **Task:** monitor follow-up, no code. Run #58 (the .gitea path fix)
+  **succeeded** — first green CI: the container recipe works on the
+  live runner, eval tier confirmed end to end.
+- **Did:** BACKLOG item 20 reduced to its stretch (KVM runner → enable
+  vm-checks), moved to NEXT. Run #59 (earlyoom push) monitored.
+- **Next suggestion:** NOW#4 (btrfs-assistant override attempt).
+
+## 2026-07-04 — Memory-pressure protection shipped (loop iteration #3)
+- **Task:** BACKLOG NOW#3 — default-on userspace OOM killer.
+- **Did:** `modules/nixos/oom.nix`: earlyoom (mkDefault on, desktop
+  notifications, session-plumbing `--avoid` list, no `--prefer`) +
+  `systemd.oomd.enable = false`. Choice rationale: Hyprland session is
+  one cgroup scope → oomd's cgroup-level kill would nuke the desktop;
+  earlyoom is process-level. Found en route: nixpkgs default-enables
+  oomd *inert* (enable=true, all slice toggles false). README "beyond
+  the surface" note added.
+- **Verified:** V0 (flake check) + **V2** — new `checks.oom-protection`
+  runNixOSTest, run for real: hog (chunked allocator, 686 MB peak in a
+  1 GB VM) SIGTERM'd by earlyoom in 0.1 s, bystander unit survived,
+  oomd asserted inactive. 25 s test, cheap enough for the suite.
+- **Pending:** nothing hardware-specific (behavior fully VM-provable).
+- **Next suggestion:** NOW#4 (btrfs-assistant override attempt). Also:
+  CI run #58 (the .gitea fix) was *running* at commit time — check its
+  outcome next tick; this push triggers #59.
+
+## 2026-07-04 — CI fix: wrong workflow dir (correction to iteration #2)
+- **Task:** Bernardo reported no run despite an active runner + shared
+  his compose file: the server is **Gitea** (gitea/act_runner), not
+  Forgejo — I'd shipped the workflow to `.forgejo/workflows/`, which
+  Gitea never reads. The legacy repo's `.gitea/workflows/` path was the
+  clue I under-weighted.
+- **Did:** `git mv` → `.gitea/workflows/check.yml`; corrected the
+  Forgejo references in the workflow header, TESTING.md §1b, BACKLOG
+  item 20 (now: watch the first run; runner was never the problem);
+  MEMORY.md gains the Gitea-not-Forgejo line.
+- **Verified:** the push of this commit is itself the test — the run
+  must appear; monitoring.
+- **Pending:** first green run (item 20); runner-container memory
+  headroom is the watch-out.
+
+## 2026-07-04 — CI checks-on-push shipped (loop iteration #2)
+- **Task:** BACKLOG NOW#2 — Forgejo Actions workflow.
+- **Did:** `.forgejo/workflows/check.yml` (push to main/v1 + dispatch):
+  flake check --no-build, theme-sync py_compile, bash -n over tracked
+  .sh. Scoped to the **eval tier** deliberately — API probing +
+  archaeology of the legacy `.gitea/workflows/check.yml` (57 runs on
+  this instance) showed the runner is an act_runner docker container
+  (no KVM/systemd), so the VM suite can't run there; a commented
+  `vm-checks` job documents the KVM-runner upgrade path. Legacy's
+  hard-won container gotchas (nixbld setup, sandbox=false for Stylix
+  IFD, Nix 2.31.5 pin) carried over verbatim. TESTING.md §1b added.
+- **Verified:** V0 locally (same commands the workflow runs, minus the
+  container Nix install) + yq YAML parse. The real green run needs the
+  runner to be alive — **not confirmable from here** (runners API is
+  401 unauthenticated); watching the run after push.
+- **Pending:** new `[human]` item 20 — confirm/re-register the runner;
+  stretch: a KVM runner unlocks the vm-checks job.
+- **Next suggestion:** NOW#3 (memory-pressure protection).
+
+## 2026-07-04 — Opt-in auto-commit shipped (loop iteration #1)
+- **Task:** BACKLOG NOW#1 — auto-commit of state mutations (in-flake
+  state Phase 4). First autonomous /loop iteration.
+- **Did:** `settings.autoCommit` live-read by nomarchy-theme-sync;
+  pathspec-limited commit of theme-state.json on apply/set (fires if flag
+  on before OR after the write → the off-toggle commits too); identity
+  fallback; same-value no-op; `bg` excluded. Menu: System › Auto-commit
+  (instant, self-gated on `.git`). Rider: `get` prints booleans as JSON
+  `true`/`false`, fixing the stuck "Auto timezone (on/off)" menu label.
+  BACKLOG numbering switched to stable IDs (no renumbering).
+- **Verified:** V0 (py_compile, flake check) + V1 (HM generation builds;
+  generated menu `bash -n`) + a 7-assertion sandbox git-repo round-trip
+  (enable/set/same-value/disable/post-disable/apply/identity-fallback).
+- **Pending:** V3 queued in HARDWARE-QUEUE (on-machine toggle + apply).
+- **Next suggestion:** NOW#2 (CI checks-on-push) — but its runner half
+  may need Bernardo to register a Forgejo runner; deliver the workflow
+  regardless.
+
+## 2026-07-04 — Backlog revision pass (human-requested)
+- **Task:** Bernardo asked for a philosophy-aligned revision of BACKLOG.md
+  ("I'm sure I'm forgetting important items").
+- **Did:** verified guessed gaps against the tree first (GC/optimise/boot
+  limit + all 21 previews already ship — dropped those ideas). Added the
+  confirmed gaps: CI-on-push promoted to NOW#2 (agents push to main now),
+  memory-pressure protection NOW#3 (nothing mitigates OOM; the release
+  bump died to one), viewers+mime defaults #8, update/rollback UX #9,
+  nomarchy-doctor #10, state-file validation #11, screen recording #12,
+  niceties batch #13 (idle-inhibit, low-battery notify, hyprpicker), OCR
+  in LATER; recovery runbook folded into the docs item; zram + default
+  browser added to Decisions.
+- **Verified:** V0 (docs-only).
+- **Pending:** Bernardo to sanity-check the new NOW ordering, esp. CI at
+  #2 and the two new Decisions.
+- **Next suggestion:** unchanged — NOW#1 (opt-in auto-commit).
+
+## 2026-07-04 — Bootstrap the loop infrastructure (this commit)
+- **Task:** create `agent/` (human-requested): LOOP/GOALS/BACKLOG/
+  CONVENTIONS/MEMORY/HARDWARE-QUEUE/JOURNAL, root CLAUDE.md, README +
+  ROADMAP pointers.
+- **Did:** reworked the forward half of docs/ROADMAP.md into the tiered
+  BACKLOG (5 NOW / 6 NEXT / LATER / Decisions); collected every pending
+  on-hardware check into HARDWARE-QUEUE.md; seeded MEMORY.md from the
+  ROADMAP's decision records.
+- **Verified:** V0 (docs-only change; `nix flake check --no-build` run to
+  confirm the tree still evaluates).
+- **Pending:** Bernardo to sanity-read GOALS.md pillars + BACKLOG tiering
+  — reorder freely, the order *is* the instruction.
+- **Next suggestion:** BACKLOG NOW#1 (opt-in auto-commit — Phase 4 of
+  in-flake state, already the agreed next step).

agent/LOOP.md

@@ -0,0 +1,118 @@
+# The loop — autonomous iteration protocol
+
+How an AI agent works on Nomarchy unattended. One **iteration** = pick one
+task, do it, verify it, commit it, record it. The protocol is
+runner-agnostic; the same iteration works under any of:
+
+- **Interactive `/loop`** in a Claude Code session in this repo — the agent
+  self-paces iterations until stopped.
+- **Headless** (`claude -p`, cron/systemd-timer) — one invocation runs one
+  iteration (or a small fixed number) and exits.
+- **A fresh manual session** — a human says "do a loop iteration"; the
+  files below carry all the state, so any session can pick up where the
+  last left off.
+
+All loop state lives in this directory, git-tracked. There is no state
+outside the checkout (the distro's own philosophy, applied to its agents).
+
+## The files
+
+| File | Role | Who writes it |
+|---|---|---|
+| `GOALS.md` | North star + quality bars + non-goals | Human (agents propose edits) |
+| `BACKLOG.md` | Prioritized task queue (NOW/NEXT/LATER/PROPOSED/DECISIONS) | Both — see its header rules |
+| `JOURNAL.md` | Append-only iteration log | Agents |
+| `MEMORY.md` | Curated durable lessons/gotchas | Agents (curated, not append-only) |
+| `HARDWARE-QUEUE.md` | Pending on-hardware checks only Bernardo can run | Agents append, human checks off |
+| `CONVENTIONS.md` | Repo/design conventions to follow while coding | Human (agents propose edits) |
+
+## One iteration, step by step
+
+### 0. Orient
+1. Read `GOALS.md`, `CONVENTIONS.md`, `MEMORY.md`, the **last 3–5 entries**
+   of `JOURNAL.md`, and `BACKLOG.md`.
+2. `git pull --ff-only` (skip silently if offline). Confirm you are on
+   `main` with a clean tree. **A dirty tree you didn't create → stop and
+   report; never stash or discard someone else's work.**
+3. Sanity baseline: if the last journal entry reports a red
+   `nix flake check`, or you have any reason to suspect breakage, run
+   `nix flake check --no-build` first. **A red baseline preempts the
+   backlog — fixing it *is* this iteration's task.**
+
+### 1. Pick exactly one task
+- Take the **topmost actionable** item: NOW before NEXT; never LATER
+  unless NOW and NEXT are empty or all blocked.
+- *Actionable* means: not `[blocked:hw]` (those wait in
+  `HARDWARE-QUEUE.md`), not `[human]` (decisions), and small enough to
+  finish + verify in one iteration. If the top item is too big, **split
+  it in BACKLOG.md** (that edit is part of the iteration) and take the
+  first slice.
+- Never implement anything from **PROPOSED** — those await human triage.
+- If nothing is actionable, do a **QA sweep** instead: run the full check
+  suite, hunt drift (README option tables vs the live `nomarchy.*`
+  surface, template drift, dead code), deepen a VM test, or research and
+  write up a PROPOSED item. An iteration that only improves the backlog
+  is a valid iteration. If even that yields nothing, journal it and stop
+  — do not manufacture churn.
+
+### 2. Work
+- Keep the diff focused on the task. Unrelated fixes you trip over become
+  PROPOSED/NOW entries, not scope creep.
+- Follow `CONVENTIONS.md`. Match the surrounding hand-formatting; never
+  run a formatter.
+- New gotcha discovered the hard way → one line in `MEMORY.md` now, while
+  it's fresh.
+
+### 3. Verify — the ladder
+Climb as high as the change warrants and your environment allows; **record
+the tier reached** in the commit body and journal entry.
+
+| Tier | What | When required |
+|---|---|---|
+| **V0** | `nix flake check --no-build` (+ `bash -n` / `py_compile` for scripts) | Every change, no exceptions |
+| **V1** | Build the touched output: `system.build.toplevel`, the HM generation, the ISO, or the package | Anything beyond docs/comments |
+| **V2** | VM: a `checks.*` runNixOSTest (add one if the change is guardable), or boot `tools/test-live-iso.sh` / `tools/test-install.sh` | Behavioral changes — services, boot, installer, session |
+| **V3** | Real hardware | Cannot be done by the agent → append to `HARDWARE-QUEUE.md` with exact test steps |
+
+The honesty rule governs: a visual/interactive change verified only to V1
+is **not done** — it ships as "V1-verified, V2/V3 pending" with the pending
+check queued. Prefer *adding a permanent `checks.*` test* over a one-off
+manual VM poke when the behavior is testable headlessly (see MEMORY.md for
+the reusable recipes).
+
+### 4. Commit + push
+- Style: match the log — `feat(scope): …`, `fix(scope): …`,
+  `test(scope): …`, `docs(scope): …`. Body explains what/why + the
+  verification tier reached and what remains.
+- Include the `agent/` bookkeeping updates (backlog/journal/memory/queue)
+  **in the same commit** as the change they describe.
+- Commit directly on `main` and `git push` (Bernardo's standing workflow).
+- **Never:** force-push; touch the `v1` branch or any branch/tag you
+  didn't create; commit secrets or binaries; run `nix flake update`
+  unless the task is explicitly a lock bump; delete themes, wallpapers,
+  or user-facing assets without the backlog saying so.
+
+### 5. Record
+1. Mark the task in `BACKLOG.md` (move to its ✓ line or delete, per that
+   file's rules).
+2. Append a `JOURNAL.md` entry (template in that file).
+3. Queue any V3 checks in `HARDWARE-QUEUE.md`.
+
+### 6. Pace (self-paced runners only)
+Under `/loop`, continue to the next iteration while tasks remain
+actionable and checks stay green. Stop the loop when: nothing is
+actionable, the same task has failed twice (journal the failure analysis
+and mark the item `[stuck]`), or a `[human]` decision blocks everything
+remaining.
+
+## Stop-and-escalate conditions (any runner)
+
+Write a journal entry + a BACKLOG note, then stop, when:
+- A fix would require touching `v1`, force-pushing, or a nixpkgs release
+  jump.
+- The working tree contains uncommitted work you didn't create.
+- A task turns out to need a design decision Bernardo hasn't made → move
+  it to **Decisions** in BACKLOG.md with the options laid out.
+- Two consecutive iterations failed on the same task (`[stuck]`).
+- Anything would delete or rewrite user data, git history, or the state
+  file schema in a non-backward-compatible way.

agent/MEMORY.md

@@ -0,0 +1,73 @@
+# Memory — durable lessons, learned the hard way
+
+Curated, not append-only: one line per fact, newest at the top of its
+section; delete entries that stop being true. Details usually live in a
+docs/ROADMAP.md decision record — pointer given as (§ item). Add a fact
+here the moment a debugging session teaches you something a future
+iteration would otherwise rediscover.
+
+## Testing & VM recipes
+- CI (`.gitea/workflows/check.yml`) is **eval-tier only**: the act_runner
+  is a docker container (no systemd, no /dev/kvm). Container gotchas are
+  documented in the workflow header (single-user Nix + nixbld users,
+  `sandbox=false` for Stylix IFD, Nix pinned 2.31.5 vs lazy-trees, no JS
+  actions past node20) — learned over the legacy repo's 57 runs; read
+  them before touching the workflow.
+- The git server is **Gitea** (gitea/act_runner via docker-compose), NOT
+  Forgejo — workflows are read from `.gitea/workflows/` (or `.github/`),
+  never `.forgejo/workflows/` (a whole push cycle was lost to that).
+- Reusable headless VM harness: `checks.*` via runNixOSTest — existing
+  examples to crib from: `distro-id` (boots + `switch-to-configuration
+  dry-activate`), `hardware-toggles` (kernel cmdline/PAM assertions),
+  `battery-charge-limit` (fake Mains adapter via `test_power`, real udev
+  uevent, `InvocationID` change proves the restart).
+- Themed-desktop screenshots work headlessly: software-GL Hyprland
+  (`LIBGL_ALWAYS_SOFTWARE` on virtio-gpu) + `machine.screenshot()` QMP
+  dump — prototyped 2026-06-19, kept as the fallback for theme previews
+  (§ Visual theme picker).
+- Hyprland/Ghostty need guest GL (`virtio-vga-gl`, `gl=on`) in
+  interactive QEMU or the session won't start; black screen ≈ missing GL
+  (docs/TESTING.md § gotchas).
+- No KVM = slow, not broken; don't read slowness as failure.
+
+## Known-broken / watchlist
+- **btrfs-assistant "segfault" was unprivileged-only** (re-diagnosed
+  2026-07-04): libbtrfsutil's unprivileged subvolume iteration crashes on
+  btrfs-progs 6.17.1 (upstream-fixed after); **as root it works**, and the
+  pkexec launcher runs it as root. The real distro bug was **no polkit
+  agent in the session** (every pkexec failed silently) — hyprpolkitagent
+  now ships (hyprland.nix exec-once). `checks.snapshot-gui` guards the
+  root path. Lesson: before "app X is broken", check WHO it runs as — and
+  whether polkit prompts can render at all (§ Snapshot browse/restore).
+- **NixOS release bump is a trap:** the discarded attempt
+  (branch deleted 2026-06-22) hit a Hyprland OOM blocker; a redo is a
+  deliberate `v2`, never part of routine lock bumps.
+- `theme-state.json` is git-tracked inside an 86 MB flake tree, so every
+  state write re-copies the source before eval — the wallpapers-artifact
+  split (BACKLOG LATER) is the decided fix (§ Faster switches).
+
+## Gotchas (cost a debugging session once)
+- Never kill a Wayland session-lock client (hyprlock): its crash
+  failsafe drops to a tty instead of unlocking (§ Hibernate
+  double-unlock).
+- rofi `element-icon size` is one value = a square cell; `WxH` silently
+  collapses and non-square icons letterbox — pre-crop images square at
+  build (§ Visual theme picker).
+- WirePlumber 0.5 monitor rules can only early-match `device.api`;
+  `device.product.name` etc. bind *after* the rule runs — surgical
+  libcamera scoping is impossible (§ Webcam).
+- `hyprctl switchxkblayout` is a *global* layout flip; per-device isolation
+  needs `device[<name>]:kb_layout` keywords (§ Keyboard layouts).
+- Waybar's clock captures the timezone at construction — a zone change
+  needs SIGUSR2 (watcher in `timezone.nix`) (§ Automatic timezone).
+- Waybar `persistent_workspaces` (underscore) is dead syntax silently
+  ignored; the hyphen form is honoured and renders phantom workspaces
+  (§ Waybar shows non-existent workspaces).
+- GTK4/libadwaita/Qt6 read light/dark from the portal's
+  `org.freedesktop.appearance color-scheme` (dconf), not Stylix polarity
+  (§ GTK/Qt ignore the theme's mode).
+- Update order matters downstream: `sys-update` (lock) before
+  `home-update`, or desktop changes are silently skipped against the old
+  lock (README § 3).
+- grub `loadfont`s every `.pf2` in a theme dir — reuse a bundled DejaVu
+  rather than shipping fonts (§ Distro branding).

bin/utils/nomarchy-docs-keybindings

@@ -1,109 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# nomarchy-docs-keybindings
-#
-# Regenerates docs/KEYBINDINGS.md from the Hyprland binding files. Run from the
-# repo root or anywhere — paths are resolved relative to this script.
-#
-#   nomarchy-docs-keybindings                       # write to stdout
-#   nomarchy-docs-keybindings --out docs/KEYBINDINGS.md
-#
-# Source files in render order. Each entry is "<repo-relative path>|<title>".
-
-repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
-
-sources=(
-  "core/home/config/nomarchy/default/hypr/bindings/utilities.conf|Utilities"
-  "core/home/config/nomarchy/default/hypr/bindings/tiling-v2.conf|Tiling"
-  "core/home/config/nomarchy/default/hypr/bindings/clipboard.conf|Clipboard"
-  "core/home/config/nomarchy/default/hypr/bindings/media.conf|Media keys"
-  "features/desktop/hyprland/config/bindings.conf|Apps & web shortcuts"
-)
-
-prettify_key() {
-  case "$1" in
-    code:10) echo "1" ;; code:11) echo "2" ;; code:12) echo "3" ;;
-    code:13) echo "4" ;; code:14) echo "5" ;; code:15) echo "6" ;;
-    code:16) echo "7" ;; code:17) echo "8" ;; code:18) echo "9" ;;
-    code:19) echo "0" ;;
-    XF86AudioRaiseVolume)   echo "Volume Up" ;;
-    XF86AudioLowerVolume)   echo "Volume Down" ;;
-    XF86AudioMute)          echo "Mute" ;;
-    XF86AudioMicMute)       echo "Mic Mute" ;;
-    XF86AudioPlay)          echo "Play/Pause" ;;
-    XF86AudioStop)          echo "Stop" ;;
-    XF86AudioNext)          echo "Next Track" ;;
-    XF86AudioPrev)          echo "Previous Track" ;;
-    XF86MonBrightnessUp)    echo "Brightness Up" ;;
-    XF86MonBrightnessDown)  echo "Brightness Down" ;;
-    XF86KbdBrightnessUp)    echo "Kbd Brightness Up" ;;
-    XF86KbdBrightnessDown)  echo "Kbd Brightness Down" ;;
-    XF86KbdLightOnOff)      echo "Kbd Backlight" ;;
-    *) echo "$1" ;;
-  esac
-}
-
-trim() { sed -E 's/^[[:space:]]+//; s/[[:space:]]+$//'; }
-
-render_section() {
-  local file="$1" title="$2"
-  [[ ! -f "$repo_root/$file" ]] && return
-  local rows
-  rows=$(grep -E '^[[:space:]]*bind[a-z]*[[:space:]]*=' "$repo_root/$file" || true)
-  [[ -z "$rows" ]] && return
-
-  local body=""
-  while IFS= read -r line; do
-    # Strip the "bindXXX =" prefix.
-    local rhs="${line#*=}"
-    local mods key desc
-    IFS=',' read -r mods key desc _ <<<"$rhs"
-    mods=$(printf '%s' "${mods:-}" | trim)
-    key=$(printf '%s'  "${key:-}"  | trim)
-    desc=$(printf '%s' "${desc:-}" | trim)
-    [[ -z "$desc" ]] && continue          # skip non-descriptive bindings
-    [[ -z "$mods" ]] && mods="—"
-    key=$(prettify_key "$key")
-    body+=$(printf '| %s | %s | %s |\n' "$mods" "$key" "$desc")
-    body+=$'\n'
-  done <<<"$rows"
-
-  [[ -z "$body" ]] && return
-
-  printf '\n## %s\n\n' "$title"
-  printf '_Source: `%s`_\n\n' "$file"
-  printf '| Modifiers | Key | Action |\n'
-  printf '| --- | --- | --- |\n'
-  printf '%s' "$body"
-}
-
-main() {
-  cat <<'HEADER'
-# Nomarchy Keybindings
-
-Auto-generated from the Hyprland binding files. **Do not edit by hand.**
-Re-run the generator after changing any `bindings/*.conf`:
-
-```bash
-./bin/utils/nomarchy-docs-keybindings --out docs/KEYBINDINGS.md
-```
-
-`SUPER` is the Meta / Win key. `code:NN` keys (X11 digit keycodes) are
-shown as the digit they correspond to. Media keys (`XF86Audio*`,
-`XF86MonBrightness*`, …) are prettified.
-HEADER
-  for entry in "${sources[@]}"; do
-    render_section "${entry%|*}" "${entry#*|}"
-  done
-}
-
-out=""
-if [[ "${1:-}" == "--out" ]]; then
-  out="${2:?--out needs a path}"; shift 2
-fi
-if [[ -n "$out" ]]; then
-  main >"$out"
-else
-  main
-fi

bin/utils/nomarchy-docs-scripts

@@ -1,288 +0,0 @@
-#!/usr/bin/env bash
-# Generator tolerates "no matches" exit codes from grep | sort.
-# pipefail and -e off; -u stays.
-set -u
-
-# Deterministic collation regardless of the caller's locale. Without this
-# `sort` orders rows and caller lists by the ambient LC_COLLATE (UTF-8 on a
-# dev box, C in the CI container), so the committed doc and CI's regenerated
-# copy disagree on ordering and the drift check fails on pure noise.
-export LC_ALL=C
-
-# nomarchy-docs-scripts
-#
-# Regenerates docs/SCRIPTS.md from the repo state. Produces:
-#   1. Header + status legend + regen instructions.
-#   2. Table of every nomarchy-* script (location, callers, status).
-#   3. Table of every menu entry in features/scripts/utils/nomarchy-menu
-#      (submenu, label, target command, status).
-#   4. Snapshot list of orphaned references (called somewhere, no script).
-#
-# Status heuristic in Phase A:
-#   kept     — file exists AND is called from at least one *.nix / *.conf /
-#              shell file outside its own directory.
-#   unused?  — file exists but no caller found. Phase B decides delete-dead
-#              vs intentional public API.
-#   missing  — referenced but no file. Phase B decides port-from-omarchy
-#              vs delete-dead vs stub-with-notify.
-#
-#   nomarchy-docs-scripts                       # write to stdout
-#   nomarchy-docs-scripts --out docs/SCRIPTS.md
-
-repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
-cd "$repo_root"
-
-# --- Inventory -------------------------------------------------------------
-
-# Where scripts live, in render order.
-declare -A loc_label=(
-  ["features/scripts/utils"]="features/scripts/utils"
-  ["core/system/scripts"]="core/system/scripts"
-  ["themes/engine/scripts"]="themes/engine/scripts"
-)
-script_dirs=(features/scripts/utils core/system/scripts themes/engine/scripts)
-
-# Build name → location map (associative array of basename → repo-relative dir).
-declare -A script_loc
-for dir in "${script_dirs[@]}"; do
-  [[ -d "$dir" ]] || continue
-  while IFS= read -r f; do
-    script_loc["$(basename "$f")"]="$dir"
-  done < <(find "$dir" -maxdepth 1 -type f -name 'nomarchy-*')
-done
-
-# Find every nomarchy-* token referenced anywhere outside the script dirs.
-# (We exclude the script files themselves so they don't list themselves as
-# their own caller.)
-# File types we search for references. *.md catches docs and README;
-# branding/hook/extension files have varied or no extensions.
-# *.lua catches elephant providers; *.ini catches mako on-button-* hooks;
-# *.desktop catches MimeType-registered URL handlers.
-grep_includes=(
-  --include='*.nix' --include='*.conf' --include='*.sh' --include='*.md'
-  --include='nomarchy-*' --include='*.jsonc' --include='*.json'
-  --include='*.toml' --include='*.ini' --include='*.lua'
-  --include='*.desktop' --include='*.txt' --include='*.sample'
-)
-search_dirs=(core features themes installer hosts bin lib README.md)
-
-# Files whose mentions of nomarchy-* are documentation about the scripts,
-# not real callers. Excluded from caller discovery so they don't promote
-# every script to `kept`.
-self_refs=(docs/SCRIPTS.md docs/ROADMAP.md docs/AGENT.md)
-
-ref_files_per_cmd() {
-  local cmd="$1"
-  local self_pattern
-  self_pattern=$(IFS='|'; echo "${self_refs[*]}")
-  grep -rlE "\\b${cmd}\\b" \
-    "${grep_includes[@]}" \
-    "${search_dirs[@]}" 2>/dev/null \
-    | grep -vE "^(features/scripts/utils|core/system/scripts|themes/engine/scripts)/${cmd}$" \
-    | grep -vE "^(${self_pattern})$" \
-    | sort -u
-}
-
-# All distinct nomarchy-* tokens we see anywhere in the repo.
-# Final char must be alphanumeric — dropping trailing-dash matches like
-# `nomarchy-pkg-` that come from glob references (`for c in nomarchy-pkg-*`).
-# Restrict to grep_includes so binaries / tmpfiles don't pollute the set.
-# The first `grep -vE` drops lines where `nomarchy-*` is a derivation /
-# tmp file / sudoers basename / systemd unit / flake output / docker
-# container identifier rather than a shell invocation.
-# The second `grep -vE` is a token-level safety net for prefix-only
-# tokens left over from wildcards/expansions (e.g. `nomarchy-pkg-*`).
-all_refs=$(grep -rhE 'nomarchy-[a-z0-9]([a-z0-9-]*[a-z0-9])?' \
-            "${grep_includes[@]}" \
-            "${search_dirs[@]}" 2>/dev/null \
-          | grep -vE \
-              -e '(pname|name)[[:space:]]*=[[:space:]]*"nomarchy-' \
-              -e '/tmp/nomarchy-' \
-              -e '/etc/sudoers\.d/[^"[:space:]]*nomarchy-' \
-              -e 'nixosConfigurations\.nomarchy-' \
-              -e 'packages\.[^.]+\.nomarchy-' \
-              -e '\./result/bin/run-nomarchy-' \
-              -e 'mktemp[[:space:]]+[^|]*-t[[:space:]]+nomarchy-' \
-              -e '(TIMER_NAME|NOPASSWD_FILE|UNIT_NAME)=.*nomarchy-' \
-              -e '\.services\.nomarchy-' \
-              -e 'docker[[:space:]]+[^|]*nomarchy-' \
-          | grep -oE 'nomarchy-[a-z0-9]([a-z0-9-]*[a-z0-9])?' \
-          | grep -vE '^(nomarchy-launch|nomarchy-brightness|nomarchy-cmd|nomarchy-pkg|nomarchy-restart|nomarchy-toggle|nomarchy-theme|nomarchy-webapp-handler|nomarchy-font-selector|nomarchy-theme-selector|nomarchy-wallpaper-selector|nomarchy-setup|nomarchy-refresh|nomarchy-scripts|nomarchy-system-scripts|nomarchy-theme-engine-scripts)$' \
-          | grep -vE '^(nomarchy-plymouth|nomarchy-sddm-theme|nomarchy-live|nomarchy-rev|nomarchy-windows)$' \
-          | grep -vE '^(nomarchy-eval-matrix|nomarchy-docs-scripts|nomarchy-docs-keybindings)$' \
-          | sort -u)
-# The second denylist covers identifiers whose ambiguity survives the line
-# filter: `nomarchy-plymouth` / `nomarchy-sddm-theme` are Nix derivation
-# names referenced as bare idents in `[...]` lists, `nomarchy-live` is an
-# ISO label that shows up in comments, `nomarchy-rev` is `/etc/nomarchy-rev`
-# (written by the ISO), and `nomarchy-windows` is a docker container name
-# in compose heredocs.
-# The third denylist: `nomarchy-eval-matrix`, `nomarchy-docs-scripts` (this
-# generator), and `nomarchy-docs-keybindings` are bin/utils repo tools that
-# name themselves in their own headers / AGENT.md — not user-facing scripts
-# that ship in nomarchy-system-scripts.
-
-# --- Render: header --------------------------------------------------------
-
-main() {
-  cat <<'HEADER'
-# Nomarchy Script & Menu Audit
-
-Auto-generated table for [Pillar 3 of the roadmap](ROADMAP.md#3-pillar-script--menu-audit).
-**Do not edit by hand.** Regenerate after script or menu changes:
-
-```bash
-./bin/utils/nomarchy-docs-scripts --out docs/SCRIPTS.md
-```
-
-The status column uses a Phase A heuristic — `kept` / `unused?` / `missing`.
-Phase B (per-batch PRs) refines those into `port-from-omarchy`,
-`delete-dead`, or `stub-with-notify` and updates the rows.
-
-## Status legend
-
-- `kept` — script exists and is called from somewhere outside its own directory.
-- `unused?` — script exists but no caller was found. Could be dead, could be
-  intentional public API. Phase B triage decides.
-- `missing` — referenced from code but no script file exists. Phase B triage
-  decides whether to port from Omarchy upstream, delete the caller, or stub
-  with `notify-send`.
-- `port-from-omarchy` — Phase B verdict: lift the upstream Omarchy script,
-  rewrite for NixOS paths.
-- `delete-dead` — Phase B verdict: remove and update callers.
-- `stub-with-notify` — Phase B verdict: temporary `notify-send` stub.
-
-HEADER
-
-  # --- Render: scripts table ----------------------------------------------
-  printf '## Scripts (%d)\n\n' "${#script_loc[@]}"
-  printf '| Script | Location | Callers | Status | Notes |\n'
-  printf '| --- | --- | --- | --- | --- |\n'
-
-  # Sort scripts by name.
-  for name in $(printf '%s\n' "${!script_loc[@]}" | sort); do
-    local dir="${script_loc[$name]}"
-    local callers status callers_str
-    callers=$(ref_files_per_cmd "$name")
-    if [[ -z "$callers" ]]; then
-      status='`unused?`'
-      callers_str='—'
-    else
-      status='`kept`'
-      # Trim caller list to 2 entries + count.
-      local count
-      count=$(printf '%s\n' "$callers" | wc -l)
-      if (( count > 2 )); then
-        callers_str=$(printf '%s\n' "$callers" | head -2 | paste -sd, -)
-        callers_str="$callers_str, +$((count - 2)) more"
-      else
-        callers_str=$(printf '%s\n' "$callers" | paste -sd, -)
-      fi
-    fi
-    printf '| `%s` | `%s` | %s | %s |  |\n' \
-      "$name" "$dir" "$callers_str" "$status"
-  done
-  echo
-
-  # --- Render: missing references -----------------------------------------
-  printf '## Missing references\n\n'
-  printf 'Tokens grepped from `core/`, `features/`, `themes/`, `installer/`, `hosts/`, `bin/`, `lib/` that have no matching script file.\n\n'
-  printf '| Token | Referenced in | Status |\n'
-  printf '| --- | --- | --- |\n'
-  while IFS= read -r token; do
-    [[ -z "$token" ]] && continue
-    [[ -n "${script_loc[$token]:-}" ]] && continue
-    local refs
-    self_pattern=$(IFS='|'; echo "${self_refs[*]}")
-    refs=$(grep -rlE "\\b${token}\\b" \
-            "${grep_includes[@]}" \
-            "${search_dirs[@]}" 2>/dev/null \
-          | grep -vE "^(${self_pattern})$" \
-          | sort -u)
-    [[ -z "$refs" ]] && continue
-    local count refs_str
-    count=$(printf '%s\n' "$refs" | wc -l)
-    if (( count > 2 )); then
-      refs_str=$(printf '%s\n' "$refs" | head -2 | paste -sd, -)
-      refs_str="$refs_str, +$((count - 2)) more"
-    else
-      refs_str=$(printf '%s\n' "$refs" | paste -sd, -)
-    fi
-    printf '| `%s` | %s | `missing` |\n' "$token" "$refs_str"
-  done <<<"$all_refs"
-  echo
-
-  # --- Render: menu items -------------------------------------------------
-  printf '## Menu items\n\n'
-  printf 'Walked from `features/scripts/utils/nomarchy-menu`. Each `case` arm in a `show_*_menu` function becomes one row.\n\n'
-  printf '| Submenu | Entry | Calls | Status |\n'
-  printf '| --- | --- | --- | --- |\n'
-
-  awk '
-    /^show_[a-z_]+_menu\(\) {/ { sub(/\(\) {/, ""); current=$1; in_func=1; next }
-    /^[a-z_]+\(\) {/ && !/^show_/ { current=""; in_func=0; next }
-    /^}$/ { current=""; in_func=0; next }
-    !in_func { next }
-    /^  case \$\(menu / {
-      # extract the menu title between the first pair of double quotes
-      match($0, /menu "[^"]+" "[^"]+"/);
-      if (RSTART == 0) next;
-      title=substr($0, RSTART, RLENGTH);
-      # second quoted string is the option list
-      n=split(title, parts, "\"");
-      title=parts[2];
-      options=parts[4];
-      # split options on \n
-      split(options, opts, "\\\\n");
-      pending_submenu=current;
-      pending_title=title;
-      for (i=1;i<=length(opts);i++) pending_opts[i]=opts[i];
-      pending_count=length(opts);
-      next
-    }
-    /^  \*[A-Za-z]/ {
-      # case arm — extract pattern between the first * and the closing )
-      match($0, /\*[^)]*\)/);
-      if (RSTART == 0) next;
-      arm=substr($0, RSTART, RLENGTH);
-      gsub(/[*)]/, "", arm);
-      gsub(/^[[:space:]]+|[[:space:]]+$/, "", arm);
-      # action follows the )
-      rest=substr($0, RSTART+RLENGTH);
-      sub(/^[[:space:]]+/, "", rest);
-      sub(/[[:space:]]*;;[[:space:]]*$/, "", rest);
-      # match the first nomarchy-* token in the action
-      cmd=""
-      if (match(rest, /nomarchy-[a-z0-9-]+/)) {
-        cmd=substr(rest, RSTART, RLENGTH);
-      }
-      printf "%s|%s|%s\n", pending_submenu, arm, cmd;
-    }
-  ' features/scripts/utils/nomarchy-menu > /tmp/nomarchy-menu-rows.$$
-
-  while IFS='|' read -r submenu entry cmd; do
-    [[ -z "$entry" ]] && continue
-    [[ "$entry" =~ ^\) ]] && continue
-    status='`kept`'
-    if [[ -n "$cmd" ]]; then
-      if [[ -z "${script_loc[$cmd]:-}" ]]; then
-        status='`missing`'
-      fi
-    else
-      cmd='_(inline)_'
-    fi
-    printf '| `%s` | %s | `%s` | %s |\n' "$submenu" "$entry" "$cmd" "$status"
-  done < /tmp/nomarchy-menu-rows.$$
-  rm -f /tmp/nomarchy-menu-rows.$$
-  echo
-}
-
-out=""
-if [[ "${1:-}" == "--out" ]]; then
-  out="${2:?--out needs a path}"; shift 2
-fi
-if [[ -n "$out" ]]; then
-  main >"$out"
-else
-  main
-fi

bin/utils/nomarchy-eval-matrix

@@ -1,149 +0,0 @@
-#!/usr/bin/env bash
-# nomarchy-eval-matrix
-#
-# Evaluates the opt-in nomarchy.* surface that the per-output flake check
-# never touches. flake check only evaluates the default configs, so a bug
-# that only fires when a toggle is flipped — a renamed option, a failed
-# assertion, a stale reference — sails straight through. Two such bugs
-# shipped to main before this existed (the vscode option rename and the
-# impermanence systemd-stage-1 assertion); both would have been caught
-# here.
-#
-# Cost matters: this runs in CI on a small self-hosted runner, and the
-# first cut (one full `extendModules` eval per individual toggle, plus one
-# per palette) did ~39 whole-system evaluations and ran ~3h. So:
-#
-#   * Compatible toggles are COMBINED into a few configs (a failure means
-#     re-run the offending toggle alone to pinpoint it — see the trace hint
-#     at the end). laptop vs desktop formFactor conflict, so they split;
-#     impermanence's multi-disk variant gets its own config for the alt
-#     mainLuksName.
-#   * Palettes are checked DIRECTLY via the lib — the per-palette risk is
-#     the system-side Plymouth base00 → RGB math (fromHexString of 2-char
-#     slices in themes/engine/plymouth.nix), which is pure and needs no
-#     module-system instantiation. Forcing the whole palette attrset also
-#     catches a missing/garbled palette.
-#   * The standalone homeConfigurations aren't re-checked here — the
-#     per-output flake-check step already forces both.
-#
-# Net: a handful of full evals instead of ~39. Results come from
-# builtins.tryEval so one failure doesn't mask the rest.
-#
-#   nomarchy-eval-matrix          # run the matrix, table + exit code
-#
-# Add a new opt-in option's coverage by dropping it into the relevant
-# combined scenario in the `scenarios` attrset below.
-
-set -u
-
-repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
-cd "$repo_root"
-
-NIX=(nix --extra-experimental-features 'nix-command flakes')
-
-read -r -d '' EXPR <<'NIXEOF' || true
-let
-  f = builtins.getFlake (toString ./.);
-  lib = f.inputs.nixpkgs.lib;
-  nl = import ./lib { inherit lib; };
-  default = f.nixosConfigurations.default;
-
-  forced = x: (builtins.tryEval (builtins.seq x true)).success;
-
-  # Combined opt-in scenarios. Each enables as many compatible toggles as
-  # possible so CI does ~3 full-system evals, not one per toggle. Home-side
-  # options go under home-manager.users.nomarchy.nomarchy.*.
-  scenarios = {
-    # laptop formFactor + every compatible system/home toggle + impermanence.
-    "laptop-stack" = {
-      nomarchy.system = {
-        formFactor = "laptop";
-        laptop.enable = true;
-        accessibility.enable = true;
-        gaming.enable = true;
-        features.hybridGPU = true;
-        hibernation.enable = true;
-        virtualization.docker.enable = true;
-        impermanence.enable = true;
-      };
-      nomarchy.hardware.fwupd = true;
-      home-manager.users.nomarchy.nomarchy = {
-        accessibility.enable = true;
-        gaming.enable = true;
-        overrides.enable = true;
-        panelPosition = "bottom";
-        keymap = { layout = "de"; variant = "nodeadkeys"; };
-        toggles = { waybar = false; idle = false; nightlight = false; };
-      };
-    };
-
-    # desktop preset — conflicts with the laptop formFactor, so its own eval.
-    "desktop-stack" = {
-      nomarchy.system = { formFactor = "desktop"; desktop.enable = true; };
-    };
-
-    # impermanence multi-disk variant (alternate mainLuksName).
-    "impermanence-multi" = {
-      nomarchy.system.impermanence = { enable = true; mainLuksName = "crypted_main"; };
-    };
-  };
-
-  evalToplevel = mod:
-    forced (default.extendModules { modules = [ mod ]; }).config.system.build.toplevel.drvPath;
-
-  # base00 → the three byte values the Plymouth template substitutes; plus
-  # the whole palette attrset, so a missing/garbled palette is caught.
-  paletteOk = name:
-    let
-      p = nl.getPalette name;
-      b = p.base00;
-      bytes = [
-        (lib.fromHexString (lib.substring 0 2 b))
-        (lib.fromHexString (lib.substring 2 2 b))
-        (lib.fromHexString (lib.substring 4 2 b))
-      ];
-    in forced (builtins.deepSeq [ p bytes ] true);
-in {
-  scenarios = builtins.mapAttrs (_: evalToplevel) scenarios;
-  palettes  = builtins.listToAttrs (map (n: { name = n; value = paletteOk n; }) nl.themeNames);
-}
-NIXEOF
-
-echo "Evaluating combined toggle scenarios + per-palette colour math..."
-json="$("${NIX[@]}" eval --impure --json --expr "$EXPR" 2>/tmp/eval-matrix.err)"
-status=$?
-if [[ $status -ne 0 || -z "$json" ]]; then
-  echo "ERROR: the matrix evaluation aborted before producing results." >&2
-  echo "This usually means an uncatchable error (abort/infinite recursion) in one" >&2
-  echo "scenario, or a syntax error in the expression. Full output:" >&2
-  cat /tmp/eval-matrix.err >&2
-  exit 1
-fi
-
-# Render each section and tally failures.
-fails=0
-render() {
-  local section="$1"
-  echo
-  echo "=== $section ==="
-  while IFS=$'\t' read -r name ok; do
-    if [[ "$ok" == "true" ]]; then
-      printf '  ok    %s\n' "$name"
-    else
-      printf '  FAIL  %s\n' "$name"
-      fails=$((fails + 1))
-    fi
-  done < <(echo "$json" | jq -r --arg s "$section" '.[$s] | to_entries[] | "\(.key)\t\(.value)"' | sort)
-}
-
-render scenarios
-render palettes
-
-echo
-if [[ $fails -gt 0 ]]; then
-  echo "$fails scenario(s) failed to evaluate. A combined scenario bundles several"
-  echo "toggles — re-run the suspects individually for the trace, e.g.:"
-  echo "  nix eval --impure --show-trace --expr 'let f = builtins.getFlake (toString ./.); in (f.nixosConfigurations.default.extendModules { modules = [ { <the toggle> } ]; }).config.system.build.toplevel.drvPath'"
-  exit 1
-fi
-echo "All scenarios evaluated cleanly."

core/branding/about.txt

@@ -1,16 +0,0 @@
-# About Nomarchy
-
-Nomarchy is a highly curated, NixOS-based distribution designed for power users.
-It features a customized Hyprland desktop environment with a declarative
-theming engine and a suite of integrated utility scripts.
-
-Built on a foundation of:
-- NixOS (Linux)
-- Hyprland (Window Manager)
-- Waybar (Status Bar)
-- Walker (Application Launcher & Menu)
-- Stylix (Theming Engine)
-
-Version: 2026.05.04
-Docs: https://github.com/nomarchy/nomarchy/docs
-Manual: nomarchy-manual (Command)

core/branding/icon.svg

@@ -1,56 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-
-<svg
-   width="210mm"
-   height="297mm"
-   viewBox="0 0 210 297"
-   version="1.1"
-   id="svg1"
-   xml:space="preserve"
-   inkscape:version="1.4.3 (0d15f75042, 2025-12-25)"
-   sodipodi:docname="icon.svg"
-   inkscape:export-filename="logo.svg"
-   inkscape:export-xdpi="96"
-   inkscape:export-ydpi="96"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg"><sodipodi:namedview
-     id="namedview1"
-     pagecolor="#ffffff"
-     bordercolor="#000000"
-     borderopacity="0.25"
-     inkscape:showpageshadow="2"
-     inkscape:pageopacity="0.0"
-     inkscape:pagecheckerboard="0"
-     inkscape:deskcolor="#d1d1d1"
-     inkscape:document-units="mm"
-     inkscape:zoom="0.82803284"
-     inkscape:cx="215.57116"
-     inkscape:cy="452.27675"
-     inkscape:window-width="1025"
-     inkscape:window-height="1012"
-     inkscape:window-x="0"
-     inkscape:window-y="0"
-     inkscape:window-maximized="0"
-     inkscape:current-layer="layer1" /><defs
-     id="defs1" /><g
-     inkscape:label="Layer 1"
-     inkscape:groupmode="layer"
-     id="layer1"><g
-       id="g4"
-       transform="translate(3.1953242,-22.686801)"
-       style="fill:#000088;fill-opacity:1"><path
-         style="fill:#000088;stroke-width:0.264583;fill-opacity:1"
-         d="M 25.136891,85.823024 25.557592,210.77125 88.452409,174.38061 67.417351,160.49747 57.110174,166.38729 V 105.80633 Z"
-         id="path1" /><path
-         style="fill:#000088;stroke-width:0.264583;fill-opacity:1"
-         d="M 67.728991,112.41131 182.54178,185.60757 153.16137,202.85259 67.830432,148.17947 Z"
-         id="path2" /><path
-         style="fill:#000088;stroke-width:0.264583;fill-opacity:1"
-         d="M 139.74857,145.88014 140.00405,110.4959 54.800856,56.333749 25.675926,73.32329 Z"
-         id="path3" /><path
-         style="fill:#000088;stroke-width:0.264583;fill-opacity:1"
-         d="M 182.2863,172.70573 V 48.286069 l -62.59305,36.406166 20.82177,13.668277 10.21927,-5.74834 0.12774,60.165978 z"
-         id="path4" /></g></g></svg>

core/branding/icon.txt

@@ -1,34 +0,0 @@
-                                                         ${2},,,
-          ${1},,                                          ${2},,,,,,
-       ${1},,,,,,,,                                   ${2},,,,,,,,,,
-    ${1},,,,,,,,,,,,,,                             ${2}.,,,,,,,,,,,,
- ${1},,,,,,,,,,,,,,,,,,,,                       ${2},,,,,,,,,,,,,,,,
-${1},,,,,,,,,,,,,,,,,,,,,,,.                 ${2},,,,,,,,,,,,,,,,,,,
-  ${1}.,,,,,,,,,,,,,,,,,,,,,,,,          ${2},,,,,,,,,,,,,,,,,,,,,,,
-${1},    ${1},,,,,,,,,,,,,,,,,,,,,,,,,      ${2},,,,,,,,,,,,,,,,,,,,,,,,
-${1},,,     ${1},,,,,,,,,,,,,,,,,,,,,,,,    ${2},,,,,,,,,,,,,,,,,,,,,,,,
-${1},,,,,,     ${1}.,,,,,,,,,,,,,,,,,,,,,,,     ${2},,,,,,,,,,,,,,,,,,,,
-${1},,,,,,,,,.    ${1},,,,,,,,,,,,,,,,,,,,,,,,,    ${2},,, ${2}.,,,,,,,,,,,,
-${1},,,,,,,,,,,,    ${1}.,,,,,,,,,,,,,,,,,,,,,,,,      ${2},,,,,,,,,,,,,
-${1},,,,,,,,,,,,,      ${1},,,,,,,,,,,,,,,,,,,,,,,,.   ${2},,,,,,,,,,,,,
-${1},,,,,,,,,,,,,   ${1},,     ${1},,,,,,,,,,,,,,,,,,,,,    ${2},,,,,,,,,,,,
-${1},,,,,,,,,,,,,   ${1},,,,,    ${1},,,,,,,,,,,,,,,,,,,    ${2},,,,,,,,,,,,
-${1},,,,,,,,,,,,,   ${1},,,,,,,,    ${1},,,,,,,,,,,,,,,,    ${2},,,,,,,,,,,,
-${1},,,,,,,,,,,,,   ${1},,,,,,,,,,     ${1},,,,,,,,,,,,,    ${2},,,,,,,,,,,,
-${1},,,,,,,,,,,,,   ${1},,,,,,,,,,,,,,    ${1},,,,,,,,,,    ${2},,,,,,,,,,,,
-${1},,,,,,,,,,,,,   ${1},,,,,,,,,,,,,,,,     ${1},,,,,,,    ${2},,,,,,,,,,,,
-${1},,,,,,,,,,,,,   ${1},,,,,,,,,,,,,,,,,,,     ${1},,,,    ${2},,,,,,,,,,,,
-${1},,,,,,,,,,,,,   ${1},,,,,,,,,,,,,,,,,,,,,,    ${1},,    ${2},,,,,,,,,,,,
-${1},,,,,,,,,,,,,   ${1},,,,,,,,,,,,,,,,,,,,,,,,,       ${2},,,,,,,,,,,,
-${1},,,,,,,,,,,,,      ${1},,,,,,,,,,,,,,,,,,,,,,,,,    ${2},,,,,,,,,,,,
-${1},,,,,,,,,,,,, ${1},,,     ${1},,,,,,,,,,,,,,,,,,,,,,,,,    ${2},,,,,,,,,
-${1},,,,,,,,,,,,,,,,,,,,     ${1},,,,,,,,,,,,,,,,,,,,,,,,     ${2}.,,,,,
-${1},,,,,,,,,,,,,,,,,,,,,,,,    ${1},,,,,,,,,,,,,,,,,,,,,,,,,    ${2},,,
-${1},,,,,,,,,,,,,,,,,,,,,,,,       ${1},,,,,,,,,,,,,,,,,,,,,,,,,    
-${1},,,,,,,,,,,,,,,,,,,,,,,          ${1},,,,,,,,,,,,,,,,,,,,,,,,,  
-${1},,,,,,,,,,,,,,,,,,,                  ${1},,,,,,,,,,,,,,,,,,,,,,,
-${1},,,,,,,,,,,,,,,,                       ${1}.,,,,,,,,,,,,,,,,,,, 
-${1},,,,,,,,,,,,,                             ${1},,,,,,,,,,,,,,    
-${1},,,,,,,,,,                                  ${1},,,,,,,,,.      
-${1},,,,,,                                          ${1},,          
-${1},,,,                                                        

core/branding/logo.txt

@@ -1,34 +0,0 @@
-                                                         ,,,
-          ,,                                          ,,,,,,
-       ,,,,,,,,                                   ,,,,,,,,,,
-    ,,,,,,,,,,,,,,                             .,,,,,,,,,,,,
- ,,,,,,,,,,,,,,,,,,,,                       ,,,,,,,,,,,,,,,,
-,,,,,,,,,,,,,,,,,,,,,,,.                 ,,,,,,,,,,,,,,,,,,,
-  .,,,,,,,,,,,,,,,,,,,,,,,,          ,,,,,,,,,,,,,,,,,,,,,,,
-,    ,,,,,,,,,,,,,,,,,,,,,,,,,      ,,,,,,,,,,,,,,,,,,,,,,,,
-,,,     ,,,,,,,,,,,,,,,,,,,,,,,,    ,,,,,,,,,,,,,,,,,,,,,,,,
-,,,,,,     .,,,,,,,,,,,,,,,,,,,,,,,     ,,,,,,,,,,,,,,,,,,,,
-,,,,,,,,,.    ,,,,,,,,,,,,,,,,,,,,,,,,,    ,,, .,,,,,,,,,,,,
-,,,,,,,,,,,,    .,,,,,,,,,,,,,,,,,,,,,,,,      ,,,,,,,,,,,,,
-,,,,,,,,,,,,,      ,,,,,,,,,,,,,,,,,,,,,,,,.   ,,,,,,,,,,,,,
-,,,,,,,,,,,,,   ,,     ,,,,,,,,,,,,,,,,,,,,,    ,,,,,,,,,,,,
-,,,,,,,,,,,,,   ,,,,,    ,,,,,,,,,,,,,,,,,,,    ,,,,,,,,,,,,
-,,,,,,,,,,,,,   ,,,,,,,,    ,,,,,,,,,,,,,,,,    ,,,,,,,,,,,,
-,,,,,,,,,,,,,   ,,,,,,,,,,     ,,,,,,,,,,,,,    ,,,,,,,,,,,,
-,,,,,,,,,,,,,   ,,,,,,,,,,,,,,    ,,,,,,,,,,    ,,,,,,,,,,,,
-,,,,,,,,,,,,,   ,,,,,,,,,,,,,,,,     ,,,,,,,    ,,,,,,,,,,,,
-,,,,,,,,,,,,,   ,,,,,,,,,,,,,,,,,,,     ,,,,    ,,,,,,,,,,,,
-,,,,,,,,,,,,,   ,,,,,,,,,,,,,,,,,,,,,,    ,,    ,,,,,,,,,,,,
-,,,,,,,,,,,,,   ,,,,,,,,,,,,,,,,,,,,,,,,,       ,,,,,,,,,,,,
-,,,,,,,,,,,,,      ,,,,,,,,,,,,,,,,,,,,,,,,,    ,,,,,,,,,,,,
-,,,,,,,,,,,,, ,,,     ,,,,,,,,,,,,,,,,,,,,,,,,,    ,,,,,,,,,
-,,,,,,,,,,,,,,,,,,,,     ,,,,,,,,,,,,,,,,,,,,,,,,     .,,,,,
-,,,,,,,,,,,,,,,,,,,,,,,,    ,,,,,,,,,,,,,,,,,,,,,,,,,    ,,,
-,,,,,,,,,,,,,,,,,,,,,,,,       ,,,,,,,,,,,,,,,,,,,,,,,,,    
-,,,,,,,,,,,,,,,,,,,,,,,          ,,,,,,,,,,,,,,,,,,,,,,,,,  
-,,,,,,,,,,,,,,,,,,,                  ,,,,,,,,,,,,,,,,,,,,,,,
-,,,,,,,,,,,,,,,,                       .,,,,,,,,,,,,,,,,,,, 
-,,,,,,,,,,,,,                             ,,,,,,,,,,,,,,    
-,,,,,,,,,,                                  ,,,,,,,,,.      
-,,,,,,                                          ,,          
-,,,,                                                        

core/branding/screensaver.txt

@@ -1,11 +0,0 @@
-# Nomarchy Screensaver Configuration
-
-Nomarchy uses hyprlock for locking and hypridle for idle management.
-To configure the screensaver/lock screen visuals, edit:
-~/.config/hypr/hyprlock.conf
-
-To configure idle timeouts and actions, edit:
-~/.config/hypr/hypridle.conf
-
-You can also toggle the screensaver/idle management via the Nomarchy Menu:
-Trigger > Toggle > Idle Lock

core/default.nix

@@ -1,5 +0,0 @@
-{ ... }:
-
-{
-  imports = [ ./system ];
-}

core/home/accessibility.nix

@@ -1,28 +0,0 @@
-{ config, lib, ... }:
-
-let
-  cfg = config.nomarchy.accessibility;
-in
-{
-  config = lib.mkIf cfg.enable {
-    # Hyprland-side accessibility extras. The system preset
-    # (core/system/accessibility.nix) covers AT-SPI2 + Orca on PATH +
-    # XCURSOR_SIZE; this module adds the bits Hyprland reads directly.
-    #
-    # Loaded via extraConfig (mkAfter) so it merges with — and overrides
-    # — the templated input.conf for the repeat-rate / repeat-delay
-    # fields. The Orca keybinding is additive.
-    wayland.windowManager.hyprland.extraConfig = lib.mkAfter ''
-      # Accessibility — slower key-repeat so holding a key isn't a
-      # runaway machine-gun for users with low-mobility hands.
-      input {
-        repeat_rate = 25
-        repeat_delay = 1000
-      }
-
-      # Launch the Orca screen reader. The system preset puts `orca`
-      # on PATH when nomarchy.system.accessibility.enable = true.
-      bindd = SUPER ALT, S, Launch Orca, exec, orca
-    '';
-  };
-}

core/home/bash.nix

@@ -1,39 +0,0 @@
-{ config, lib, ... }:
-
-{
-  programs.bash = {
-    enable = true;
-
-    bashrcExtra = ''
-      if [[ -f ~/.config/nomarchy/default/bash/rc ]]; then
-        source ~/.config/nomarchy/default/bash/rc
-      fi
-    '';
-
-    shellAliases = lib.mkDefault {
-      # File system
-      lsa = "ls -a";
-
-      # Directories
-      ".." = "cd ..";
-      "..." = "cd ../..";
-      "...." = "cd ../../..";
-
-      # Tools
-      c = "opencode";
-      d = "docker";
-      r = "rails";
-      t = "tmux attach || tmux new -s Work";
-
-      # Git
-      g = "git";
-      gcm = "git commit -m";
-      gcam = "git commit -a -m";
-      gcad = "git commit -a --amend";
-
-      # NixOS commands
-      sys-update = "nomarchy-sys-update";
-      env-update = "nomarchy-env-update";
-    };
-  };
-}

core/home/config/brave-flags.conf

@@ -1,4 +0,0 @@
---ozone-platform=wayland
---ozone-platform-hint=wayland
---enable-features=TouchpadOverscrollHistoryNavigation
---load-extension=~/.config/nomarchy/default/chromium/extensions/copy-url

core/home/config/chromium-flags.conf

@@ -1,4 +0,0 @@
---ozone-platform=wayland
---ozone-platform-hint=wayland
---enable-features=TouchpadOverscrollHistoryNavigation
---load-extension=~/.config/nomarchy/default/chromium/extensions/copy-url

core/home/config/fastfetch/config.jsonc

@@ -1,137 +0,0 @@
-{
-  "$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json",
-  "logo": {
-    "type": "file",
-    "source": "~/.config/nomarchy/branding/icon.txt",
-    "color": { "1": "green", "2": "blue" },
-    "padding": {
-      "top": 2,
-      "right": 6,
-      "left": 2
-    }
-  },
-  "modules": [
-    "break",
-    {
-      "type": "custom",
-      "format": "\u001b[90m┌──────────────────────Hardware──────────────────────┐"
-    },
-    {
-      "type": "host",
-      "key": " PC",
-      "keyColor": "green"
-    },
-    {
-      "type": "cpu",
-      "key": "│ ├",
-      "showPeCoreCount": true,
-      "keyColor": "green"
-    },
-    {
-      "type": "gpu",
-      "key": "│ ├",
-      "detectionMethod": "pci",
-      "keyColor": "green"
-    },
-    {
-      "type": "display",
-      "key": "│ ├󱄄",
-      "keyColor": "green"
-    },
-    {
-      "type": "disk",
-      "key": "│ ├󰋊",
-      "keyColor": "green"
-    },
-    {
-      "type": "memory",
-      "key": "│ ├",
-      "keyColor": "green"
-    },
-    {
-      "type": "swap",
-      "key": "└ └󰓡 ",
-      "keyColor": "green"
-    },
-    {
-      "type": "custom",
-      "format": "\u001b[90m└────────────────────────────────────────────────────┘"
-    },
-    "break",
-    {
-      "type": "custom",
-      "format": "\u001b[90m┌──────────────────────Software──────────────────────┐"
-    },
-    {
-      "type": "os",
-      "key": "\ue900 OS",
-      "keyColor": "blue"
-    },
-    {
-      "type": "kernel",
-      "key": "│ ├",
-      "keyColor": "blue"
-    },
-    {
-      "type": "wm",
-      "key": "│ ├",
-      "keyColor": "blue"
-    },
-    {
-      "type": "de",
-      "key": " DE",
-      "keyColor": "blue"
-    },
-    {
-      "type": "terminal",
-      "key": "│ ├",
-      "keyColor": "blue"
-    },
-    {
-      "type": "packages",
-      "key": "│ ├󰏖",
-      "keyColor": "blue"
-    },
-    {
-      "type": "wmtheme",
-      "key": "│ ├󰉼",
-      "keyColor": "blue"
-    },
-    {
-      "type": "command",
-      "key": "│ ├󰸌",
-      "keyColor": "blue",
-      "text": "theme=$(cat ~/.config/nomarchy/current/theme.name); echo -e \"$theme \\e[38m●\\e[37m●\\e[36m●\\e[35m●\\e[34m●\\e[33m●\\e[32m●\\e[31m●\""
-    },
-    {
-      "type": "terminalfont",
-      "key": "└ └",
-      "keyColor": "blue"
-    },
-    {
-      "type": "custom",
-      "format": "\u001b[90m└────────────────────────────────────────────────────┘"
-    },
-    "break",
-    {
-      "type": "custom",
-      "format": "\u001b[90m┌────────────────Age / Uptime / Update───────────────┐"
-    },
-    {
-      "type": "command",
-      "key": "󱦟 OS Age",
-      "keyColor": "magenta",
-      "text": "echo $(( ($(date +%s) - $(stat -c %W /)) / 86400 )) days"
-    },
-    {
-      "type": "uptime",
-      "key": "󱫐 Uptime",
-      "keyColor": "magenta"
-    },
-    {
-      "type": "custom",
-      "format": "\u001b[90m└────────────────────────────────────────────────────┘"
-    },
-    "break"
-  ]
-}

core/home/config/fcitx5/conf/clipboard.conf

@@ -1,2 +0,0 @@
-TriggerKey=
-PastePrimaryKey=

core/home/config/fcitx5/conf/xcb.conf

@@ -1 +0,0 @@
-Allow Overriding System XKB Settings=False

core/home/config/fontconfig/fonts.conf

@@ -1,79 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
-<fontconfig>
-  <match target="pattern">
-    <test name="family" qual="any">
-      <string>sans-serif</string>
-    </test>
-    <edit name="family" mode="assign" binding="strong">
-      <string>Liberation Sans</string>
-    </edit>
-  </match>
-
-  <match target="pattern">
-    <test name="family" qual="any">
-      <string>serif</string>
-    </test>
-    <edit name="family" mode="assign" binding="strong">
-      <string>Liberation Serif</string>
-    </edit>
-  </match>
-
-  <match target="pattern">
-    <test name="family" qual="any">
-      <string>monospace</string>
-    </test>
-    <edit name="family" mode="assign" binding="strong">
-      <string>JetBrainsMono Nerd Font</string>
-    </edit>
-  </match>
-
-  <alias>
-    <family>system-ui</family>
-    <prefer>
-      <family>Liberation Sans</family>
-    </prefer>
-  </alias>
-
-  <alias>
-    <family>ui-monospace</family>
-    <default>
-      <family>monospace</family>
-    </default>
-  </alias>
-
-  <alias>
-    <family>-apple-system</family>
-    <prefer>
-      <family>Liberation Sans</family>
-    </prefer>
-  </alias>
-
-  <alias>
-    <family>BlinkMacSystemFont</family>
-    <prefer>
-      <family>Liberation Sans</family>
-    </prefer>
-  </alias>
-
-  <alias>
-    <family>sans-serif</family>
-    <accept>
-      <family>Noto Color Emoji</family>
-    </accept>
-  </alias>
-
-  <alias>
-    <family>serif</family>
-    <accept>
-      <family>Noto Color Emoji</family>
-    </accept>
-  </alias>
-
-  <alias>
-    <family>monospace</family>
-    <accept>
-      <family>Noto Color Emoji</family>
-    </accept>
-  </alias>
-</fontconfig>

core/home/config/git/config

@@ -1,28 +0,0 @@
-# See https://git-scm.com/docs/git-config
-
-[alias]
-	co = checkout
-	br = branch
-	ci = commit
-	st = status
-[init]
-	defaultBranch = master
-[pull]
-	rebase = true 			 # Rebase (instead of merge) on pull
-[push]
-	autoSetupRemote = true   # Automatically set upstream branch on push
-[diff]
-	algorithm = histogram    # Clearer diffs on moved/edited lines
-	colorMoved = plain       # Highlight moved blocks in diffs
-	mnemonicPrefix = true    # More intuitive refs in diff output
-[commit]
-	verbose = true           # Include diff comment in commit message template
-[column]
-	ui = auto 			     # Output in columns when possible
-[branch]
-	sort = -committerdate    # Sort branches by most recent commit first
-[tag]
-	sort = -version:refname  # Sort version numbers as you would expect
-[rerere]
-	enabled = true           # Record and reuse conflict resolutions
-	autoupdate = true        # Apply stored conflict resolutions automatically

core/home/config/imv/config

@@ -1,13 +0,0 @@
-[binds]
-
-# Print the current image file
-<Ctrl+p> = exec lp "$imv_current_file"
-
-# Delete the current image and quit the viewer
-<Ctrl+x> = exec rm "$imv_current_file"; quit
-
-# Delete the current image and move to the next one
-<Ctrl+Shift+X> = exec rm "$imv_current_file"; close
-
-# Rotate the currently open image by 90 degrees
-<Ctrl+r> = exec mogrify -rotate 90 "$imv_current_file"

core/home/config/nautilus-python/extensions/localsend.py

@@ -1,84 +0,0 @@
-import os
-import shutil
-
-from gi import require_version
-
-require_version("Nautilus", "4.1")
-
-from gi.repository import GObject, Gio, Nautilus
-
-
-class SendViaLocalSendAction(GObject.GObject, Nautilus.MenuProvider):
-    def _launch_localsend(self, paths):
-        command = self._resolve_command()
-        if not command:
-            return
-
-        if command[-1] == "@@":
-            command = command + paths + ["@@"]
-        else:
-            command = command + paths
-
-        Gio.Subprocess.new(command, Gio.SubprocessFlags.NONE)
-
-    def _resolve_command(self):
-        localsend = shutil.which("localsend")
-        if localsend:
-            return [localsend, "--headless", "send"]
-
-        flatpak = shutil.which("flatpak")
-        if flatpak and self._has_flatpak_app(flatpak, "org.localsend.localsend_app"):
-            return [
-                flatpak,
-                "run",
-                "--file-forwarding",
-                "org.localsend.localsend_app",
-                "@@",
-            ]
-
-        return None
-
-    def _has_flatpak_app(self, flatpak, app_id):
-        process = Gio.Subprocess.new(
-            [flatpak, "info", app_id],
-            Gio.SubprocessFlags.STDOUT_SILENCE | Gio.SubprocessFlags.STDERR_SILENCE,
-        )
-        return process.wait_check()
-
-    def _selected_paths(self, files):
-        paths = []
-
-        for file in files:
-            location = file.get_location()
-            if not location:
-                continue
-
-            path = location.get_path()
-            if path and path not in paths:
-                paths.append(path)
-
-        return paths
-
-    def _make_item(self, paths):
-        label = (
-            "Send via LocalSend" if len(paths) == 1 else "Send selected via LocalSend"
-        )
-        item = Nautilus.MenuItem(
-            name="LocalSendNautilus::send_via_localsend",
-            label=label,
-            icon="localsend",
-        )
-        item.connect("activate", self._on_activate, paths)
-        return item
-
-    def _on_activate(self, _menu, paths):
-        self._launch_localsend(paths)
-
-    def get_file_items(self, *args):
-        files = args[0] if len(args) == 1 else args[1]
-        paths = self._selected_paths(files)
-
-        if not paths or not self._resolve_command():
-            return []
-
-        return [self._make_item(paths)]

core/home/config/nomarchy-skill/SKILL.md

@@ -1,399 +0,0 @@
----
-name: nomarchy
-description: >
-  REQUIRED for end-user customization of Linux desktop, window manager, or system config.
-  Use when editing ~/.config/hypr/, ~/.config/waybar/, ~/.config/walker/,
-  ~/.config/alacritty/, ~/.config/kitty/, ~/.config/ghostty/, ~/.config/mako/,
-  or ~/.config/nomarchy/. Triggers: Hyprland, window rules, animations, keybindings,
-  monitors, gaps, borders, blur, opacity, waybar, walker, terminal config, themes,
-  wallpaper, night light, idle, lock screen, screenshots, layer rules, workspace
-  settings, display config, and user-facing nomarchy commands. Excludes Nomarchy
-  source development in ~/.local/share/nomarchy/ and repo-internal workflows.
----
-
-# Nomarchy Skill
-
-Manage [Nomarchy](https://nomarchy.org/) Linux systems - a beautiful, modern, opinionated Arch Linux distribution with Hyprland.
-
-This skill is for end-user customization on installed systems.
-It is not for contributing to Nomarchy source code.
-
-## When This Skill MUST Be Used
-
-**ALWAYS invoke this skill for end-user requests involving ANY of these:**
-
-- Editing ANY file in `~/.config/hypr/` (window rules, animations, keybindings, monitors, etc.)
-- Editing ANY file in `~/.config/waybar/`, `~/.config/walker/`, `~/.config/mako/`
-- Editing terminal configs (alacritty, kitty, ghostty)
-- Editing ANY file in `~/.config/nomarchy/`
-- Window behavior, animations, opacity, blur, gaps, borders
-- Layer rules, workspace settings, display/monitor configuration
-- Themes, wallpapers, fonts, appearance changes
-- User-facing `nomarchy-*` commands (`nomarchy-theme-*`, `nomarchy-refresh-*`, `nomarchy-restart-*`, etc.)
-- Screenshots, screen recording, night light, idle behavior, lock screen
-
-**If you're about to edit a config file in ~/.config/ on this system, STOP and use this skill first.**
-
-**Do NOT use this skill for Nomarchy development tasks** — editing files in `~/.local/share/nomarchy/` or modifying repo internals.
-
-## Critical Safety Rules
-
-**For end-user customization tasks, NEVER modify anything in `~/.local/share/nomarchy/`** - but READING is safe and encouraged.
-
-This directory contains Nomarchy's source files managed by git. Any changes will be:
-- Lost on next `nomarchy-update`
-- Cause conflicts with upstream
-- Break the system's update mechanism
-
-```
-~/.local/share/nomarchy/     # READ-ONLY - NEVER EDIT (reading is OK)
-├── bin/                    # Source scripts (symlinked to PATH)
-├── config/                 # Default config templates
-├── themes/                 # Stock themes
-├── default/                # System defaults
-├── migrations/             # Update migrations
-└── install/                # Installation scripts
-```
-
-**Reading `~/.local/share/nomarchy/` is SAFE and useful** - do it freely to:
-- Understand how nomarchy commands work: `cat $(which nomarchy-theme-set)`
-- See default configs before customizing: `cat ~/.local/share/nomarchy/config/fastfetch/config.jsonc`
-- Check stock theme files to copy for customization
-- Reference default hyprland settings: `cat ~/.config/nomarchy/default/hypr/*`
-
-**Always use these safe locations instead:**
-- `~/.config/` - User configuration (safe to edit)
-- `~/.config/nomarchy/themes/<custom-name>/` - Custom themes (must be real directories)
-- `~/.config/nomarchy/hooks/` - Custom automation hooks
-
-If the request is to develop Nomarchy itself, this skill is out of scope. Follow repository development instructions instead of this skill.
-
-## System Architecture
-
-Nomarchy is built on:
-
-| Component | Purpose | Config Location |
-|-----------|---------|-----------------|
-| **Arch Linux** | Base OS | `/etc/`, `~/.config/` |
-| **Hyprland** | Wayland compositor/WM | `~/.config/hypr/` |
-| **Waybar** | Status bar | `~/.config/waybar/` |
-| **Walker** | App launcher | `~/.config/walker/` |
-| **Alacritty/Kitty/Ghostty** | Terminals | `~/.config/<terminal>/` |
-| **Mako** | Notifications | `~/.config/mako/` |
-| **SwayOSD** | On-screen display | `~/.config/swayosd/` |
-
-## Command Discovery
-
-Nomarchy provides ~145 commands following `nomarchy-<category>-<action>` pattern.
-
-```bash
-# List all nomarchy commands
-compgen -c | grep -E '^nomarchy-' | sort -u
-
-# Find commands by category
-compgen -c | grep -E '^nomarchy-theme'
-compgen -c | grep -E '^nomarchy-restart'
-
-# Read a command's source to understand it
-cat $(which nomarchy-theme-set)
-```
-
-### Command Categories
-
-| Prefix | Purpose | Example |
-|--------|---------|---------|
-| `nomarchy-refresh-*` | Reset config to defaults (backs up first) | `nomarchy-refresh-waybar` |
-| `nomarchy-restart-*` | Restart a service/app | `nomarchy-restart-waybar` |
-| `nomarchy-toggle-*` | Toggle feature on/off | `nomarchy-toggle-nightlight` |
-| `nomarchy-theme-*` | Theme management | `nomarchy-theme-set <name>` |
-| `nomarchy-install-*` | Install optional software | `nomarchy-install-docker-dbs` |
-| `nomarchy-launch-*` | Launch apps | `nomarchy-launch-browser` |
-| `nomarchy-cmd-*` | System commands | `nomarchy-cmd-screenshot` |
-| `nomarchy-pkg-*` | Package management | `nomarchy-pkg-add <pkg>` |
-| `nomarchy-setup-*` | Initial setup tasks | `nomarchy-setup-fingerprint` |
-| `nomarchy-update-*` | System updates | `nomarchy-update` |
-
-## Configuration Locations
-
-### Hyprland (Window Manager)
-
-```
-~/.config/hypr/
-├── hyprland.conf      # Main config (sources others)
-├── bindings.conf      # Keybindings
-├── monitors.conf      # Display configuration
-├── input.conf         # Keyboard/mouse settings
-├── looknfeel.conf     # Appearance (gaps, borders, animations)
-├── envs.conf          # Environment variables
-├── autostart.conf     # Startup applications
-├── hypridle.conf      # Idle behavior (screen off, lock, suspend)
-├── hyprlock.conf      # Lock screen appearance
-└── hyprsunset.conf    # Night light / blue light filter
-```
-
-**Key behaviors:**
-- Hyprland auto-reloads on config save (no restart needed for most changes)
-- Use `hyprctl reload` to force reload
-- Use `nomarchy-refresh-hyprland` to reset to defaults
-
-### Waybar (Status Bar)
-
-```
-~/.config/waybar/
-├── config.jsonc       # Bar layout and modules (JSONC format)
-└── style.css          # Styling
-```
-
-**Waybar does NOT auto-reload.** You MUST run `nomarchy-restart-waybar` after any config changes.
-
-**Commands:** `nomarchy-restart-waybar`, `nomarchy-refresh-waybar`, `nomarchy-toggle-waybar`
-
-### Terminals
-
-```
-~/.config/alacritty/alacritty.toml
-~/.config/kitty/kitty.conf
-~/.config/ghostty/config
-```
-
-**Command:** `nomarchy-restart-terminal`
-
-### Other Configs
-
-| App | Location |
-|-----|----------|
-| btop | `~/.config/btop/btop.conf` |
-| fastfetch | `~/.config/fastfetch/config.jsonc` |
-| lazygit | `~/.config/lazygit/config.yml` |
-| starship | `~/.config/starship.toml` |
-| git | `~/.config/git/config` |
-| walker | `~/.config/walker/config.toml` |
-
-## Safe Customization Patterns
-
-### Pattern 1: Edit User Config Directly
-
-For simple changes, edit files in `~/.config/`:
-
-```bash
-# 1. Read current config
-cat ~/.config/hypr/bindings.conf
-
-# 2. Backup before changes
-cp ~/.config/hypr/bindings.conf ~/.config/hypr/bindings.conf.bak.$(date +%s)
-
-# 3. Make changes with Edit tool
-
-# 4. Apply changes
-# - Hyprland: auto-reloads on save (no restart needed)
-# - Waybar: MUST restart with nomarchy-restart-waybar
-# - Walker: MUST restart with nomarchy-restart-walker
-# - Terminals: MUST restart with nomarchy-restart-terminal
-```
-
-### Pattern 2: Make a new theme
-
-1. Create a directory under ~/.config/nomarchy/themes.
-2. See how an existing theme is done via ~/.local/share/nomarchy/themes/catppuccin.
-3. Download a matching background (or several) from the internet and put them in ~/.config/nomarchy/themes/[name-of-new-theme]
-4. When done with the theme, run nomarchy-theme-set "Name of new theme"
-
-### Pattern 3: Use Hooks for Automation
-
-Create scripts in `~/.config/nomarchy/hooks/` to run automatically on events:
-
-```bash
-# Available hooks (see samples in ~/.config/nomarchy/hooks/):
-~/.config/nomarchy/hooks/
-├── theme-set        # Runs after theme change (receives theme name as $1)
-├── font-set         # Runs after font change
-└── post-update      # Runs after nomarchy-update
-```
-
-Example hook (`~/.config/nomarchy/hooks/theme-set`):
-```bash
-#!/bin/bash
-THEME_NAME=$1
-echo "Theme changed to: $THEME_NAME"
-# Add custom actions here
-```
-
-### Pattern 4: Reset to Defaults -- ALWAYS SEEK USER CONFIRMATION BEFORE RUNNING
-
-When customizations go wrong:
-
-```bash
-# Reset specific config (creates backup automatically)
-nomarchy-refresh-waybar
-nomarchy-refresh-hyprland
-
-# The refresh command:
-# 1. Backs up current config with timestamp
-# 2. Copies default from ~/.local/share/nomarchy/config/
-# 3. Restarts the component
-```
-
-## Common Tasks
-
-### Themes
-
-```bash
-nomarchy-theme-list              # Show available themes
-nomarchy-theme-current           # Show current theme
-nomarchy-theme-set <name>        # Apply theme (use "Tokyo Night" not "tokyo-night")
-nomarchy-theme-next              # Cycle to next theme
-nomarchy-theme-bg-next           # Cycle wallpaper
-nomarchy-theme-install <url>     # Install from git repo
-nomarchy-theme-remove <name>     # Remove an installed extra theme
-nomarchy-theme-refresh           # Re-apply current theme from templates
-nomarchy-theme-bg-install        # Open backgrounds dir to drop in custom images
-```
-
-### Keybindings
-
-Edit `~/.config/hypr/bindings.conf`. Format:
-```
-bind = SUPER, Return, exec, xdg-terminal-exec
-bind = SUPER, Q, killactive
-bind = SUPER SHIFT, E, exit
-```
-
-View current bindings: `nomarchy-menu-keybindings --print`
-
-**IMPORTANT: When re-binding an existing key:**
-
-1. First check existing bindings: `nomarchy-menu-keybindings --print`
-2. If the key is already bound, you MUST add an `unbind` directive BEFORE your new `bind`
-3. Inform the user what the key was previously bound to
-
-Example - rebinding SUPER+F (which is bound to fullscreen by default):
-```
-# Unbind existing SUPER+F (was: fullscreen)
-unbind = SUPER, F
-# New binding for file manager
-bind = SUPER, F, exec, nautilus
-```
-
-Always tell the user: "Note: SUPER+F was previously bound to fullscreen. I've added an unbind directive to override it."
-
-### Display/Monitors
-
-Edit `~/.config/hypr/monitors.conf`. Format:
-```
-monitor = eDP-1, 1920x1080@60, 0x0, 1
-monitor = HDMI-A-1, 2560x1440@144, 1920x0, 1
-```
-
-List monitors: `hyprctl monitors`
-
-### Window Rules
-
-**CRITICAL: Hyprland window rules syntax changes frequently between versions.**
-
-Before writing ANY window rules, you MUST fetch the current documentation from the official Hyprland wiki:
-- https://github.com/hyprwm/hyprland-wiki/blob/main/content/Configuring/Window-Rules.md
-
-DO NOT rely on cached or memorized window rule syntax. The format has changed multiple times and using outdated syntax will cause errors or unexpected behavior.
-
-Window rules go in `~/.config/hypr/hyprland.conf` or a sourced file. Always verify the current syntax from the wiki first.
-
-### Fonts
-
-```bash
-nomarchy-font-list               # Available fonts
-nomarchy-font-current            # Current font
-nomarchy-font-set <name>         # Change font
-```
-
-### System
-
-```bash
-nomarchy-update                  # Full system update
-nomarchy-version                 # Show Nomarchy version
-nomarchy-debug --no-sudo --print # Debug info (ALWAYS use these flags)
-nomarchy-lock-screen             # Lock screen
-nomarchy-system-shutdown         # Shutdown
-nomarchy-system-reboot           # Reboot
-nomarchy-sudo-passwordless-toggle # Toggle 15-min passwordless sudo
-nomarchy-sudo-reset              # Clear sudo lockout / faillock
-nomarchy-restart-trackpad        # Reload intel_quicki2c (fixes dead THC trackpad)
-```
-
-**IMPORTANT:** Always run `nomarchy-debug` with `--no-sudo --print` flags to avoid interactive sudo prompts that will hang the terminal.
-
-### Custom App Launchers
-
-```bash
-nomarchy-webapp-install                  # Add a web app launcher (interactive)
-nomarchy-webapp-remove [name...]         # Remove web apps (interactive if no name)
-nomarchy-webapp-remove-all               # Bulk-remove every web app
-nomarchy-tui-install                     # Add a TUI launcher for a terminal program
-nomarchy-tui-remove [name...]            # Remove TUI launchers
-nomarchy-tui-remove-all                  # Bulk-remove every TUI launcher
-```
-
-Both families write `.desktop` files into `~/.local/share/applications/` so they appear in the app launcher (walker / rofi).
-
-### Virtualization
-
-```bash
-nomarchy-windows-vm install              # Provision a Windows VM via docker-compose
-nomarchy-windows-vm launch               # Connect to the VM (auto-stop on disconnect)
-nomarchy-windows-vm launch -k            # Connect, keep VM running after disconnect
-nomarchy-windows-vm stop                 # Shut the VM down
-nomarchy-windows-vm status               # Show current state
-```
-
-Requires KVM (`/dev/kvm`) and Docker (enable via `nomarchy.system.virtualization.docker`).
-
-## Troubleshooting
-
-```bash
-# Get debug information (ALWAYS use these flags to avoid interactive prompts)
-nomarchy-debug --no-sudo --print
-
-# Upload logs for support
-nomarchy-upload-log
-
-# Reset specific config to defaults
-# Examples: nomarchy-refresh-fastfetch, nomarchy-refresh-hyprland, nomarchy-refresh-waybar
-nomarchy-refresh-<app>
-
-# Refresh specific config file
-# config-file path is relative to ~/.config/; the stock copy must exist under
-# ~/.local/share/nomarchy/config/ (i.e. a core/home/config item).
-# eg. nomarchy-refresh-config fastfetch/config.jsonc refreshes ~/.config/fastfetch/config.jsonc
-nomarchy-refresh-config <config-file>
-
-# Full reinstall of configs (nuclear option)
-nomarchy-reinstall
-```
-
-## Decision Framework
-
-When user requests system changes:
-
-1. **Is it a stock nomarchy command?** Use it directly
-2. **Is it a config edit?** Edit in `~/.config/`, never `~/.local/share/nomarchy/`
-3. **Is it a theme customization?** Create a NEW custom theme directory
-4. **Is it automation?** Use hooks in `~/.config/nomarchy/hooks/`
-5. **Is it a package install?** Use `nomarchy-pkg-add` (adds to `user-packages.json`; rebuild applies it). The AUR does not exist on NixOS — search nixpkgs with `nix search nixpkgs <name>`.
-6. **Unsure if command exists?** Search with `compgen -c | grep nomarchy`
-
-## Out of Scope
-
-This skill intentionally does not cover Nomarchy source development. Do not use this skill for:
-- Editing files in `~/.local/share/nomarchy/` (`bin/`, `config/`, `default/`, `themes/`, `migrations/`, etc.)
-- Creating or editing migrations
-- Modifying Nomarchy's own source tree
-
-## Example Requests
-
-- "Change my theme to catppuccin" -> `nomarchy-theme-set catppuccin`
-- "Add a keybinding for Super+E to open file manager" -> Check existing bindings first, add `unbind` if needed, then add `bind` in `~/.config/hypr/bindings.conf`
-- "Configure my external monitor" -> Edit `~/.config/hypr/monitors.conf`
-- "Make the window gaps smaller" -> Edit `~/.config/hypr/looknfeel.conf`
-- "Set up night light to turn on at sunset" -> `nomarchy-toggle-nightlight` or edit `~/.config/hypr/hyprsunset.conf`
-- "Customize the catppuccin theme colors" -> Create `~/.config/nomarchy/themes/catppuccin-custom/` by copying from stock, then edit
-- "Run a script every time I change themes" -> Create `~/.config/nomarchy/hooks/theme-set`
-- "Reset waybar to defaults" -> `nomarchy-refresh-waybar`

core/home/config/nomarchy/default/alacritty/screensaver.toml

@@ -1,11 +0,0 @@
-[colors.primary]
-background = "0x000000"
-
-[colors.cursor]
-cursor = "0x000000"
-
-[font]
-size = 18.0
-
-[window]
-opacity = 1.0

core/home/config/nomarchy/default/bash/aliases

@@ -1,57 +0,0 @@
-# File system
-if command -v eza &> /dev/null; then
-  alias ls='eza -lh --group-directories-first --icons=auto'
-  alias lsa='ls -a'
-  alias lt='eza --tree --level=2 --long --icons --git'
-  alias lta='lt -a'
-fi
-
-if [[ "$TERM" == "xterm-kitty" ]]; then
-  alias ff="fzf --preview 'case \$(file --mime-type -b {}) in image/*) kitty icat --clear --transfer-mode=memory --stdin=no --place=\${FZF_PREVIEW_COLUMNS}x\${FZF_PREVIEW_LINES}@0x0 {} ;; *) bat --style=numbers --color=always {} ;; esac'"
-else
-  alias ff="fzf --preview 'bat --style=numbers --color=always {}'"
-fi
-alias eff='$EDITOR "$(ff)"'
-sff() { if [ $# -eq 0 ]; then echo "Usage: sff <destination> (e.g. sff host:/tmp/)"; return 1; fi; local file; file=$(find . -type f -printf '%T@\t%p\n' | sort -rn | cut -f2- | ff) && [ -n "$file" ] && scp "$file" "$1"; }
-
-if command -v zoxide &> /dev/null; then
-  alias cd="zd"
-  zd() {
-    if (( $# == 0 )); then
-      builtin cd ~ || return
-    elif [[ -d $1 ]]; then
-      builtin cd "$1" || return
-    else
-      if ! z "$@"; then
-        echo "Error: Directory not found"
-        return 1
-      fi
-
-      printf "\U000F17A9 "
-      pwd
-    fi
-  }
-fi
-
-open() (
-  xdg-open "$@" >/dev/null 2>&1 &
-)
-
-# Directories
-alias ..='cd ..'
-alias ...='cd ../..'
-alias ....='cd ../../..'
-
-# Tools
-alias c='opencode'
-alias cx='printf "\033[2J\033[3J\033[H" && claude --allow-dangerously-skip-permissions'
-alias d='docker'
-alias r='rails'
-alias t='tmux attach || tmux new -s Work'
-n() { if [ "$#" -eq 0 ]; then command nvim . ; else command nvim "$@"; fi; }
-
-# Git
-alias g='git'
-alias gcm='git commit -m'
-alias gcam='git commit -a -m'
-alias gcad='git commit -a --amend'

core/home/config/nomarchy/default/bash/envs

@@ -1,6 +0,0 @@
-# Editor used by CLI
-export SUDO_EDITOR="$EDITOR"
-export BAT_THEME=ansi
-
-# Duplicated from .config/uwsm/env so SSH works too
-export PATH=$PATH:$HOME/.local/bin

core/home/config/nomarchy/default/bash/fns/compression

@@ -1,3 +0,0 @@
-# Compression
-compress() { tar -czf "${1%/}.tar.gz" "${1%/}"; }
-alias decompress="tar -xzf"

core/home/config/nomarchy/default/bash/fns/drives

@@ -1,59 +0,0 @@
-# Write iso file to sd card
-iso2sd() {
-  if (( $# < 1 )); then
-    echo "Usage: iso2sd <input_file> [output_device]"
-    echo "Example: iso2sd ~/Downloads/ubuntu-25.04-desktop-amd64.iso /dev/sda"
-    return 1
-  fi
-
-  local iso="$1"
-  local drive="$2"
-
-  if [[ -z $drive ]]; then
-    local available_sds=$(lsblk -dpno NAME | grep -E '/dev/sd')
-
-    if [[ -z $available_sds ]]; then
-      echo "No SD drives found and no drive specified"
-      return 1
-    fi
-
-    drive=$(nomarchy-drive-select "$available_sds")
-
-    if [[ -z $drive ]]; then
-      echo "No drive selected"
-      return 1
-    fi
-  fi
-
-  sudo dd bs=4M status=progress oflag=sync if="$iso" of="$drive"
-  sudo eject "$drive"
-}
-
-# Format an entire drive for a single partition using exFAT
-format-drive() {
-  if (( $# != 2 )); then
-    echo "Usage: format-drive <device> <name>"
-    echo "Example: format-drive /dev/sda 'My Stuff'"
-    echo -e "\nAvailable drives:"
-    lsblk -d -o NAME -n | awk '{print "/dev/"$1}'
-  else
-    echo "WARNING: This will completely erase all data on $1 and label it '$2'."
-    read -rp "Are you sure you want to continue? (y/N): " confirm
-
-    if [[ $confirm =~ ^[Yy]$ ]]; then
-      sudo wipefs -a "$1"
-      sudo dd if=/dev/zero of="$1" bs=1M count=100 status=progress
-      sudo parted -s "$1" mklabel gpt
-      sudo parted -s "$1" mkpart primary 1MiB 100%
-      sudo parted -s "$1" set 1 msftdata on
-
-      partition="$([[ $1 == *"nvme"* ]] && echo "${1}p1" || echo "${1}1")"
-      sudo partprobe "$1" || true
-      sudo udevadm settle || true
-
-      sudo mkfs.exfat -n "$2" "$partition"
-
-      echo "Drive $1 formatted as exFAT and labeled '$2'."
-    fi
-  fi
-}

core/home/config/nomarchy/default/bash/fns/ssh-port-forwarding

@@ -1,20 +0,0 @@
-# SSH Port Forwarding Functions
-fip() {
-  (( $# < 2 )) && echo "Usage: fip <host> <port1> [port2] ..." && return 1
-  local host="$1"
-  shift
-  for port in "$@"; do
-    ssh -f -N -L "$port:localhost:$port" "$host" && echo "Forwarding localhost:$port -> $host:$port"
-  done
-}
-
-dip() {
-  (( $# == 0 )) && echo "Usage: dip <port1> [port2] ..." && return 1
-  for port in "$@"; do
-    pkill -f "ssh.*-L $port:localhost:$port" && echo "Stopped forwarding port $port" || echo "No forwarding on port $port"
-  done
-}
-
-lip() {
-  pgrep -af "ssh.*-L [0-9]+:localhost:[0-9]+" || echo "No active forwards"
-}

core/home/config/nomarchy/default/bash/fns/tmux

@@ -1,97 +0,0 @@
-# Create a Tmux Dev Layout with editor, ai, and terminal
-# Usage: tdl <c|cx|codex|other_ai> [<second_ai>]
-tdl() {
-  [[ -z $1 ]] && { echo "Usage: tdl <c|cx|codex|other_ai> [<second_ai>]"; return 1; }
-  [[ -z $TMUX ]] && { echo "You must start tmux to use tdl."; return 1; }
-
-  local current_dir="${PWD}"
-  local editor_pane ai_pane ai2_pane
-  local ai="$1"
-  local ai2="$2"
-
-  # Use TMUX_PANE for the pane we're running in (stable even if active window changes)
-  editor_pane="$TMUX_PANE"
-
-  # Name the current window after the base directory name
-  tmux rename-window -t "$editor_pane" "$(basename "$current_dir")"
-
-  # Split window vertically - top 85%, bottom 15% (target editor pane explicitly)
-  tmux split-window -v -p 15 -t "$editor_pane" -c "$current_dir"
-
-  # Split editor pane horizontally - AI on right 30% (capture new pane ID directly)
-  ai_pane=$(tmux split-window -h -p 30 -t "$editor_pane" -c "$current_dir" -P -F '#{pane_id}')
-
-  # If second AI provided, split the AI pane vertically
-  if [[ -n $ai2 ]]; then
-    ai2_pane=$(tmux split-window -v -t "$ai_pane" -c "$current_dir" -P -F '#{pane_id}')
-    tmux send-keys -t "$ai2_pane" "$ai2" C-m
-  fi
-
-  # Run ai in the right pane
-  tmux send-keys -t "$ai_pane" "$ai" C-m
-
-  # Run nvim in the left pane
-  tmux send-keys -t "$editor_pane" "$EDITOR ." C-m
-
-  # Select the nvim pane for focus
-  tmux select-pane -t "$editor_pane"
-}
-
-# Create multiple tdl windows with one per subdirectory in the current directory
-# Usage: tdlm <c|cx|codex|other_ai> [<second_ai>]
-tdlm() {
-  [[ -z $1 ]] && { echo "Usage: tdlm <c|cx|codex|other_ai> [<second_ai>]"; return 1; }
-  [[ -z $TMUX ]] && { echo "You must start tmux to use tdlm."; return 1; }
-
-  local ai="$1"
-  local ai2="$2"
-  local base_dir="$PWD"
-  local first=true
-
-  # Rename the session to the current directory name (replace dots/colons which tmux disallows)
-  tmux rename-session "$(basename "$base_dir" | tr '.:' '--')"
-
-  for dir in "$base_dir"/*/; do
-    [[ -d $dir ]] || continue
-    local dirpath="${dir%/}"
-
-    if $first; then
-      # Reuse the current window for the first project
-      tmux send-keys -t "$TMUX_PANE" "cd '$dirpath' && tdl $ai $ai2" C-m
-      first=false
-    else
-      local pane_id=$(tmux new-window -c "$dirpath" -P -F '#{pane_id}')
-      tmux send-keys -t "$pane_id" "tdl $ai $ai2" C-m
-    fi
-  done
-}
-
-# Create a multi-pane swarm layout with the same command started in each pane (great for AI)
-# Usage: tsl <pane_count> <command>
-tsl() {
-  [[ -z $1 || -z $2 ]] && { echo "Usage: tsl <pane_count> <command>"; return 1; }
-  [[ -z $TMUX ]] && { echo "You must start tmux to use tsl."; return 1; }
-
-  local count="$1"
-  local cmd="$2"
-  local current_dir="${PWD}"
-  local -a panes
-
-  tmux rename-window -t "$TMUX_PANE" "$(basename "$current_dir")"
-
-  panes+=("$TMUX_PANE")
-
-  while (( ${#panes[@]} < count )); do
-    local new_pane
-    local split_target="${panes[-1]}"
-    new_pane=$(tmux split-window -h -t "$split_target" -c "$current_dir" -P -F '#{pane_id}')
-    panes+=("$new_pane")
-    tmux select-layout -t "${panes[0]}" tiled
-  done
-
-  for pane in "${panes[@]}"; do
-    tmux send-keys -t "$pane" "$cmd" C-m
-  done
-
-  tmux select-pane -t "${panes[0]}"
-}

core/home/config/nomarchy/default/bash/fns/transcoding

@@ -1,53 +0,0 @@
-# Transcode a video to a good-balance 1080p that's great for sharing online
-transcode-video-1080p() {
-  ffmpeg -i "$1" -vf scale=1920:1080 -c:v libx264 -preset fast -crf 23 -c:a copy "${1%.*}-1080p.mp4"
-}
-
-# Transcode a video to a good-balance 4K that's great for sharing online
-transcode-video-4K() {
-  ffmpeg -i "$1" -c:v libx265 -preset slow -crf 24 -c:a aac -b:a 192k "${1%.*}-optimized.mp4"
-}
-
-# Transcode any image to JPG image that's great for shrinking wallpapers
-img2jpg() {
-  img="$1"
-  shift
-
-  magick "$img" "$@" -quality 85 -strip "${img%.*}-converted.jpg"
-}
-
-# Transcode any image to a small JPG (max 1080px wide)
-img2jpg-small() {
-  img="$1"
-  shift
-
-  magick "$img" "$@" -resize 1080x\> -quality 85 -strip "${img%.*}-small.jpg"
-}
-
-# Transcode any image to a 4K JPG (max 2160px wide)
-img2jpg-medium() {
-  img="$1"
-  shift
-
-  magick "$img" "$@" -resize 2160x\> -quality 85 -strip "${img%.*}-medium.jpg"
-}
-
-# Transcode any image to a 6K JPG (max 3160px wide)
-img2jpg-large() {
-  img="$1"
-  shift
-
-  magick "$img" "$@" -resize 3160x\> -quality 85 -strip "${img%.*}-large.jpg"
-}
-
-# Transcode any image to compressed-but-lossless PNG
-img2png() {
-  img="$1"
-  shift
-
-  magick "$img" "$@" -strip -define png:compression-filter=5 \
-    -define png:compression-level=9 \
-    -define png:compression-strategy=1 \
-    -define png:exclude-chunk=all \
-    "${img%.*}-optimized.png"
-}

core/home/config/nomarchy/default/bash/fns/worktrees

@@ -1,36 +0,0 @@
-# Create a new worktree and branch from within current git directory.
-ga() {
-  if [[ -z "$1" ]]; then
-    echo "Usage: ga [branch name]"
-    return 1
-  fi
-
-  local branch="$1"
-  local base="$(basename "$PWD")"
-  local wt_path="../${base}--${branch}"
-
-  git worktree add -b "$branch" "$wt_path"
-  mise trust "$wt_path"
-  cd "$wt_path"
-}
-
-# Remove worktree and branch from within active worktree directory.
-gd() {
-  if gum confirm "Remove worktree and branch?"; then
-    local cwd base branch root worktree
-
-    cwd="$(pwd)"
-    worktree="$(basename "$cwd")"
-
-    # split on first `--`
-    root="${worktree%%--*}"
-    branch="${worktree#*--}"
-
-    # Protect against accidentally nuking a non-worktree directory
-    if [[ "$root" != "$worktree" ]]; then
-      cd "../$root"
-      git worktree remove "$cwd" --force || return 1
-      git branch -D "$branch"
-    fi
-  fi
-}

core/home/config/nomarchy/default/bash/functions

@@ -1 +0,0 @@
-for f in $HOME/.config/nomarchy/default/bash/fns/*; do source "$f"; done

core/home/config/nomarchy/default/bash/init

@@ -1,24 +0,0 @@
-if command -v mise &> /dev/null; then
-  eval "$(mise activate bash)"
-fi
-
-if command -v starship &> /dev/null; then
-  eval "$(starship init bash)"
-fi
-
-if command -v zoxide &> /dev/null; then
-  eval "$(zoxide init bash)"
-fi
-
-if command -v try &> /dev/null; then
-  eval "$(SHELL=/bin/bash command try init ~/Work/tries)"
-fi
-
-if command -v fzf &> /dev/null; then
-  if [[ -f /usr/share/fzf/completion.bash ]]; then
-    source /usr/share/fzf/completion.bash
-  fi
-  if [[ -f /usr/share/fzf/key-bindings.bash ]]; then
-    source /usr/share/fzf/key-bindings.bash
-  fi
-fi

core/home/config/nomarchy/default/bash/inputrc

@@ -1,47 +0,0 @@
-set meta-flag on
-set input-meta on
-set output-meta on
-set convert-meta off
-set completion-ignore-case on
-set completion-prefix-display-length 2
-set show-all-if-ambiguous on
-set show-all-if-unmodified on
-
-# Arrow keys match what you've typed so far against your command history
-"\e[A": history-search-backward
-"\e[B": history-search-forward
-"\e[C": forward-char
-"\e[D": backward-char
-
-# Immediately add a trailing slash when autocompleting symlinks to directories
-set mark-symlinked-directories on
-
-# Do not autocomplete hidden files unless the pattern explicitly begins with a dot
-set match-hidden-files off
-
-# Show all autocomplete results at once
-set page-completions off
-
-# If there are more than 200 possible completions for a word, ask to show them all
-set completion-query-items 200
-
-# Show extra file information when completing, like `ls -F` does
-set visible-stats on
-
-# Be more intelligent when autocompleting by also looking at the text after
-# the cursor. For example, when the current line is "cd ~/src/mozil", and
-# the cursor is on the "z", pressing Tab will not autocomplete it to "cd
-# ~/src/mozillail", but to "cd ~/src/mozilla". (This is supported by the
-# Readline used by Bash 4.)
-set skip-completed-text on
-
-# Coloring for Bash 4 tab completions.
-set colored-stats on
-
-# Cycle forward and backward through completion candidates (tab/shift+tab)
-# (completion listing and display behavior configured above)
-TAB: menu-complete
-"\e[Z": menu-complete-backward
-
-# On first Tab, complete the common prefix before cycling candidates
-set menu-complete-display-prefix on

core/home/config/nomarchy/default/bash/rc

@@ -1,6 +0,0 @@
-source ~/.config/nomarchy/default/bash/envs
-source ~/.config/nomarchy/default/bash/shell
-source ~/.config/nomarchy/default/bash/aliases
-source ~/.config/nomarchy/default/bash/functions
-source ~/.config/nomarchy/default/bash/init
-[[ $- == *i* ]] && bind -f ~/.config/nomarchy/default/bash/inputrc

core/home/config/nomarchy/default/bash/shell

@@ -1,13 +0,0 @@
-# History control
-shopt -s histappend
-HISTCONTROL=ignoreboth
-HISTSIZE=32768
-HISTFILESIZE="${HISTSIZE}"
-
-# Autocompletion
-if [[ ! -v BASH_COMPLETION_VERSINFO && -f /usr/share/bash-completion/bash_completion ]]; then
-  source /usr/share/bash-completion/bash_completion
-fi
-
-# Ensure command hashing is off for mise
-set +h

core/home/config/nomarchy/default/chromium/extensions/copy-url/background.js

@@ -1,21 +0,0 @@
-chrome.commands.onCommand.addListener((command) => {
-  if (command === 'copy-url') {
-    chrome.tabs.query({ active: true, currentWindow: true }, (tabs) => {
-      const currentTab = tabs[0];
-
-      chrome.scripting.executeScript({
-        target: { tabId: currentTab.id },
-        func: () => {
-          navigator.clipboard.writeText(window.location.href);
-        }
-      }).then(() => {
-        chrome.notifications.create({
-          type: 'basic',
-          iconUrl: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg==',
-          title: '   URL copied to clipboard',
-          message: ''
-        });
-      });
-    });
-  }
-});

core/home/config/nomarchy/default/chromium/extensions/copy-url/icon.png

@@ -1 +0,0 @@
-../../../../icon.png

core/home/config/nomarchy/default/chromium/extensions/copy-url/manifest.json

@@ -1,19 +0,0 @@
-{
-  "manifest_version": 3,
-  "name": "Copy URL",
-  "version": "1.0",
-  "description": "Copy current URL to clipboard, this extension is installed by Nomarchy",
-  "permissions": ["activeTab", "scripting", "notifications"],
-  "icons": {
-    "16": "icon.png",
-    "48": "icon.png",
-    "128": "icon.png"
-  },
-  "commands": {
-    "copy-url": {
-      "suggested_key": {"default": "Alt+Shift+L"},
-      "description": "Copy URL"
-    }
-  },
-  "background": {"service_worker": "background.js"}
-}

core/home/config/nomarchy/default/ghostty/screensaver

@@ -1,3 +0,0 @@
-window-padding-x = 0
-window-padding-y = 0
-window-padding-color = "extend-always"

core/home/config/nomarchy/default/gpg/dirmngr.conf

@@ -1,7 +0,0 @@
-keyserver hkps://keyserver.ubuntu.com
-keyserver hkps://pgp.surfnet.nl
-keyserver hkps://keys.mailvelope.com
-keyserver hkps://keyring.debian.org
-keyserver hkps://pgp.mit.edu
-
-connect-quick-timeout 4

core/home/config/nomarchy/default/hypr/apps.conf

@@ -1,19 +0,0 @@
-# App-specific tweaks. All rules are class- or title-gated, so sourcing
-# unconditionally is harmless when the app isn't installed or running.
-source = ~/.config/nomarchy/default/hypr/apps/1password.conf
-source = ~/.config/nomarchy/default/hypr/apps/bitwarden.conf
-source = ~/.config/nomarchy/default/hypr/apps/browser.conf
-source = ~/.config/nomarchy/default/hypr/apps/davinci-resolve.conf
-source = ~/.config/nomarchy/default/hypr/apps/geforce.conf
-source = ~/.config/nomarchy/default/hypr/apps/hyprshot.conf
-source = ~/.config/nomarchy/default/hypr/apps/localsend.conf
-source = ~/.config/nomarchy/default/hypr/apps/moonlight.conf
-source = ~/.config/nomarchy/default/hypr/apps/pip.conf
-source = ~/.config/nomarchy/default/hypr/apps/qemu.conf
-source = ~/.config/nomarchy/default/hypr/apps/retroarch.conf
-source = ~/.config/nomarchy/default/hypr/apps/steam.conf
-source = ~/.config/nomarchy/default/hypr/apps/system.conf
-source = ~/.config/nomarchy/default/hypr/apps/telegram.conf
-source = ~/.config/nomarchy/default/hypr/apps/terminals.conf
-source = ~/.config/nomarchy/default/hypr/apps/walker.conf
-source = ~/.config/nomarchy/default/hypr/apps/webcam-overlay.conf

core/home/config/nomarchy/default/hypr/apps/1password.conf

@@ -1,2 +0,0 @@
-windowrulev2 = noscreenshare, class:^(1[p|P]assword)$
-windowrulev2 = tag +floating-window, class:^(1[p|P]assword)$

core/home/config/nomarchy/default/hypr/apps/bitwarden.conf

@@ -1,6 +0,0 @@
-windowrulev2 = noscreenshare, class:^(Bitwarden)$
-windowrulev2 = tag +floating-window, class:^(Bitwarden)$
-
-# Bitwarden Chrome Extension
-windowrulev2 = noscreenshare, class:chrome-nngceckbapebfimnlniiiahkandclblb-Default
-windowrulev2 = tag +floating-window, class:chrome-nngceckbapebfimnlniiiahkandclblb-Default

core/home/config/nomarchy/default/hypr/apps/browser.conf

@@ -1,16 +0,0 @@
-# Browser types
-windowrulev2 = tag +chromium-based-browser, class:((google-)?[cC]hrom(e|ium)|[bB]rave-browser|[mM]icrosoft-edge|Vivaldi-stable|helium)
-windowrulev2 = tag +firefox-based-browser, class:([fF]irefox|zen|librewolf)
-windowrulev2 = tag -default-opacity, tag:chromium-based-browser
-windowrulev2 = tag -default-opacity, tag:firefox-based-browser
-
-# Video apps: remove chromium browser tag so they don't get opacity applied
-windowrulev2 = tag -chromium-based-browser, class:(chrome-youtube.com__-Default|chrome-app.zoom.us__wc_home-Default)
-windowrulev2 = tag -default-opacity, class:(chrome-youtube.com__-Default|chrome-app.zoom.us__wc_home-Default)
-
-# Force chromium-based browsers into a tile to deal with --app bug
-windowrulev2 = tile, tag:chromium-based-browser
-
-# Only a subtle opacity change, but not for video sites
-windowrulev2 = opacity 1.0 0.97, tag:chromium-based-browser
-windowrulev2 = opacity 1.0 0.97, tag:firefox-based-browser

core/home/config/nomarchy/default/hypr/apps/davinci-resolve.conf

@@ -1,2 +0,0 @@
-# Focus floating DaVinci Resolve dialog windows
-windowrulev2 = stayfocused, class:.*[Rr]esolve.*, float:1

core/home/config/nomarchy/default/hypr/apps/geforce.conf

@@ -1 +0,0 @@
-windowrulev2 = idleinhibit fullscreen, class:^(GeForceNOW)$

core/home/config/nomarchy/default/hypr/apps/hyprshot.conf

@@ -1,2 +0,0 @@
-# Remove 1px border around hyprshot screenshots
-layerrule = noanim, namespace:selection

core/home/config/nomarchy/default/hypr/apps/localsend.conf

@@ -1,4 +0,0 @@
-# Float LocalSend and fzf file picker
-windowrulev2 = float, class:(Share|localsend)
-windowrulev2 = center, class:(Share|localsend)
-windowrulev2 = size 1100 700, class:localsend

core/home/config/nomarchy/default/hypr/apps/moonlight.conf

@@ -1,2 +0,0 @@
-windowrulev2 = fullscreen, class:^(com.moonlight_stream.Moonlight)$
-windowrulev2 = idleinhibit fullscreen, class:^(com.moonlight_stream.Moonlight)$

core/home/config/nomarchy/default/hypr/apps/pip.conf

@@ -1,10 +0,0 @@
-# Picture-in-picture overlays
-windowrulev2 = tag +pip, title:(Picture.?in.?[Pp]icture)
-windowrulev2 = tag -default-opacity, tag:pip
-windowrulev2 = float, tag:pip
-windowrulev2 = pin, tag:pip
-windowrulev2 = size 600 338, tag:pip
-windowrulev2 = keepaspectratio, tag:pip
-windowrulev2 = bordersize 0, tag:pip
-windowrulev2 = opacity 1 1, tag:pip
-windowrulev2 = move (monitor_w-window_w-40) (monitor_h*0.04), tag:pip

core/home/config/nomarchy/default/hypr/apps/qemu.conf

@@ -1,2 +0,0 @@
-windowrulev2 = tag -default-opacity, class:qemu
-windowrulev2 = opacity 1 1, class:qemu

core/home/config/nomarchy/default/hypr/apps/retroarch.conf

@@ -1,4 +0,0 @@
-windowrulev2 = fullscreen, class:com.libretro.RetroArch
-windowrulev2 = tag -default-opacity, class:com.libretro.RetroArch
-windowrulev2 = opacity 1 1, class:com.libretro.RetroArch
-windowrulev2 = idleinhibit fullscreen, class:com.libretro.RetroArch

core/home/config/nomarchy/default/hypr/apps/steam.conf

@@ -1,8 +0,0 @@
-# Float Steam
-windowrulev2 = float, class:steam
-windowrulev2 = center, class:steam, title:Steam
-windowrulev2 = tag -default-opacity, class:steam.*
-windowrulev2 = opacity 1 1, class:steam.*
-windowrulev2 = size 1100 700, class:steam, title:Steam
-windowrulev2 = size 460 800, class:steam, title:Friends List
-windowrulev2 = idleinhibit fullscreen, class:steam

core/home/config/nomarchy/default/hypr/apps/system.conf

@@ -1,23 +0,0 @@
-# Floating windows
-windowrulev2 = float, tag:floating-window
-windowrulev2 = center, tag:floating-window
-windowrulev2 = size 875 600, tag:floating-window
-
-windowrulev2 = tag +floating-window, class:(org.nomarchy.bluetui|org.nomarchy.impala|org.nomarchy.wiremix|org.nomarchy.btop|org.nomarchy.terminal|org.nomarchy.bash|org.gnome.NautilusPreviewer|org.gnome.Evince|com.gabm.satty|Nomarchy|About|TUI.float|imv|mpv)
-windowrulev2 = tag +floating-window, class:(xdg-desktop-portal-gtk|sublime_text|DesktopEditors|org.gnome.Nautilus), title:^(Open.*Files?|Open [F|f]older.*|Save.*Files?|Save.*As|Save|All Files|.*wants to [open|save].*|[C|c]hoose.*)
-windowrulev2 = float, class:org.gnome.Calculator
-
-# Fullscreen screensaver
-windowrulev2 = fullscreen, class:org.nomarchy.screensaver
-windowrulev2 = float, class:org.nomarchy.screensaver
-windowrulev2 = animation slide, class:org.nomarchy.screensaver
-
-# No transparency on media windows
-windowrulev2 = tag -default-opacity, class:^(zoom|vlc|mpv|org.kde.kdenlive|com.obsproject.Studio|com.github.PintaProject.Pinta|imv|org.gnome.NautilusPreviewer)$
-windowrulev2 = opacity 1 1, class:^(zoom|vlc|mpv|org.kde.kdenlive|com.obsproject.Studio|com.github.PintaProject.Pinta|imv|org.gnome.NautilusPreviewer)$
-
-# Popped window rounding
-windowrulev2 = rounding 8, tag:pop
-
-# Prevent idle while open
-windowrulev2 = idleinhibit always, tag:noidle

core/home/config/nomarchy/default/hypr/apps/telegram.conf

@@ -1,2 +0,0 @@
-# Prevent Telegram from stealing focus on new messages
-windowrulev2 = focusonactivate off, class:org.telegram.desktop

core/home/config/nomarchy/default/hypr/apps/terminals.conf

@@ -1,4 +0,0 @@
-# Define terminal tag to style them uniformly
-windowrulev2 = tag +terminal, class:(Alacritty|kitty|com.mitchellh.ghostty)
-windowrulev2 = tag -default-opacity, tag:terminal
-windowrulev2 = opacity 0.97 0.9, tag:terminal

core/home/config/nomarchy/default/hypr/apps/walker.conf

@@ -1,2 +0,0 @@
-# Application-specific animation
-layerrule = noanim, namespace:walker

core/home/config/nomarchy/default/hypr/apps/webcam-overlay.conf

@@ -1,6 +0,0 @@
-# Webcam overlay for screen recording
-windowrulev2 = float, title:WebcamOverlay
-windowrulev2 = pin, title:WebcamOverlay
-windowrulev2 = noinitialfocus, title:WebcamOverlay
-windowrulev2 = nodim, title:WebcamOverlay
-windowrulev2 = move (monitor_w-window_w-40) (monitor_h-window_h-40), title:WebcamOverlay

core/home/config/nomarchy/default/hypr/autostart.conf

@@ -1,17 +0,0 @@
-exec-once = uwsm-app -- hypridle
-exec-once = uwsm-app -- mako
-exec-once = nomarchy-welcome
-# exec-once = uwsm-app -- waybar
-# fcitx5 is autostarted by NixOS's i18n.inputMethod when
-# nomarchy.system.inputMethod.enable = true; no manual exec-once needed.
-# swaybg is started as a systemd user service (nomarchy-wallpaper.service)
-# so failures surface in logs and the wallpaper survives Hyprland restarts.
-exec-once = uwsm-app -- swayosd-server
-exec-once = nomarchy-on-boot
-
-# Slow app launch fix -- set systemd vars
-exec-once = systemctl --user import-environment $(env | cut -d'=' -f 1)
-exec-once = dbus-update-activation-environment --systemd --all
-
-# Network Manager
-exec-once = uwsm-app 'nm-applet --indicator'

core/home/config/nomarchy/default/hypr/bindings/clipboard.conf

@@ -1,5 +0,0 @@
-# Copy / Paste
-bindd = SUPER, C, Universal copy, sendshortcut, CTRL, Insert,
-bindd = SUPER, V, Universal paste, sendshortcut, SHIFT, Insert,
-bindd = SUPER, X, Universal cut, sendshortcut, CTRL, X,
-bindd = SUPER CTRL, V, Clipboard manager, exec, nomarchy-launch-walker -m clipboard

core/home/config/nomarchy/default/hypr/bindings/media.conf

@@ -1,28 +0,0 @@
-# Only display the OSD on the currently focused monitor
-$osdclient = swayosd-client --monitor "$(hyprctl monitors -j | jq -r '.[] | select(.focused == true).name')"
-
-# Laptop multimedia keys for volume and LCD brightness (with OSD)
-bindeld = ,XF86AudioRaiseVolume, Volume up, exec, $osdclient --output-volume raise
-bindeld = ,XF86AudioLowerVolume, Volume down, exec, $osdclient --output-volume lower
-bindeld = ,XF86AudioMute, Mute, exec, $osdclient --output-volume mute-toggle
-bindeld = ,XF86AudioMicMute, Mute microphone, exec, $osdclient --input-volume mute-toggle
-bindeld = ,XF86MonBrightnessUp, Brightness up, exec, nomarchy-brightness-display +5%
-bindeld = ,XF86MonBrightnessDown, Brightness down, exec, nomarchy-brightness-display 5%-
-bindeld = ,XF86KbdBrightnessUp, Keyboard brightness up, exec, nomarchy-brightness-keyboard up
-bindeld = ,XF86KbdBrightnessDown, Keyboard brightness down, exec, nomarchy-brightness-keyboard down
-bindld = ,XF86KbdLightOnOff, Keyboard backlight cycle, exec, nomarchy-brightness-keyboard cycle
-
-# Precise 1% multimedia adjustments with Alt modifier
-bindeld = ALT, XF86AudioRaiseVolume, Volume up precise, exec, $osdclient --output-volume +1
-bindeld = ALT, XF86AudioLowerVolume, Volume down precise, exec, $osdclient --output-volume -1
-bindeld = ALT, XF86MonBrightnessUp, Brightness up precise, exec, nomarchy-brightness-display +1%
-bindeld = ALT, XF86MonBrightnessDown, Brightness down precise, exec, nomarchy-brightness-display 1%-
-
-# Requires playerctl
-bindld = , XF86AudioNext, Next track, exec, $osdclient --playerctl next
-bindld = , XF86AudioPause, Pause, exec, $osdclient --playerctl play-pause
-bindld = , XF86AudioPlay, Play, exec, $osdclient --playerctl play-pause
-bindld = , XF86AudioPrev, Previous track, exec, $osdclient --playerctl previous
-
-# Switch audio output with Super + Mute
-bindld = SUPER, XF86AudioMute, Switch audio output, exec, nomarchy-cmd-audio-switch

core/home/config/nomarchy/default/hypr/bindings/tiling-v2.conf

@@ -1,128 +0,0 @@
-# Close windows
-bindd = SUPER, W, Close window, killactive,
-bindd = CTRL ALT, DELETE, Close all windows, exec, nomarchy-hyprland-window-close-all
-
-# Control tiling
-bindd = SUPER, J, Toggle window split, layoutmsg, togglesplit
-bindd = SUPER, P, Pseudo window, pseudo, # dwindle
-bindd = SUPER, T, Toggle window floating/tiling, togglefloating,
-bindd = SUPER, F, Full screen, fullscreen, 0
-bindd = SUPER CTRL, F, Tiled full screen, fullscreenstate, 0 2
-bindd = SUPER ALT, F, Full width, fullscreen, 1
-bindd = SUPER, O, Pop window out (float & pin), exec, nomarchy-hyprland-window-pop
-bindd = SUPER, L, Toggle workspace layout, exec, nomarchy-hyprland-workspace-layout-toggle
-
-# Move focus with SUPER + arrow keys
-bindd = SUPER, LEFT, Move window focus left, movefocus, l
-bindd = SUPER, RIGHT, Move window focus right, movefocus, r
-bindd = SUPER, UP, Move window focus up, movefocus, u
-bindd = SUPER, DOWN, Move window focus down, movefocus, d
-
-# Switch workspaces with SUPER + [1-9; 0]
-bindd = SUPER, code:10, Switch to workspace 1, workspace, 1
-bindd = SUPER, code:11, Switch to workspace 2, workspace, 2
-bindd = SUPER, code:12, Switch to workspace 3, workspace, 3
-bindd = SUPER, code:13, Switch to workspace 4, workspace, 4
-bindd = SUPER, code:14, Switch to workspace 5, workspace, 5
-bindd = SUPER, code:15, Switch to workspace 6, workspace, 6
-bindd = SUPER, code:16, Switch to workspace 7, workspace, 7
-bindd = SUPER, code:17, Switch to workspace 8, workspace, 8
-bindd = SUPER, code:18, Switch to workspace 9, workspace, 9
-bindd = SUPER, code:19, Switch to workspace 10, workspace, 10
-
-# Move active window to a workspace with SUPER + SHIFT + [1-9; 0]
-bindd = SUPER SHIFT, code:10, Move window to workspace 1, movetoworkspace, 1
-bindd = SUPER SHIFT, code:11, Move window to workspace 2, movetoworkspace, 2
-bindd = SUPER SHIFT, code:12, Move window to workspace 3, movetoworkspace, 3
-bindd = SUPER SHIFT, code:13, Move window to workspace 4, movetoworkspace, 4
-bindd = SUPER SHIFT, code:14, Move window to workspace 5, movetoworkspace, 5
-bindd = SUPER SHIFT, code:15, Move window to workspace 6, movetoworkspace, 6
-bindd = SUPER SHIFT, code:16, Move window to workspace 7, movetoworkspace, 7
-bindd = SUPER SHIFT, code:17, Move window to workspace 8, movetoworkspace, 8
-bindd = SUPER SHIFT, code:18, Move window to workspace 9, movetoworkspace, 9
-bindd = SUPER SHIFT, code:19, Move window to workspace 10, movetoworkspace, 10
-
-# Move active window silently to a workspace with SUPER + SHIFT + ALT + [1-9; 0]
-bindd = SUPER SHIFT ALT, code:10, Move window silently to workspace 1, movetoworkspacesilent, 1
-bindd = SUPER SHIFT ALT, code:11, Move window silently to workspace 2, movetoworkspacesilent, 2
-bindd = SUPER SHIFT ALT, code:12, Move window silently to workspace 3, movetoworkspacesilent, 3
-bindd = SUPER SHIFT ALT, code:13, Move window silently to workspace 4, movetoworkspacesilent, 4
-bindd = SUPER SHIFT ALT, code:14, Move window silently to workspace 5, movetoworkspacesilent, 5
-bindd = SUPER SHIFT ALT, code:15, Move window silently to workspace 6, movetoworkspacesilent, 6
-bindd = SUPER SHIFT ALT, code:16, Move window silently to workspace 7, movetoworkspacesilent, 7
-bindd = SUPER SHIFT ALT, code:17, Move window silently to workspace 8, movetoworkspacesilent, 8
-bindd = SUPER SHIFT ALT, code:18, Move window silently to workspace 9, movetoworkspacesilent, 9
-bindd = SUPER SHIFT ALT, code:19, Move window silently to workspace 10, movetoworkspacesilent, 10
-
-# Control scratchpad
-bindd = SUPER, S, Toggle scratchpad, togglespecialworkspace, scratchpad
-bindd = SUPER ALT, S, Move window to scratchpad, movetoworkspacesilent, special:scratchpad
-
-# TAB between workspaces
-bindd = SUPER, TAB, Next workspace, workspace, e+1
-bindd = SUPER SHIFT, TAB, Previous workspace, workspace, e-1
-bindd = SUPER CTRL, TAB, Former workspace, workspace, previous
-
-# Move workspaces to other monitors
-bindd = SUPER SHIFT ALT, LEFT, Move workspace to left monitor, movecurrentworkspacetomonitor, l
-bindd = SUPER SHIFT ALT, RIGHT, Move workspace to right monitor, movecurrentworkspacetomonitor, r
-bindd = SUPER SHIFT ALT, UP, Move workspace to up monitor, movecurrentworkspacetomonitor, u
-bindd = SUPER SHIFT ALT, DOWN, Move workspace to down monitor, movecurrentworkspacetomonitor, d
-
-# Swap active window with the one next to it with SUPER + SHIFT + arrow keys
-bindd = SUPER SHIFT, LEFT, Swap window to the left, swapwindow, l
-bindd = SUPER SHIFT, RIGHT, Swap window to the right, swapwindow, r
-bindd = SUPER SHIFT, UP, Swap window up, swapwindow, u
-bindd = SUPER SHIFT, DOWN, Swap window down, swapwindow, d
-
-# Cycle through applications on active workspace
-bindd = ALT, TAB, Cycle to next window, cyclenext
-bindd = ALT SHIFT, TAB, Cycle to prev window, cyclenext, prev
-bindd = ALT, TAB, Reveal active window on top, bringactivetotop
-bindd = ALT SHIFT, TAB, Reveal active window on top, bringactivetotop
-
-# Resize active window
-bindd = SUPER, code:20, Expand window left, resizeactive, -100 0    # - key
-bindd = SUPER, code:21, Shrink window left, resizeactive, 100 0     # = key
-bindd = SUPER SHIFT, code:20, Shrink window up, resizeactive, 0 -100
-bindd = SUPER SHIFT, code:21, Expand window down, resizeactive, 0 100
-
-# Scroll through existing workspaces with SUPER + scroll
-bindd = SUPER, mouse_down, Scroll active workspace forward, workspace, e+1
-bindd = SUPER, mouse_up, Scroll active workspace backward, workspace, e-1
-
-# Move/resize windows with mainMod + LMB/RMB and dragging
-bindmd = SUPER, mouse:272, Move window, movewindow
-bindmd = SUPER, mouse:273, Resize window, resizewindow
-
-# Toggle groups
-bindd = SUPER, G, Toggle window grouping, togglegroup
-bindd = SUPER ALT, G, Move active window out of group, moveoutofgroup
-
-# Join groups
-bindd = SUPER ALT, LEFT, Move window to group on left, moveintogroup, l
-bindd = SUPER ALT, RIGHT, Move window to group on right, moveintogroup, r
-bindd = SUPER ALT, UP, Move window to group on top, moveintogroup, u
-bindd = SUPER ALT, DOWN, Move window to group on bottom, moveintogroup, d
-
-# Navigate a single set of grouped windows
-bindd = SUPER ALT, TAB, Next window in group, changegroupactive, f
-bindd = SUPER ALT SHIFT, TAB, Previous window in group, changegroupactive, b
-
-# Window navigation for grouped windows
-bindd = SUPER CTRL, LEFT, Move grouped window focus left, changegroupactive, b
-bindd = SUPER CTRL, RIGHT, Move grouped window focus right, changegroupactive, f
-
-# Scroll through a set of grouped windows with SUPER + ALT + scroll
-bindd = SUPER ALT, mouse_down, Next window in group, changegroupactive, f
-bindd = SUPER ALT, mouse_up, Previous window in group, changegroupactive, b
-
-# Activate window in a group by number
-bindd = SUPER ALT, code:10, Switch to group window 1, changegroupactive, 1
-bindd = SUPER ALT, code:11, Switch to group window 2, changegroupactive, 2
-bindd = SUPER ALT, code:12, Switch to group window 3, changegroupactive, 3
-bindd = SUPER ALT, code:13, Switch to group window 4, changegroupactive, 4
-bindd = SUPER ALT, code:14, Switch to group window 5, changegroupactive, 5
-
-# Cycle monitor scaling
-bindd = SUPER, Slash, Cycle monitor scaling, exec, nomarchy-hyprland-monitor-scaling-cycle

core/home/config/nomarchy/default/hypr/bindings/utilities.conf

@@ -1,59 +0,0 @@
-# Menus
-bindd = SUPER, SPACE, Launch apps, exec, nomarchy-launch-walker
-bindd = SUPER CTRL, E, Emoji picker, exec, nomarchy-menu symbols
-bindd = SUPER CTRL, C, Capture menu, exec, nomarchy-menu capture
-bindd = SUPER CTRL, O, Toggle menu, exec, nomarchy-menu toggle
-bindd = SUPER ALT, SPACE, Toggle top bar, exec, nomarchy-toggle-waybar
-bindd = SUPER, ESCAPE, System menu, exec, nomarchy-menu system
-bindld = , XF86PowerOff, Power menu, exec, nomarchy-menu system
-bindd = SUPER, K, Show key bindings, exec, nomarchy-menu-keybindings
-bindd = , XF86Calculator, Calculator, exec, gnome-calculator
-
-# Aesthetics
-bindd = SUPER SHIFT, SPACE, Nomarchy menu, exec, nomarchy-menu
-bindd = SUPER CTRL, SPACE, Theme background menu, exec, nomarchy-menu background
-bindd = SUPER SHIFT CTRL, SPACE, Theme menu, exec, nomarchy-menu theme
-bindd = SUPER, BACKSPACE, Toggle window transparency, exec, nomarchy-hyprland-active-window-transparency-toggle
-bindd = SUPER SHIFT, BACKSPACE, Toggle window gaps, exec, nomarchy-hyprland-window-gaps-toggle
-bindd = SUPER CTRL, BACKSPACE, Toggle single-window square aspect, exec, nomarchy-hyprland-window-single-square-aspect-toggle
-
-# Notifications
-bindd = SUPER, COMMA, Dismiss last notification, exec, makoctl dismiss
-bindd = SUPER SHIFT, COMMA, Dismiss all notifications, exec, makoctl dismiss --all
-bindd = SUPER CTRL, COMMA, Toggle silencing notifications, exec, nomarchy-toggle-notification-silencing
-bindd = SUPER ALT, COMMA, Invoke last notification, exec, makoctl invoke
-bindd = SUPER SHIFT ALT, COMMA, Restore last notification, exec, makoctl restore
-
-# Toggles
-bindd = SUPER CTRL, I, Toggle locking on idle, exec, nomarchy-toggle-idle
-bindd = SUPER CTRL, N, Toggle nightlight, exec, nomarchy-toggle-nightlight
-
-# Control Apple Display brightness
-bindd = CTRL, F1, Apple Display brightness down, exec, nomarchy-brightness-display-apple -5000
-bindd = CTRL, F2, Apple Display brightness up, exec, nomarchy-brightness-display-apple +5000
-bindd = SHIFT CTRL, F2, Apple Display full brightness, exec, nomarchy-brightness-display-apple +60000
-
-# Captures
-bindd = , PRINT, Screenshot, exec, nomarchy-cmd-screenshot
-bindd = ALT, PRINT, Screenrecording, exec, nomarchy-menu screenrecord
-bindd = SUPER, PRINT, Color picker, exec, pkill hyprpicker || hyprpicker -a
-
-# File sharing
-bindd = SUPER CTRL, S, Share, exec, nomarchy-menu share
-
-# Waybar-less information
-bindd = SUPER CTRL ALT, T, Show time, exec, notify-send -u low "    $(date +"%A %H:%M  ·  %d %B %Y  ·  Week %V")"
-bindd = SUPER CTRL ALT, B, Show battery remaining, exec, notify-send -u low "$(nomarchy-battery-status)"
-
-# Control panels
-bindd = SUPER CTRL, A, Audio controls, exec, nomarchy-launch-audio
-bindd = SUPER CTRL, B, Bluetooth controls, exec, nomarchy-launch-bluetooth
-bindd = SUPER CTRL, W, Wifi controls, exec, nomarchy-launch-wifi
-bindd = SUPER CTRL, T, Activity, exec, nomarchy-launch-tui btop
-
-# Zoom
-bindd = SUPER CTRL, Z, Zoom in, exec, hyprctl keyword cursor:zoom_factor $(hyprctl getoption cursor:zoom_factor -j | jq '.float + 1')
-bindd = SUPER CTRL ALT, Z, Reset zoom, exec, hyprctl keyword cursor:zoom_factor 1
-
-# Lock system
-bindd = SUPER CTRL, L, Lock system, exec, nomarchy-lock-screen

core/home/config/nomarchy/default/hypr/colors.conf

@@ -1,12 +0,0 @@
-# Hyprland Color Configuration (Visual)
-# This file contains only color-related settings.
-# It's sourced AFTER theme colors are applied, allowing theme-specific overrides.
-
-# These are placeholder values - actual colors come from the active theme
-# via ~/.config/nomarchy/current/theme/hyprland.conf
-
-# Border colors (set by theme-loader based on active theme)
-# The theme's hyprland.conf will define $activeBorderColor and $inactiveBorderColor
-
-# Group bar colors (set by theme)
-# Themes can override group bar colors in their hyprland.conf

core/home/config/nomarchy/default/hypr/envs.conf

@@ -1,29 +0,0 @@
-# Cursor size
-env = XCURSOR_SIZE,24
-env = HYPRCURSOR_SIZE,24
-
-# Force all apps to use Wayland
-env = GDK_BACKEND,wayland,x11,*
-env = QT_QPA_PLATFORM,wayland;xcb
-env = QT_STYLE_OVERRIDE,kvantum
-env = SDL_VIDEODRIVER,wayland,x11
-env = MOZ_ENABLE_WAYLAND,1
-env = ELECTRON_OZONE_PLATFORM_HINT,wayland
-env = OZONE_PLATFORM,wayland
-env = XDG_SESSION_TYPE,wayland
-
-# Allow better support for screen sharing (Google Meet, Discord, etc)
-env = XDG_CURRENT_DESKTOP,Hyprland
-env = XDG_SESSION_DESKTOP,Hyprland
-
-xwayland {
-  force_zero_scaling = true
-}
-
-# Use XCompose file
-env = XCOMPOSEFILE,~/.XCompose
-
-# Don't show update on first launch
-ecosystem {
-  no_update_news = true
-}

core/home/config/nomarchy/default/hypr/looknfeel.conf

@@ -1,146 +0,0 @@
-# Refer to https://wiki.hyprland.org/Configuring/Variables/
-
-# Variables
-$activeBorderColor = rgba(33ccffee) rgba(00ff99ee) 45deg
-$inactiveBorderColor = rgba(595959aa)
-
-# https://wiki.hyprland.org/Configuring/Variables/#general
-general {
-    gaps_in = 5
-    gaps_out = 10
-
-    border_size = 2
-
-    # https://wiki.hyprland.org/Configuring/Variables/#variable-types for info about colors
-    col.active_border = $activeBorderColor
-    col.inactive_border = $inactiveBorderColor
-
-    # Set to true enable resizing windows by clicking and dragging on borders and gaps
-    resize_on_border = false
-
-    # Please see https://wiki.hyprland.org/Configuring/Tearing/ before you turn this on
-    allow_tearing = false
-
-    layout = dwindle
-}
-
-# https://wiki.hyprland.org/Configuring/Variables/#decoration
-decoration {
-    rounding = 0
-
-    shadow {
-        enabled = true
-        range = 2
-        render_power = 3
-        color = rgba(1a1a1aee)
-    }
-
-    # https://wiki.hyprland.org/Configuring/Variables/#blur
-    blur {
-        enabled = true
-        size = 2
-        passes = 2
-        special = true
-        brightness = 0.60
-        contrast = 0.75
-    }
-}
-
-# https://wiki.hypr.land/Configuring/Variables/#group
-group {
-    col.border_active = $activeBorderColor
-    col.border_inactive = $inactiveBorderColor
-    col.border_locked_active = -1
-    col.border_locked_inactive = -1
-
-    groupbar {
-        font_size = 12
-        font_family = monospace
-        font_weight_active = ultraheavy
-        font_weight_inactive = normal
-
-        indicator_height = 0
-        indicator_gap = 5
-        height = 22
-        gaps_in = 5
-        gaps_out = 0
-
-        text_color = rgb(ffffff)
-        text_color_inactive = rgba(ffffff90)
-        col.active = rgba(00000040)
-        col.inactive = rgba(00000020)
-
-        gradients = true
-        gradient_rounding = 0
-        gradient_round_only_edges = false
-    }
-}
-
-
-# https://wiki.hyprland.org/Configuring/Variables/#animations
-animations {
-    enabled = yes
-
-    # Default animations, see https://wiki.hyprland.org/Configuring/Animations/ for more
-
-    bezier = easeOutQuint,0.23,1,0.32,1
-    bezier = easeInOutCubic,0.65,0.05,0.36,1
-    bezier = linear,0,0,1,1
-    bezier = almostLinear,0.5,0.5,0.75,1.0
-    bezier = quick,0.15,0,0.1,1
-
-    animation = global, 1, 10, default
-    animation = border, 1, 5.39, easeOutQuint
-    animation = windows, 1, 4.79, easeOutQuint
-    animation = windowsIn, 1, 4.1, easeOutQuint, popin 87%
-    animation = windowsOut, 1, 1.49, linear, popin 87%
-    animation = fadeIn, 1, 1.73, almostLinear
-    animation = fadeOut, 1, 1.46, almostLinear
-    animation = fade, 1, 3.03, quick
-    animation = layers, 1, 3.81, easeOutQuint
-    animation = layersIn, 1, 4, easeOutQuint, fade
-    animation = layersOut, 1, 1.5, linear, fade
-    animation = fadeLayersIn, 1, 1.79, almostLinear
-    animation = fadeLayersOut, 1, 1.39, almostLinear
-    animation = workspaces, 0, 0, ease
-    animation = specialWorkspace, 1, 4, easeOutQuint, slidevert
-}
-
-# See https://wiki.hyprland.org/Configuring/Dwindle-Layout/ for more
-dwindle {
-    pseudotile = true # Master switch for pseudotiling. Enabling is bound to mainMod + P in the keybinds section below
-    preserve_split = true # You probably want this
-    force_split = 2 # Always split on the right
-}
-
-# See https://wiki.hyprland.org/Configuring/Master-Layout/ for more
-master {
-    new_status = master
-}
-
-# https://wiki.hyprland.org/Configuring/Variables/#misc
-misc {
-    disable_hyprland_logo = true
-    disable_splash_rendering  = true
-    disable_scale_notification = true
-    focus_on_activate = true
-}
-
-# https://wiki.hypr.land/Configuring/Variables/#cursor
-cursor {
-    hide_on_key_press = true
-    warp_on_change_workspace = 1
-}
-
-# Auto toggle scratchpad on switching workspace from scratchpad
-binds {
-    hide_special_on_workspace_change = true
-}
-
-# Style Gum confirm to match terminal theme
-env = GUM_CONFIRM_PROMPT_FOREGROUND,6       # Cyan
-env = GUM_CONFIRM_SELECTED_FOREGROUND,0     # Black
-env = GUM_CONFIRM_SELECTED_BACKGROUND,2     # Green
-env = GUM_CONFIRM_UNSELECTED_FOREGROUND,7   # White
-env = GUM_CONFIRM_UNSELECTED_BACKGROUND,8   # Dark grey
-   # Dark grey

core/home/config/nomarchy/default/hypr/windows.conf

@@ -1,15 +0,0 @@
-# See https://wiki.hyprland.org/Configuring/Window-Rules/ for more
-# Hyprland 0.53+ syntax
-#windowrulev2 = suppressevent maximize, class:.*
-
-# Tag all windows for default opacity (apps can override with -default-opacity tag)
-#windowrulev2 = tag +default-opacity, class:.*
-
-# Fix some dragging issues with XWayland
-#windowrulev2 = nofocus, class:^$, title:^$, xwayland:1, float:1, fullscreen:0, pin:0
-
-# App-specific tweaks (may remove default-opacity tag)
-source = ~/.config/nomarchy/default/hypr/apps.conf
-
-# Apply default opacity after apps have had a chance to opt out
-#windowrulev2 = opacity 0.97 0.9, tag:default-opacity

core/home/config/nomarchy/default/mako/core.ini

@@ -1,37 +0,0 @@
-anchor=top-right
-default-timeout=5000
-width=420
-outer-margin=20
-padding=10,15
-border-size=2
-max-icon-size=32
-font=sans-serif 14px
-
-[app-name=Spotify]
-invisible=1
-
-[mode=do-not-disturb]
-invisible=true
-
-[mode=do-not-disturb app-name=notify-send]
-invisible=false
-
-[urgency=critical]
-default-timeout=0
-layer=overlay
-
-[summary~="Setup Wi-Fi"]
-on-button-left=exec sh -c 'nomarchy-notification-dismiss "Setup Wi-Fi"; nomarchy-launch-wifi'
-on-click=exec sh -c 'nomarchy-notification-dismiss "Setup Wi-Fi"; nomarchy-launch-wifi'
-
-[summary~="Update System"]
-on-button-left=exec sh -c 'nomarchy-notification-dismiss "Update System"; nomarchy-launch-floating-terminal-with-presentation nomarchy-update'
-on-click=exec sh -c 'nomarchy-notification-dismiss "Update System"; nomarchy-launch-floating-terminal-with-presentation nomarchy-update'
-
-[summary~="Learn Keybindings"]
-on-button-left=exec sh -c 'nomarchy-notification-dismiss "Learn Keybindings"; nomarchy-menu-keybindings'
-on-click=exec sh -c 'nomarchy-notification-dismiss "Learn Keybindings"; nomarchy-menu-keybindings'
-
-[summary~="Screenshot copied & saved"]
-max-icon-size=80
-format=<b>%s</b>\n%b

core/home/config/nomarchy/default/walker/restart.conf

@@ -1,3 +0,0 @@
-[Service]
-Restart=always
-RestartSec=2

core/home/config/nomarchy/default/walker/themes/nomarchy-default/layout.xml

@@ -1,156 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<interface>
-  <requires lib="gtk" version="4.0"></requires>
-  <object class="GtkWindow" id="Window">
-    <style>
-      <class name="window"></class>
-    </style>
-    <property name="resizable">true</property>
-    <property name="title">Walker</property>
-    <child>
-      <object class="GtkBox" id="BoxWrapper">
-        <style>
-          <class name="box-wrapper"></class>
-        </style>
-        <property name="width-request">644</property>
-        <property name="overflow">hidden</property>
-        <property name="orientation">horizontal</property>
-        <property name="valign">center</property>
-        <property name="halign">center</property>
-        <child>
-          <object class="GtkBox" id="Box">
-            <style>
-              <class name="box"></class>
-            </style>
-            <property name="orientation">vertical</property>
-            <property name="hexpand-set">true</property>
-            <property name="hexpand">true</property>
-            <property name="spacing">10</property>
-            <child>
-              <object class="GtkBox" id="SearchContainer">
-                <style>
-                  <class name="search-container"></class>
-                </style>
-                <property name="overflow">hidden</property>
-                <property name="orientation">horizontal</property>
-                <property name="halign">fill</property>
-                <property name="hexpand-set">true</property>
-                <property name="hexpand">true</property>
-                <child>
-                  <object class="GtkEntry" id="Input">
-                    <style>
-                      <class name="input"></class>
-                    </style>
-                    <property name="halign">fill</property>
-                    <property name="hexpand-set">true</property>
-                    <property name="hexpand">true</property>
-                  </object>
-                </child>
-              </object>
-            </child>
-            <child>
-              <object class="GtkBox" id="ContentContainer">
-                <style>
-                  <class name="content-container"></class>
-                </style>
-                <property name="orientation">horizontal</property>
-                <property name="spacing">10</property>
-                <property name="vexpand">true</property>
-                <property name="vexpand-set">true</property>
-                <child>
-                  <object class="GtkLabel" id="ElephantHint">
-                    <style>
-                      <class name="elephant-hint"></class>
-                    </style>
-                    <property name="hexpand">true</property>
-                    <property name="height-request">100</property>
-                    <property name="label">Waiting for elephant...</property>
-                  </object>
-                </child>
-                <child>
-                  <object class="GtkLabel" id="Placeholder">
-                    <style>
-                      <class name="placeholder"></class>
-                    </style>
-                    <property name="label">No Results</property>
-                    <property name="yalign">0.0</property>
-                    <property name="hexpand">true</property>
-                  </object>
-                </child>
-                <child>
-                  <object class="GtkScrolledWindow" id="Scroll">
-                    <style>
-                      <class name="scroll"></class>
-                    </style>
-                    <property name="hexpand">true</property>
-                    <property name="can_focus">false</property>
-                    <property name="overlay-scrolling">true</property>
-                    <property name="max-content-width">600</property>
-                    <property name="max-content-height">300</property>
-                    <property name="min-content-height">0</property>
-                    <property name="propagate-natural-height">true</property>
-                    <property name="propagate-natural-width">true</property>
-                    <property name="hscrollbar-policy">automatic</property>
-                    <property name="vscrollbar-policy">automatic</property>
-                    <child>
-                      <object class="GtkGridView" id="List">
-                        <style>
-                          <class name="list"></class>
-                        </style>
-                        <property name="max_columns">1</property>
-                        <property name="can_focus">false</property>
-                      </object>
-                    </child>
-                  </object>
-                </child>
-                <child>
-                  <object class="GtkBox" id="Preview">
-                    <style>
-                      <class name="preview"></class>
-                    </style>
-                  </object>
-                </child>
-              </object>
-            </child>
-            <child>
-              <object class="GtkBox" id="Keybinds">
-                <property name="hexpand">true</property>
-                <property name="margin-top">10</property>
-                <style>
-                  <class name="keybinds"></class>
-                </style>
-                <child>
-                  <object class="GtkBox" id="GlobalKeybinds">
-                    <property name="spacing">10</property>
-                    <style>
-                      <class name="global-keybinds"></class>
-                    </style>
-                  </object>
-                </child>
-                <child>
-                  <object class="GtkBox" id="ItemKeybinds">
-                    <property name="hexpand">true</property>
-                    <property name="halign">end</property>
-                    <property name="spacing">10</property>
-                    <style>
-                      <class name="item-keybinds"></class>
-                    </style>
-                  </object>
-                </child>
-              </object>
-            </child>
-            <child>
-              <object class="GtkLabel" id="Error">
-                <style>
-                  <class name="error"></class>
-                </style>
-                <property name="xalign">0</property>
-                <property name="visible">false</property>
-              </object>
-            </child>
-          </object>
-        </child>
-      </object>
-    </child>
-  </object>
-</interface>

core/home/config/nomarchy/default/walker/themes/nomarchy-default/style.css

@@ -1,117 +0,0 @@
-@import "../../../../../../../.config/nomarchy/current/theme/walker.css";
-
-* {
-  all: unset;
-}
-
-* {
-  font-family: monospace;
-  font-size: 18px;
-  color: @text;
-}
-
-scrollbar {
-  opacity: 0;
-}
-
-.normal-icons {
-  -gtk-icon-size: 16px;
-}
-
-.large-icons {
-  -gtk-icon-size: 32px;
-}
-
-.box-wrapper {
-  background: alpha(@base, 0.95);
-  padding: 20px;
-  border: 2px solid @border;
-}
-
-.preview-box {
-}
-
-.box {
-}
-
-.search-container {
-  background: @base;
-  padding: 10px;
-}
-
-.input placeholder {
-  opacity: 0.5;
-}
-
-.input {
-}
-
-.input:focus,
-.input:active {
-  box-shadow: none;
-  outline: none;
-}
-
-.content-container {
-}
-
-.placeholder {
-}
-
-.scroll {
-}
-
-.list {
-}
-
-child,
-child > * {
-}
-
-child:hover .item-box {
-}
-
-child:selected .item-box {
-  background-color: @selected-background;
-}
-
-child:selected .item-box * {
-  color: @selected-text;
-}
-
-.item-box {
-  padding-left: 14px;
-}
-
-.item-text-box {
-  all: unset;
-  padding: 14px 0;
-}
-
-.item-text {
-}
-
-.item-subtext {
-  font-size: 0px;
-  min-height: 0px;
-  margin: 0px;
-  padding: 0px;
-}
-
-.item-image {
-  margin-right: 14px;
-  -gtk-icon-transform: scale(0.9);
-}
-
-.current {
-  font-style: italic;
-}
-
-.keybind-hints {
-  background: @background;
-  padding: 10px;
-  margin-top: 10px;
-}
-
-.preview {
-}

core/home/config/nomarchy/default/walker/walker.desktop

@@ -1,7 +0,0 @@
-[Desktop Entry]
-Name=Walker
-Comment=Walker Service
-Exec=walker --gapplication-service
-StartupNotify=false
-Terminal=false
-Type=Application

core/home/config/nomarchy/default/waybar/indicators/idle.sh

@@ -1,7 +0,0 @@
-#!/usr/bin/env bash
-
-if pgrep -x hypridle >/dev/null; then
-  echo '{"text": ""}'
-else
-  echo '{"text": "󱫖", "tooltip": "Idle lock disabled", "class": "active"}'
-fi

core/home/config/nomarchy/default/waybar/indicators/notification-silencing.sh

@@ -1,7 +0,0 @@
-#!/usr/bin/env bash
-
-if makoctl mode | grep -q 'do-not-disturb'; then
-  echo '{"text": "󰂛", "tooltip": "Notifications silenced", "class": "active"}'
-else
-  echo '{"text": ""}'
-fi

core/home/config/nomarchy/default/waybar/indicators/screen-recording.sh

@@ -1,7 +0,0 @@
-#!/usr/bin/env bash
-
-if pgrep -f "^gpu-screen-recorder" >/dev/null; then
-  echo '{"text": "󰻂", "tooltip": "Stop recording", "class": "active"}'
-else
-  echo '{"text": ""}'
-fi

core/home/config/nomarchy/default/wireplumber/wireplumber.conf.d/alsa-soft-mixer.conf

@@ -1,18 +0,0 @@
-## Use software volume control for all ALSA devices.
-## This prevents hardware mixer quirks (like muffled audio on Realtek codecs)
-## and provides consistent volume behavior across all hardware.
-
-monitor.alsa.rules = [
-  {
-    matches = [
-      {
-        device.name = "~alsa_card.*"
-      }
-    ]
-    actions = {
-      update-props = {
-        api.alsa.soft-mixer = true
-      }
-    }
-  }
-]

core/home/config/nomarchy/default/xcompose

@@ -1,29 +0,0 @@
-include "%L"
-
-# Emoji
-<Multi_key> <m> <s> : "😄" # smile
-<Multi_key> <m> <c> : "😂" # cry
-<Multi_key> <m> <l> : "😍" # love
-<Multi_key> <m> <v> : "✌️"  # victory
-<Multi_key> <m> <h> : "❤️"  # heart
-<Multi_key> <m> <y> : "👍" # yes
-<Multi_key> <m> <n> : "👎" # no
-<Multi_key> <m> <f> : "🖕" # fuck
-<Multi_key> <m> <w> : "🤞" # wish
-<Multi_key> <m> <r> : "🤘" # rock
-<Multi_key> <m> <k> : "😘" # kiss
-<Multi_key> <m> <e> : "🙄" # eyeroll
-<Multi_key> <m> <d> : "🤤" # droll
-<Multi_key> <m> <m> : "💰" # money
-<Multi_key> <m> <x> : "🎉" # xellebrate
-<Multi_key> <m> <1> : "💯" # 100%
-<Multi_key> <m> <t> : "🥂" # toast
-<Multi_key> <m> <p> : "🙏" # pray
-<Multi_key> <m> <i> : "😉" # wink
-<Multi_key> <m> <o> : "👌" # OK
-<Multi_key> <m> <g> : "👋" # greeting
-<Multi_key> <m> <a> : "💪" # arm
-<Multi_key> <m> <b> : "🤯" # blowing
-
-# Typography
-<Multi_key> <space> <space> : "—"

core/home/config/nomarchy/extensions/menu.sh

@@ -1,20 +0,0 @@
-# Overwrite parts of the nomarchy-menu with user-specific submenus.
-# See $OMARCHY_PATH/bin/nomarchy-menu for functions that can be overwritten.
-#
-# WARNING: Overwritten functions will obviously not be updated when Nomarchy changes.
-#
-# Example of minimal system menu:
-#
-# show_system_menu() {
-#   case $(menu "System" "  Lock\n󰐥  Shutdown") in
-#   *Lock*) nomarchy-lock-screen ;;
-#   *Shutdown*) nomarchy-system-shutdown ;;
-#   *) back_to show_main_menu ;;
-#   esac
-# }
-#
-# Example of overriding just the about menu action: (Using zsh instead of bash (default))
-#
-# show_about() {
-#   exec nomarchy-launch-or-focus-tui "zsh -c 'fastfetch; read -k 1'"
-# }

core/home/config/nomarchy/hooks/battery-low.sample

@@ -1,10 +0,0 @@
-#!/bin/bash
-
-# This hook is called with the current battery percentage when the low battery
-# notification is sent. To put it into use, remove .sample from the name.
-
-SOUND_FILE="/usr/share/sounds/freedesktop/stereo/dialog-warning.oga"
-
-if nomarchy-cmd-present mpv && [[ -f $SOUND_FILE ]]; then
-  mpv --no-video "$SOUND_FILE" >/dev/null 2>&1
-fi

core/home/config/nomarchy/hooks/font-set.sample

@@ -1,7 +0,0 @@
-#!/bin/bash
-
-# This hook is called with the snake-cased name of the font that has just been set.
-# To put it into use, remove .sample from the name.
-
-# Example: Show the name of the theme that was just set.
-# notify-send -u low "New font" "Your new font is $1"

core/home/config/nomarchy/hooks/post-install.sample

@@ -1,9 +0,0 @@
-#!/bin/bash
-
-# This hook is called after the nomarchy-welcome wizard finishes successfully.
-# Use it to run any custom first-boot logic (e.g. cloning your dotfiles repo,
-# setting up SSH keys, or launching specific initial apps).
-
-# Example: Open the manual and show a notification
-# nomarchy-manual
-# notify-send "Welcome home" "Your Nomarchy system is ready to use."

core/home/config/nomarchy/hooks/post-update.sample

@@ -1,7 +0,0 @@
-#!/bin/bash
-
-# This hook is called after an Nomarchy system update has been performed.
-# To put it into use, remove .sample from the name.
-
-# Example: Show notification after the system has been updated.
-# notify-send -u low "Update Performed" "Your system is now up to date"

core/home/config/nomarchy/hooks/theme-set.sample

@@ -1,7 +0,0 @@
-#!/bin/bash
-
-# This hook is called with the snake-cased name of the theme that has just been set.
-# To put it into use, remove .sample from the name.
-
-# Example: Show the name of the theme that was just set.
-# notify-send -u low "New theme" "Your new theme is $1"

core/home/config/nomarchy/themed/alacritty.toml.tpl.sample

@@ -1,86 +0,0 @@
-# Nomarchy User Template Example: Alacritty
-#
-# This is a sample template file demonstrating how to create custom themed
-# configurations. Templates use placeholder variables that get replaced with
-# your current theme's colors when you switch themes.
-#
-# HOW TO USE:
-#   1. Rename this file to: alacritty.toml.tpl (remove the .sample extension)
-#   2. Customize it as needed
-#   3. Change your theme to apply the template
-#
-# User templates in ~/.config/nomarchy/themed/ take priority over the built-in
-# templates in the Nomarchy default/themed/ directory. This lets you override
-# any built-in template or create templates for applications not included
-# by default.
-#
-# AVAILABLE VARIABLES:
-#   {{ background }}            - Main background color (e.g., "#1a1b26")
-#   {{ foreground }}            - Main foreground/text color
-#   {{ cursor }}                - Cursor color
-#   {{ accent }}                - Theme accent color
-#   {{ selection_background }}  - Selection highlight background
-#   {{ selection_foreground }}  - Selection highlight foreground
-#
-#   {{ color0 }} through {{ color15 }} - Standard 16-color terminal palette
-#     color0-7:  Normal colors (black, red, green, yellow, blue, magenta, cyan, white)
-#     color8-15: Bright variants
-#
-# VARIABLE MODIFIERS:
-#   {{ variable_strip }} - Hex color without the # prefix (e.g., "1a1b26")
-#   {{ variable_rgb }}   - Decimal RGB values (e.g., "26,27,38")
-#
-# Example using modifiers:
-#   background = "{{ background }}"       -> background = "#1a1b26"
-#   background = "{{ background_strip }}" -> background = "1a1b26"
-#   background = "rgb({{ background_rgb }})" -> background = "rgb(26,27,38)"
-#
-# ---------------------------------------------------------------------------
-
-[colors.primary]
-background = "{{ background }}"
-foreground = "{{ foreground }}"
-
-[colors.cursor]
-text = "{{ background }}"
-cursor = "{{ cursor }}"
-
-[colors.vi_mode_cursor]
-text = "{{ background }}"
-cursor = "{{ cursor }}"
-
-[colors.search.matches]
-foreground = "{{ background }}"
-background = "{{ color3 }}"
-
-[colors.search.focused_match]
-foreground = "{{ background }}"
-background = "{{ color1 }}"
-
-[colors.footer_bar]
-foreground = "{{ background }}"
-background = "{{ foreground }}"
-
-[colors.selection]
-text = "{{ selection_foreground }}"
-background = "{{ selection_background }}"
-
-[colors.normal]
-black = "{{ color0 }}"
-red = "{{ color1 }}"
-green = "{{ color2 }}"
-yellow = "{{ color3 }}"
-blue = "{{ color4 }}"
-magenta = "{{ color5 }}"
-cyan = "{{ color6 }}"
-white = "{{ color7 }}"
-
-[colors.bright]
-black = "{{ color8 }}"
-red = "{{ color9 }}"
-green = "{{ color10 }}"
-yellow = "{{ color11 }}"
-blue = "{{ color12 }}"
-magenta = "{{ color13 }}"
-cyan = "{{ color14 }}"
-white = "{{ color15 }}"

core/home/config/starship.toml

@@ -1,32 +0,0 @@
-add_newline = true
-command_timeout = 200
-format = "[$directory$git_branch$git_status]($style)$character"
-
-[character]
-error_symbol = "[✗](bold cyan)"
-success_symbol = "[❯](bold cyan)"
-
-[directory]
-truncation_length = 2
-truncation_symbol = "…/"
-repo_root_style = "bold cyan"
-repo_root_format = "[$repo_root]($repo_root_style)[$path]($style)[$read_only]($read_only_style) "
-
-[git_branch]
-format = "[$branch]($style) "
-style = "italic cyan"
-
-[git_status]
-format     = '[$all_status]($style)'
-style      = "cyan"
-ahead      = "⇡${count} "
-diverged   = "⇕⇡${ahead_count}⇣${behind_count} "
-behind     = "⇣${count} "
-conflicted = " "
-up_to_date = " "
-untracked  = "? "
-modified   = " "
-stashed    = ""
-staged     = ""
-renamed    = ""
-deleted    = ""

core/home/config/uwsm/default

@@ -1,13 +0,0 @@
-# Changes require a restart to take effect.
-
-# Install other terminals via Install > Terminal
-export TERMINAL=xdg-terminal-exec
-
-# Use code for VSCode
-export EDITOR=nvim
-
-# Use a custom directory for screenshots (remember to make the directory!)
-# export OMARCHY_SCREENSHOT_DIR="$HOME/Pictures/Screenshots"
-
-# Use a custom directory for screenrecordings (remember to make the directory!)
-# export OMARCHY_SCREENRECORD_DIR="$HOME/Videos/Screencasts"

core/home/config/uwsm/env

@@ -1,11 +0,0 @@
-# Changes require a restart to take effect.
-
-# Ensure Nomarchy bins are in the path
-export OMARCHY_PATH=$HOME/.local/share/nomarchy
-export PATH=$OMARCHY_PATH/bin:$PATH:$HOME/.local/bin
-
-# Set default terminal and editor
-source ~/.config/uwsm/default
-
-# Activate mise if present on the system
-nomarchy-cmd-present mise && eval "$(mise activate bash --shims)"