Split Home Manager configuration into per-user modules #111

New issue

Closed

opened 2026-07-28 08:20:18 +01:00 by nimmo · 0 comments

nimmo commented

2026-07-28 08:20:18 +01:00

Owner

Goal

Replace the monolithic home/nimmo.nix entry point with a scalable per-user Home Manager layout.

Proposed shape

home/
  common/
    cli.nix
    shell.nix
    desktop-tools.nix
  users/
    nimmo/
      default.nix
      git.nix
      browser.nix
      desktop.nix
      download-organizer.nix
      plasma.nix
    claire/
      default.nix

Scope

Move Nimmo-specific configuration from home/nimmo.nix into focused modules under home/users/nimmo/.
Create a clear shared-module location for configuration genuinely reusable by multiple users.
Update the flake/Home Manager wiring to import home/users/<primaryUser>/.
Preserve current host-specific behavior, including server versus desktop conditionals and Plasma configuration.
Keep the layout ready for additional users without requiring another monolithic file.

Design constraints

Do not move host-specific system configuration into user modules.
Do not label configuration as shared merely because it is currently used by one user on multiple hosts.
Avoid over-fragmenting tiny, tightly coupled settings; modules should represent coherent concerns.

Acceptance criteria

Existing Nimmo configurations evaluate with unchanged behavior.
home/nimmo.nix is removed or reduced to a deliberate compatibility entry point.
Shared versus user-specific ownership is documented by the directory structure.
Adding a second user requires adding a new user directory and Home Manager entry, not editing Nimmo's modules.
nix flake check and targeted host builds pass.
README structure documentation is updated.

## Goal Replace the monolithic `home/nimmo.nix` entry point with a scalable per-user Home Manager layout. ## Proposed shape ``` home/ common/ cli.nix shell.nix desktop-tools.nix users/ nimmo/ default.nix git.nix browser.nix desktop.nix download-organizer.nix plasma.nix claire/ default.nix ``` ## Scope - Move Nimmo-specific configuration from `home/nimmo.nix` into focused modules under `home/users/nimmo/`. - Create a clear shared-module location for configuration genuinely reusable by multiple users. - Update the flake/Home Manager wiring to import `home/users/<primaryUser>/`. - Preserve current host-specific behavior, including server versus desktop conditionals and Plasma configuration. - Keep the layout ready for additional users without requiring another monolithic file. ## Design constraints - Do not move host-specific system configuration into user modules. - Do not label configuration as shared merely because it is currently used by one user on multiple hosts. - Avoid over-fragmenting tiny, tightly coupled settings; modules should represent coherent concerns. ## Acceptance criteria - Existing Nimmo configurations evaluate with unchanged behavior. - `home/nimmo.nix` is removed or reduced to a deliberate compatibility entry point. - Shared versus user-specific ownership is documented by the directory structure. - Adding a second user requires adding a new user directory and Home Manager entry, not editing Nimmo's modules. - `nix flake check` and targeted host builds pass. - README structure documentation is updated.

nimmo added this to the Developer Experience and Configuration Hygiene milestone

2026-07-28 08:20:18 +01:00

nimmo referenced this issue

2026-07-28 08:35:02 +01:00

Clarify module, profile, and host boundaries #113

nimmo modified the milestone from Developer Experience and Configuration Hygiene to Configuration Architecture Hygiene

2026-07-28 08:36:36 +01:00

nimmo referenced this issue

2026-07-28 08:37:50 +01:00

Decompose oversized profiles where useful #115

nimmo referenced this issue

2026-07-28 09:51:15 +01:00