From c8d0b0904458c2fcdc84a8b285a1bd13373a7eac Mon Sep 17 00:00:00 2001 From: Bernardo Magri Date: Sun, 21 Jun 2026 16:42:03 +0100 Subject: [PATCH] docs(readme): label which file each nomarchy.* option goes in MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Split the options reference into separate home.nix / system.nix tables and note the prefix rule (system/hardware/services → system.nix, the rest → home.nix). Co-Authored-By: Claude Opus 4.8 --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index e87a861..062993f 100644 --- a/README.md +++ b/README.md @@ -182,6 +182,13 @@ 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)**. +**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. + +**`home.nix`** (Home Manager — the desktop): + | Option | Default | Purpose | |---|---|---| | `nomarchy.stateFile` | — (required) | Path to your theme-state.json | @@ -208,6 +215,11 @@ examples: **[docs/OVERRIDES.md](docs/OVERRIDES.md)**. | `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 | + +**`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 |