nixos_config/README.md

NixOS Configuration Layout

This repository is structured around explicit NixOS and Home Manager layers.

Directory Overview

• nixos/hosts/<host>/
  • Host-specific configuration.nix and hardware-configuration.nix.
• nixos/modules/
  • Shared NixOS modules:
    • base.nix
    • profiles/ (workstation.nix, server.nix)
    • wm/ (sway.nix, gnome.nix)
    • theme/ (stylix.nix)
• home/users/
  • User base modules (alisceon, root).
• home/profiles/
  • Shared Home Manager profile composition.
• home/modules/
  • Home Manager feature modules grouped by programs/, services/, and wm/.
• home/hosts/alisceon/
  • Host-specific Home Manager overrides for alisceon.
• lib/
  • Shared helper libraries imported by modules.
• util/
  • Local helper scripts.

Composition Rules

• flake.nix is the single composition entrypoint for hosts.
• NixOS host modules should import only host-local hardware config and rely on shared modules from nixos/modules.
• Home Manager host overrides should stay small and contain only host deltas.
• Reusable behavior belongs in nixos/modules or home/modules, not in host files.

Local Validation

Run these in your normal environment:

nix flake show
nix eval .#nixosConfigurations.electra.config.system.build.toplevel.drvPath
nix eval .#nixosConfigurations.tower.config.system.build.toplevel.drvPath
nix eval .#nixosConfigurations.tesla-nixos.config.system.build.toplevel.drvPath
nix eval .#nixosConfigurations.nuc.config.system.build.toplevel.drvPath
nix flake check --no-build