Revert "fix: build closure in build-step instead of on iso"

This reverts commit b23525df78.

.gitea/workflows/ci.yml

@@ -26,23 +26,18 @@ jobs:
   format-check:
     name: Format Check
     runs-on: [self-hosted, nix-builder]
-    timeout-minutes: 5
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
       - name: Check formatting
-        timeout-minutes: 3
         run: |
-          set -euo pipefail
+          nix fmt **/*.nix
-          echo "Checking code formatting..."
+          if ! git diff --quiet; then
-          output=$(nix fmt **/*.nix 2>&1)
-          if [ -n "$output" ]; then
             echo "::error::Code is not formatted. Please run 'nix fmt **/*.nix' locally."
-            echo "$output"
+            git diff
             exit 1
           fi
-          echo "All files are properly formatted"
 
   eval-configs:
     name: Evaluate Key Configurations
@@ -84,39 +79,3 @@ jobs:
           echo "Evaluating artifact ${{ matrix.artifact }}"
           nix eval .#${{ matrix.artifact }}.drvPath \
             --show-trace
-
-  build-docs:
-    name: Build and Publish Documentation
-    runs-on: [self-hosted, nix-builder]
-    needs: [flake-check]
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Build documentation
-        run: |
-          echo "Building Athenix documentation"
-          nix build .#docs --print-build-logs
-
-      - name: Clone wiki repository
-        run: |
-          git clone git@factory.uga.edu:UGA-Innovation-Factory/athenix.wiki.git wiki
-          cd wiki
-          git config user.name "Athenix CI"
-          git config user.email "ci@athenix.factory.uga.edu"
-
-      - name: Update wiki with documentation
-        run: |
-          # Copy documentation to wiki
-          cp -r result/* wiki/
-          
-          # Commit and push changes
-          cd wiki
-          git add .
-          if git diff --staged --quiet; then
-            echo "No documentation changes to commit"
-          else
-            git commit -m "Update documentation from commit ${{ github.sha }}"
-            git push
-          fi

.github/copilot-instructions.md

@@ -26,9 +26,8 @@ This is a **NixOS system configuration repository** that uses:
 - **`flake.nix`**: Entry point - inputs and outputs only
 - **`inventory.nix`**: Fleet definitions - host configurations
 - **`users.nix`**: User account definitions
-- **`hw/`**: Hardware type modules (desktop, laptop, surface, lxc, wsl, etc.)
+- **`hosts/`**: Host generation logic and hardware types
-- **`fleet/`**: Fleet generation logic and common system configuration
+- **`sw/`**: Software configurations organized by system type
-- **`sw/`**: Software configurations by system type
 - **`installer/`**: Build artifact generation (ISO, LXC, etc.)
 - **`templates/`**: Templates for external configurations
 
@@ -45,12 +44,9 @@ All Innovation Factory-specific options MUST use the `athenix` namespace:
 ### Host Options (`athenix.host.*`)
 ```nix
 athenix.host = {
-  filesystem.device = "/dev/nvme0n1"; # Boot disk (default: null)
+  filesystem.device = "/dev/sda";      # Boot disk
-  filesystem.swapSize = "32G";         # Swap size (default: null)
+  filesystem.swapSize = "32G";         # Swap size
-  buildMethods = [ "installer-iso" ];  # Artifact types (defined in sw/gc.nix)
+  buildMethods = [ "iso" ];            # Artifact types
-  useHostPrefix = true;                # Hostname prefix behavior
-  wsl.user = "username";               # WSL default user
-};
   useHostPrefix = true;                # Hostname prefix behavior
   wsl.user = "username";               # WSL default user
 };
@@ -117,17 +113,6 @@ athenix.forUser = "username";            # Convenience: enable user + set WSL us
 3. System modules: Provide `default.nix` that accepts `{ inputs, ... }`
 4. Reference in `inventory.nix` or `users.nix` using `builtins.fetchGit`
 
-#### Using Athenix as a Library
-External flakes can use Athenix's fleet generator:
-```nix
-outputs = { athenix, ... }: {
-  nixosConfigurations = athenix.lib.mkFleet {
-    fleet = import ./custom-inventory.nix;
-    hwTypes = import ./custom-hardware.nix;
-  };
-};
-```
-
 ## Important Constraints
 
 ### What NOT to Do

.github/workflows/docs.yml

@@ -1,34 +0,0 @@
-name: Build Documentation
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-
-jobs:
-  build-docs:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: DeterminateSystems/nix-installer-action@main
-      
-      - uses: DeterminateSystems/magic-nix-cache-action@main
-      
-      - name: Build documentation
-        run: |
-          nix build .#docs
-          nix build .#athenix-options
-          
-      - name: Upload documentation
-        uses: actions/upload-artifact@v4
-        with:
-          name: athenix-docs
-          path: result/
-          
-      - name: Deploy to GitHub Pages
-        if: github.ref == 'refs/heads/main'
-        uses: peaceiris/actions-gh-pages@v4
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./result

.nixd.json

@@ -1,18 +0,0 @@
-{
-  "eval": {
-    "target": {
-      "installable": ".#nixosConfigurations.nix-desktop1.options"
-    }
-  },
-  "formatting": {
-    "command": ["nixfmt"]
-  },
-  "options": {
-    "nixos": {
-      "expr": "(builtins.getFlake \"/home/engr-ugaif/athenix\").nixosConfigurations.nix-desktop1.options"
-    },
-    "home-manager": {
-      "expr": "(builtins.getFlake \"/home/engr-ugaif/athenix\").nixosConfigurations.nix-desktop1.config.home-manager.users.engr-ugaif.options"
-    }
-  }
-}

README.md

@@ -54,21 +54,18 @@ users.nix                 # User account definitions
 
 flake.lock                # Locked dependency versions
 
-hw/                 # Hardware type modules (exportable as nixosModules)
+hosts/                    # Host generation logic
-├── default.nix           # Auto-exports all variant types
+├── default.nix           # Main host generator
-├── nix-desktop.nix       # Desktop workstations
-├── nix-laptop.nix        # Laptop systems
-├── nix-surface.nix       # Surface Pro tablets
-├── nix-lxc.nix           # LXC containers
-├── nix-wsl.nix           # WSL instances
-├── nix-zima.nix          # ZimaBoard systems
-└── nix-ephemeral.nix     # Diskless/netboot systems
-
-fleet/                    # Fleet generation and common configuration
-├── default.nix           # Processes inventory.nix to generate all hosts
-├── common.nix            # Common NixOS configuration (all hosts)
 ├── boot.nix              # Boot and filesystem configuration
-└── user-config.nix       # User account and home-manager integration
+├── common.nix            # Common system configuration
+├── user-config.nix       # User configuration integration
+└── types/                # Hardware type modules
+    ├── nix-desktop.nix
+    ├── nix-laptop.nix
+    ├── nix-surface.nix
+    ├── nix-lxc.nix
+    ├── nix-wsl.nix
+    └── nix-ephemeral.nix
 
 sw/                       # Software configurations by system type
 ├── default.nix           # Software module entry point
@@ -233,35 +230,6 @@ nix flake show
 
 **See [docs/BUILDING.md](docs/BUILDING.md) for complete guide.**
 
-### Using Athenix as a Library
-
-Import Athenix in your own flake to use its fleet generation logic with custom inventory:
-
-```nix
-{
-  inputs.athenix.url = "git+https://git.factory.uga.edu/UGA-Innovation-Factory/athenix.git";
-  
-  outputs = { self, athenix, ... }: {
-    # Generate configurations with custom fleet and hardware types
-    nixosConfigurations = athenix.lib.mkFleet {
-      fleet = import ./my-inventory.nix;
-      hwTypes = import ./my-hardware-types.nix;
-    };
-    
-    # Or use individual modules
-    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
-      modules = [
-        athenix.nixosModules.hw.nix-desktop  # Use Athenix hardware configs
-        athenix.nixosModules.sw              # Use Athenix software configs
-        ./configuration.nix
-      ];
-    };
-  };
-}
-```
-
-**Exported modules:** `nix-desktop`, `nix-laptop`, `nix-surface`, `nix-lxc`, `nix-wsl`, `nix-ephemeral`, `nix-zima`, `sw`, `common`
-
 ## System Types
 
 Set via `athenix.sw.type`:

docs/DEVELOPMENT.md

@@ -87,7 +87,7 @@ athenix.users.newuser = {
 };
 ```
 
-2. Enable on fleet in `inventory.nix`:
+2. Enable on hosts in `inventory.nix`:
 
 ```nix
 nix-laptop = {
@@ -294,7 +294,7 @@ For system config:
 ```nix
 # inventory.nix
 nix-lxc = {
-  devices."server".external = builtins.fetchGit {
+  devices."server" = builtins.fetchGit {
     url = "https://git.factory.uga.edu/org/server-config";
     rev = "abc123...";
   };

docs/EXTERNAL_MODULES.md

@@ -28,42 +28,26 @@ External system modules provide host-specific NixOS configurations.
 
 ### Usage
 
-In `inventory.nix`, reference an external module using the `external` field:
+In `inventory.nix`, reference an external module as a device:
 
 ```nix
 nix-lxc = {
   devices = {
-    # Inline configuration (traditional method)
+    # Inline configuration
     "local-server" = {
       athenix.sw.type = "headless";
       services.nginx.enable = true;
     };
     
-    # External module (lazy evaluation - fetched only when building this host)
+    # External module
-    "remote-server".external = builtins.fetchGit {
+    "remote-server" = builtins.fetchGit {
       url = "https://git.factory.uga.edu/org/server-config";
       rev = "abc123def456...";  # Must pin to specific commit
     };
-    
-    # External module with additional local config
-    "mixed-server" = {
-      external = builtins.fetchGit {
-        url = "https://git.factory.uga.edu/org/server-config";
-        rev = "abc123def456...";
-      };
-      # Additional local overrides
-      athenix.users.admin.enable = true;
-      services.openssh.permitRootLogin = "no";
-    };
   };
 };
 ```
 
-**Key Features:**
-- **Lazy Evaluation**: External modules are only fetched when building the specific host
-- **Efficient Rebuilds**: Other hosts can be rebuilt without fetching unrelated external modules
-- **Submodule Support**: Works with Git submodules without affecting other hosts
-
 ### Repository Structure
 
 ```
@@ -115,8 +99,8 @@ server-config/
 
 When a host is built, modules load in this order:
 
-1. Hardware type module (from `hw/nix-*.nix`)
+1. Hardware type module (from `hosts/types/nix-*.nix`)
-2. Common system configuration (from `fleet/common.nix`)
+2. Host common configuration (from `hosts/common.nix`)
 3. Software type module (from `sw/{type}/`)
 4. User NixOS modules (from `users.nix` - `nixos.nix` files)
 5. Device-specific overrides (from `inventory.nix`)

docs/INVENTORY.md

@@ -123,11 +123,11 @@ nix-surface = {
 
 ### Method 4: External Module
 
-Reference a Git repository using the `external` field (lazy evaluation):
+Reference a Git repository instead of inline configuration:
 
 ```nix
 nix-lxc = {
-  devices."builder".external = builtins.fetchGit {
+  devices."builder" = builtins.fetchGit {
     url = "https://git.factory.uga.edu/org/builder-config";
     rev = "abc123...";
   };

docs/NAMESPACE.md

@@ -17,9 +17,9 @@ Hardware and boot-related settings.
 
 Boot disk device path.
 
-**Type:** String or null
+**Type:** String
 
-**Default:** `null` (must be set by hardware type or per-host)
+**Default:** `"/dev/sda"`
 
 **Example:**
 ```nix
@@ -30,9 +30,9 @@ athenix.host.filesystem.device = "/dev/nvme0n1";
 
 Swap partition size.
 
-**Type:** String (size with unit, e.g., `"32G"`, `"2G"`) or null
+**Type:** String (size with unit, e.g., `"32G"`, `"2G"`)
 
-**Default:** `null` (must be set by hardware type or per-host)
+**Default:** `"32G"`
 
 **Example:**
 ```nix

flake.lock

@@ -159,26 +159,6 @@
       }
     },
     "flake-parts": {
-      "inputs": {
-        "nixpkgs-lib": [
-          "nixpkgs"
-        ]
-      },
-      "locked": {
-        "lastModified": 1768135262,
-        "narHash": "sha256-PVvu7OqHBGWN16zSi6tEmPwwHQ4rLPU9Plvs8/1TUBY=",
-        "owner": "hercules-ci",
-        "repo": "flake-parts",
-        "rev": "80daad04eddbbf5a4d883996a73f3f542fa437ac",
-        "type": "github"
-      },
-      "original": {
-        "owner": "hercules-ci",
-        "repo": "flake-parts",
-        "type": "github"
-      }
-    },
-    "flake-parts_2": {
       "inputs": {
         "nixpkgs-lib": [
           "lazyvim-nixvim",
@@ -239,24 +219,6 @@
       "inputs": {
         "systems": "systems_4"
       },
-      "locked": {
-        "lastModified": 1731533236,
-        "narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",
-        "owner": "numtide",
-        "repo": "flake-utils",
-        "rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",
-        "type": "github"
-      },
-      "original": {
-        "owner": "numtide",
-        "repo": "flake-utils",
-        "type": "github"
-      }
-    },
-    "flake-utils_4": {
-      "inputs": {
-        "systems": "systems_5"
-      },
       "locked": {
         "lastModified": 1681202837,
         "narHash": "sha256-H+Rh19JDwRtpVPAWp64F+rlEtxUWBAQW28eAi3SRSzg=",
@@ -356,11 +318,11 @@
         ]
       },
       "locked": {
-        "lastModified": 1767910483,
+        "lastModified": 1767619900,
-        "narHash": "sha256-MOU5YdVu4DVwuT5ztXgQpPuRRBjSjUGIdUzOQr9iQOY=",
+        "narHash": "sha256-KpoCBPvwHz3gAQtIUkohE2InRBFK3r0/FM6z5SPWfvM=",
         "owner": "nix-community",
         "repo": "home-manager",
-        "rev": "82fb7dedaad83e5e279127a38ef410bcfac6d77c",
+        "rev": "6bd04da47cfb48dfd15eabf08364b78ad894f5b2",
         "type": "github"
       },
       "original": {
@@ -424,7 +386,7 @@
     },
     "lazyvim-nixvim": {
       "inputs": {
-        "flake-parts": "flake-parts_2",
+        "flake-parts": "flake-parts",
         "nixpkgs": "nixpkgs",
         "nixvim": "nixvim"
       },
@@ -556,11 +518,11 @@
     },
     "nixpkgs-old-kernel": {
       "locked": {
-        "lastModified": 1767313136,
+        "lastModified": 1767051569,
-        "narHash": "sha256-16KkgfdYqjaeRGBaYsNrhPRRENs0qzkQVUooNHtoy2w=",
+        "narHash": "sha256-0MnuWoN+n1UYaGBIpqpPs9I9ZHW4kynits4mrnh1Pk4=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "ac62194c3917d5f474c1a844b6fd6da2db95077d",
+        "rev": "40ee5e1944bebdd128f9fbada44faefddfde29bd",
         "type": "github"
       },
       "original": {
@@ -572,11 +534,11 @@
     },
     "nixpkgs_2": {
       "locked": {
-        "lastModified": 1768242861,
+        "lastModified": 1767480499,
-        "narHash": "sha256-F4IIxa5xDHjtrmMcayM8lHctUq1oGltfBQu2+oqDWP4=",
+        "narHash": "sha256-8IQQUorUGiSmFaPnLSo2+T+rjHtiNWc+OAzeHck7N48=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "1327e798cb055f96f92685df444e9a2c326ab5ed",
+        "rev": "30a3c519afcf3f99e2c6df3b359aec5692054d92",
         "type": "github"
       },
       "original": {
@@ -646,7 +608,6 @@
       "inputs": {
         "agenix": "agenix",
         "disko": "disko",
-        "flake-parts": "flake-parts",
         "home-manager": "home-manager_2",
         "lazyvim-nixvim": "lazyvim-nixvim",
         "nixos-generators": "nixos-generators",
@@ -654,7 +615,6 @@
         "nixos-wsl": "nixos-wsl",
         "nixpkgs": "nixpkgs_2",
         "nixpkgs-old-kernel": "nixpkgs-old-kernel",
-        "usda-vision": "usda-vision",
         "vscode-server": "vscode-server"
       }
     },
@@ -739,21 +699,6 @@
         "type": "github"
       }
     },
-    "systems_5": {
-      "locked": {
-        "lastModified": 1681028828,
-        "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
-        "owner": "nix-systems",
-        "repo": "default",
-        "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
-        "type": "github"
-      },
-      "original": {
-        "owner": "nix-systems",
-        "repo": "default",
-        "type": "github"
-      }
-    },
     "treefmt-nix": {
       "inputs": {
         "nixpkgs": [
@@ -776,30 +721,9 @@
         "type": "github"
       }
     },
-    "usda-vision": {
-      "inputs": {
-        "flake-utils": "flake-utils_3",
-        "nixpkgs": [
-          "nixpkgs"
-        ]
-      },
-      "locked": {
-        "lastModified": 1769814438,
-        "narHash": "sha256-DEZrmqpqbrd996W5p1r4GA1C8Jmo31n3N642ccS0deY=",
-        "ref": "refs/heads/main",
-        "rev": "78bfcf02612817a2cee1edbf92deeac9bf657613",
-        "revCount": 126,
-        "type": "git",
-        "url": "https://git.factory.uga.edu/MODEL/usda-vision.git"
-      },
-      "original": {
-        "type": "git",
-        "url": "https://git.factory.uga.edu/MODEL/usda-vision.git"
-      }
-    },
     "vscode-server": {
       "inputs": {
-        "flake-utils": "flake-utils_4",
+        "flake-utils": "flake-utils_3",
         "nixpkgs": [
           "nixpkgs"
         ]

flake.nix

@@ -4,7 +4,7 @@
   # ============================================================================
   # This file defines the inputs (dependencies) and outputs (configurations)
   # for Athenix. It ties together the hardware, software, and user
-  # configurations into deployable systems using flake-parts.
+  # configurations into deployable systems.
 
   inputs = {
     # Core NixOS package repository (Release 25.11)
@@ -13,12 +13,6 @@
     # Older kernel packages for Surface compatibility if needed
     nixpkgs-old-kernel.url = "github:NixOS/nixpkgs/nixos-25.05";
 
-    # Flake-parts for modular flake organization
-    flake-parts = {
-      url = "github:hercules-ci/flake-parts";
-      inputs.nixpkgs-lib.follows = "nixpkgs";
-    };
-
     # Home Manager for user environment management
     home-manager = {
       url = "github:nix-community/home-manager/release-25.11";
@@ -59,37 +53,49 @@
       url = "github:nix-community/NixOS-WSL/main";
       inputs.nixpkgs.follows = "nixpkgs";
     };
-
-    # USDA Vision Dashboard application
-    usda-vision = {
-      url = "git+https://git.factory.uga.edu/MODEL/usda-vision.git";
-      inputs.nixpkgs.follows = "nixpkgs";
   };
-  };
-
   outputs =
-    inputs@{ self, flake-parts, ... }:
+    inputs@{
-    flake-parts.lib.mkFlake { inherit inputs; } {
+      self,
-      # Support all common systems
+      nixpkgs,
-      systems = [
+      nixpkgs-old-kernel,
+      home-manager,
+      disko,
+      agenix,
+      lazyvim-nixvim,
+      nixos-hardware,
+      vscode-server,
+      nixos-generators,
+      ...
+    }:
+    let
+      hosts = import ./hosts { inherit inputs; };
+      linuxSystem = "x86_64-linux";
+      artifacts = import ./installer/artifacts.nix {
+        inherit inputs hosts self;
+        system = linuxSystem;
+      };
+      forAllSystems = nixpkgs.lib.genAttrs [
         "x86_64-linux"
         "aarch64-linux"
         "x86_64-darwin"
         "aarch64-darwin"
       ];
+    in
+    {
+      # Formatter for 'nix fmt'
+      formatter = forAllSystems (system: nixpkgs.legacyPackages.${system}.nixfmt-rfc-style);
 
-      # Import flake-parts modules
+      # Generate NixOS configurations from hosts/default.nix
-      imports = [
+      nixosConfigurations = hosts.nixosConfigurations;
-        ./parts/formatter.nix
+
-        ./parts/lib.nix
+      # Expose artifacts to all systems, but they are always built for x86_64-linux
-        ./parts/nixos-configurations.nix
+      packages = forAllSystems (_: artifacts);
-        ./parts/nixos-modules.nix
+
-        ./parts/packages.nix
+      # Expose modules for external use
-        ./parts/templates.nix
+      nixosModules = import ./installer/modules.nix { inherit inputs; };
-        ./parts/docs.nix
+
-        ./inventory.nix
+      # Templates for external configurations
-        ./users.nix
+      templates = import ./templates;
-      ];
     };
-
 }

fleet/boot.nix

@@ -1,64 +0,0 @@
-# ============================================================================
-# Boot configuration module
-# ============================================================================
-# This module defines:
-# - Bootloader configuration (systemd-boot with Plymouth)
-# - Timezone and locale settings
-# - Systemd sleep configuration
-#
-# Only applies to:
-# - Linux systems (not Darwin/macOS)
-# - Systems with actual boot hardware (not containers/WSL)
-
-{
-  config,
-  lib,
-  pkgs,
-  ...
-}:
-
-let
-  # Check if this is a bootable system (not container, not WSL)
-  isBootable = !(config.boot.isContainer or false) && (pkgs.stdenv.isLinux);
-in
-{
-  config = lib.mkIf isBootable {
-    boot = {
-      loader.systemd-boot.enable = lib.mkDefault true;
-      loader.efi.canTouchEfiVariables = lib.mkDefault true;
-      plymouth.enable = lib.mkDefault true;
-
-      # Enable "Silent boot"
-      consoleLogLevel = 3;
-      initrd.verbose = false;
-
-      # Hide the OS choice for bootloaders.
-      # It's still possible to open the bootloader list by pressing any key
-      # It will just not appear on screen unless a key is pressed
-      loader.timeout = lib.mkDefault 0;
-    };
-
-    # Set your time zone.
-    time.timeZone = "America/New_York";
-
-    # Select internationalisation properties.
-    i18n.defaultLocale = "en_US.UTF-8";
-
-    i18n.extraLocaleSettings = {
-      LC_ADDRESS = "en_US.UTF-8";
-      LC_IDENTIFICATION = "en_US.UTF-8";
-      LC_MEASUREMENT = "en_US.UTF-8";
-      LC_MONETARY = "en_US.UTF-8";
-      LC_NAME = "en_US.UTF-8";
-      LC_NUMERIC = "en_US.UTF-8";
-      LC_PAPER = "en_US.UTF-8";
-      LC_TELEPHONE = "en_US.UTF-8";
-      LC_TIME = "en_US.UTF-8";
-    };
-
-    systemd.sleep.extraConfig = ''
-      SuspendState=freeze
-      HibernateDelaySec=2h
-    '';
-  };
-}

fleet/common.nix

@@ -1,196 +0,0 @@
-# ============================================================================
-# Common Host Module
-# ============================================================================
-# This module contains all the common configuration shared by all host types.
-# It is automatically imported by the fleet generator for every host.
-
-{
-  config,
-  lib,
-  inputs,
-  ...
-}:
-let
-  # Import all hardware modules so they're available for enabling
-  hwTypes = import ../hw { inherit inputs; };
-  hwModules = lib.attrValues hwTypes;
-
-  # User account submodule definition
-  userSubmodule = lib.types.submodule {
-    options = {
-      enable = lib.mkOption {
-        type = lib.types.bool;
-        default = false;
-        description = "Whether this user account is enabled on this system.";
-      };
-      isNormalUser = lib.mkOption {
-        type = lib.types.bool;
-        default = true;
-        description = "Whether this is a normal user account (vs system user).";
-      };
-      description = lib.mkOption {
-        type = lib.types.nullOr lib.types.str;
-        default = null;
-        description = "Full name or description of the user (GECOS field).";
-        example = "John Doe";
-      };
-      extraGroups = lib.mkOption {
-        type = lib.types.listOf lib.types.str;
-        default = [ ];
-        description = "Additional groups for the user (wheel, docker, etc.).";
-      };
-      hashedPassword = lib.mkOption {
-        type = lib.types.str;
-        default = "!";
-        description = "Hashed password for the user account. Default '!' means locked.";
-      };
-      extraPackages = lib.mkOption {
-        type = lib.types.listOf lib.types.package;
-        default = [ ];
-        description = "Additional system packages available to this user.";
-      };
-      excludePackages = lib.mkOption {
-        type = lib.types.listOf lib.types.package;
-        default = [ ];
-        description = "System packages to exclude for this user.";
-      };
-      homePackages = lib.mkOption {
-        type = lib.types.listOf lib.types.package;
-        default = [ ];
-        description = "Packages to install in the user's home-manager profile.";
-      };
-      extraImports = lib.mkOption {
-        type = lib.types.listOf lib.types.path;
-        default = [ ];
-        description = "Additional home-manager modules to import for this user.";
-      };
-      external = lib.mkOption {
-        type = lib.types.nullOr (
-          lib.types.oneOf [
-            lib.types.path
-            (lib.types.submodule {
-              options = {
-                url = lib.mkOption {
-                  type = lib.types.str;
-                  description = "Git repository URL to fetch user configuration from.";
-                };
-                rev = lib.mkOption {
-                  type = lib.types.str;
-                  description = "Git commit hash, tag, or branch to fetch.";
-                };
-                submodules = lib.mkOption {
-                  type = lib.types.bool;
-                  default = false;
-                  description = "Whether to fetch Git submodules.";
-                };
-              };
-            })
-          ]
-        );
-        default = null;
-        description = "External dotfiles repository (user.nix + optional nixos.nix).";
-      };
-      opensshKeys = lib.mkOption {
-        type = lib.types.listOf lib.types.str;
-        default = [ ];
-        description = "SSH public keys for the user (authorized_keys).";
-      };
-      shell = lib.mkOption {
-        type = lib.types.nullOr (
-          lib.types.enum [
-            "bash"
-            "zsh"
-            "fish"
-            "tcsh"
-          ]
-        );
-        default = "bash";
-        description = "Default shell for the user.";
-      };
-      editor = lib.mkOption {
-        type = lib.types.nullOr (
-          lib.types.enum [
-            "vim"
-            "neovim"
-            "emacs"
-            "nano"
-            "code"
-          ]
-        );
-        default = "neovim";
-        description = "Default text editor for the user (sets EDITOR).";
-      };
-      useZshTheme = lib.mkOption {
-        type = lib.types.bool;
-        default = true;
-        description = "Whether to apply the system Zsh theme (Oh My Posh).";
-      };
-      useNvimPlugins = lib.mkOption {
-        type = lib.types.bool;
-        default = true;
-        description = "Whether to apply the system Neovim configuration.";
-      };
-    };
-  };
-in
-{
-  imports = [
-    ./fs.nix
-    ./boot.nix
-    ./user-config.nix
-    ../sw
-    inputs.vscode-server.nixosModules.default
-    inputs.nixos-wsl.nixosModules.default
-  ]
-  ++ hwModules;
-
-  options.athenix.users = lib.mkOption {
-    type = lib.types.attrsOf userSubmodule;
-    default = { };
-    description = "User accounts configuration. Set enable=true for users that should exist on this system.";
-  };
-
-  options.athenix = {
-    forUser = lib.mkOption {
-      type = lib.types.nullOr lib.types.str;
-      default = null;
-      description = ''
-        Convenience option to configure a host for a specific user.
-
-        When set, automatically:
-        - Enables the user account (athenix.users.<username>.enable = true)
-        - Sets as default WSL user (on WSL systems)
-
-        The username must exist in athenix.users (defined in users.nix).
-      '';
-      example = "engr-ugaif";
-    };
-    host.useHostPrefix = lib.mkOption {
-      type = lib.types.bool;
-      default = true;
-      description = ''
-        Whether to prepend the hardware type prefix to the hostname.
-
-        When true:
-        - "nix-laptop" with device "1" → hostname "nix-laptop1"
-        - "nix-wsl" with device "alice" → hostname "nix-wsl-alice"
-
-        When false:
-        - Device name becomes the full hostname (useful for custom names)
-      '';
-    };
-  };
-
-  config = lib.mkMerge [
-    (lib.mkIf (config.athenix.forUser != null) {
-      athenix.users.${config.athenix.forUser}.enable = true;
-    })
-    {
-      system.stateVersion = "25.11";
-      nix.settings.experimental-features = [
-        "nix-command"
-        "flakes"
-      ];
-    }
-  ];
-}

fleet/fleet-option.nix

@@ -1,227 +0,0 @@
-# ============================================================================
-# Fleet Option Definition
-# ============================================================================
-# This module defines the athenix.fleet and athenix.hwTypes options.
-# Self-contained fleet management without dependencies on user configuration.
-{ inputs, lib, ... }:
-let
-  fleetDefinition = lib.mkOption {
-    description = "Hardware types definitions for the fleet.";
-    type = lib.types.attrsOf (
-      lib.types.submodule (
-        { name, ... }:
-        {
-          options = {
-            type = lib.mkOption {
-              type = lib.types.oneOf [
-                lib.types.str
-                lib.types.listOf
-                lib.types.str
-              ];
-              default = name;
-              description = "Type(s) of system configuration for this device.";
-            };
-            system = lib.mkOption {
-              type = lib.types.str;
-              default = "x86_64-linux";
-              description = "NixOS system architecture for this hardware type.";
-            };
-            devices = lib.mkOption {
-              type = lib.types.oneOf [
-                lib.types.int
-                (lib.types.attrsOf (
-                  lib.types.submodule (
-                    { ... }:
-                    {
-                      freeformType = lib.types.attrs;
-                    }
-                  )
-                ))
-              ];
-            };
-            count = lib.mkOption {
-              type = lib.types.int;
-              default = 0;
-              description = "Number of devices of this type to create.";
-            };
-            defaultCount = lib.mkOption {
-              type = lib.types.int;
-              default = 0;
-              description = "Default number of devices to create with default configurations and numbered hostnames.";
-            };
-            overrides = lib.mkOption {
-              type = lib.types.attrs;
-              default = { };
-              description = "Overrides to apply to all devices of this type.";
-            };
-          };
-        }
-      )
-    );
-  };
-
-  # Forward declaration for user options (full definition in user-config.nix)
-  # This allows users.nix to be evaluated at flake level
-  userSubmodule = lib.types.submodule {
-    options = {
-      enable = lib.mkOption {
-        type = lib.types.bool;
-        default = false;
-        description = "Whether this user account is enabled on this system.";
-      };
-      isNormalUser = lib.mkOption {
-        type = lib.types.bool;
-        default = true;
-        description = "Whether this is a normal user account (vs system user).";
-      };
-      description = lib.mkOption {
-        type = lib.types.nullOr lib.types.str;
-        default = null;
-        description = "Full name or description of the user (GECOS field).";
-        example = "John Doe";
-      };
-      extraGroups = lib.mkOption {
-        type = lib.types.listOf lib.types.str;
-        default = [ ];
-        description = "Additional groups for the user (wheel, docker, etc.).";
-        example = [
-          "wheel"
-          "networkmanager"
-          "docker"
-        ];
-      };
-      hashedPassword = lib.mkOption {
-        type = lib.types.str;
-        default = "!";
-        description = ''
-          Hashed password for the user account.
-          Generate with: mkpasswd -m sha-512
-          Default "!" means account is locked (SSH key only).
-        '';
-      };
-      extraPackages = lib.mkOption {
-        type = lib.types.listOf lib.types.package;
-        default = [ ];
-        description = "Additional system packages available to this user.";
-        example = lib.literalExpression "[ pkgs.vim pkgs.git ]";
-      };
-      excludePackages = lib.mkOption {
-        type = lib.types.listOf lib.types.package;
-        default = [ ];
-        description = "System packages to exclude for this user.";
-      };
-      homePackages = lib.mkOption {
-        type = lib.types.listOf lib.types.package;
-        default = [ ];
-        description = "Packages to install in the user's home-manager profile.";
-        example = lib.literalExpression "[ pkgs.firefox pkgs.vscode ]";
-      };
-      extraImports = lib.mkOption {
-        type = lib.types.listOf lib.types.path;
-        default = [ ];
-        description = "Additional home-manager modules to import for this user.";
-      };
-      external = lib.mkOption {
-        type = lib.types.nullOr (
-          lib.types.oneOf [
-            lib.types.path
-            (lib.types.submodule {
-              options = {
-                url = lib.mkOption {
-                  type = lib.types.str;
-                  description = "Git repository URL to fetch user configuration from.";
-                  example = "https://github.com/username/dotfiles";
-                };
-                rev = lib.mkOption {
-                  type = lib.types.str;
-                  description = "Git commit hash, tag, or branch to fetch.";
-                  example = "abc123def456...";
-                };
-                submodules = lib.mkOption {
-                  type = lib.types.bool;
-                  default = false;
-                  description = "Whether to fetch Git submodules.";
-                };
-              };
-            })
-          ]
-        );
-        default = null;
-        description = ''
-          External user configuration module from Git or local path.
-
-          Can be either:
-          - A local path: /path/to/config
-          - A Git repository: { url = "..."; rev = "..."; submodules? = false; }
-
-          The Git repository is only fetched when the user is actually enabled.
-
-          Should contain user.nix (user options + home-manager config)
-          and optionally nixos.nix (system-level config).
-        '';
-        example = lib.literalExpression ''
-          {
-                    url = "https://github.com/username/dotfiles";
-                    rev = "abc123def456789abcdef0123456789abcdef012";
-                    submodules = false;
-                  }'';
-      };
-      opensshKeys = lib.mkOption {
-        type = lib.types.listOf lib.types.str;
-        default = [ ];
-        description = "SSH public keys for the user (authorized_keys).";
-        example = [ "ssh-ed25519 AAAAC3Nza... user@host" ];
-      };
-      shell = lib.mkOption {
-        type = lib.types.nullOr (
-          lib.types.enum [
-            "bash"
-            "zsh"
-            "fish"
-            "tcsh"
-          ]
-        );
-        default = "bash";
-        description = "Default shell for the user.";
-      };
-      editor = lib.mkOption {
-        type = lib.types.nullOr (
-          lib.types.enum [
-            "vim"
-            "neovim"
-            "emacs"
-            "nano"
-            "code"
-          ]
-        );
-        default = "neovim";
-        description = "Default text editor for the user (sets EDITOR).";
-      };
-      useZshTheme = lib.mkOption {
-        type = lib.types.bool;
-        default = true;
-        description = "Whether to apply the system Zsh theme (Oh My Posh).";
-      };
-      useNvimPlugins = lib.mkOption {
-        type = lib.types.bool;
-        default = true;
-        description = "Whether to apply the system Neovim configuration.";
-      };
-    };
-  };
-in
-{
-  options.athenix = {
-    fleet = fleetDefinition;
-    hwTypes = lib.mkOption {
-      description = "Hardware types definitions for the fleet.";
-      type = lib.types.attrs;
-    };
-    users = lib.mkOption {
-      type = lib.types.attrsOf userSubmodule;
-      description = "User accounts configuration. Set enable=true for users that should exist on this system.";
-    };
-  };
-
-  config.athenix.hwTypes = lib.mkDefault (import ../hw { inherit inputs; });
-}

fleet/fs.nix

@@ -1,132 +0,0 @@
-# ============================================================================
-# FS & Storage Configuration
-# ============================================================================
-# This module defines:
-# - Disko partition layout (EFI, swap, root)
-# - Filesystem options (device, swap size)
-#
-# Only applies to systems with physical disk management needs
-# (not containers, not WSL, not systems without a configured device)
-
-{ config, lib, ... }:
-
-let
-  cfg = config.athenix.host.filesystem;
-  # Only enable disk config if device is set and disko is enabled
-  hasDiskConfig = cfg.device != null && config.disko.enableConfig;
-in
-{
-  options.athenix = {
-    host = {
-      name = lib.mkOption {
-        type = lib.types.str;
-        description = ''
-          Fleet-assigned hostname for this system.
-          Used for secrets discovery and other host-specific configurations.
-        '';
-      };
-      filesystem = {
-        device = lib.mkOption {
-          type = lib.types.nullOr lib.types.str;
-          default = null;
-          description = ''
-            The main disk device to use for automated partitioning and installation.
-
-            When set, enables disko for declarative disk management with:
-            - 1GB EFI boot partition
-            - Optional swap partition (see swapSize)
-            - Root partition using remaining space
-
-            Leave null for systems that don't need disk partitioning (containers, WSL).
-          '';
-          example = "/dev/nvme0n1";
-        };
-        useSwap = lib.mkOption {
-          type = lib.types.bool;
-          default = true;
-          description = ''
-            Whether to create and use a swap partition.
-            Disable for systems with ample RAM or SSDs where swap is undesirable.
-          '';
-        };
-        swapSize = lib.mkOption {
-          type = lib.types.nullOr lib.types.str;
-          default = null;
-          description = ''
-            Size of the swap partition (e.g., "16G", "32G").
-
-            Recommended sizes:
-            - 8-16GB for desktops with 16GB+ RAM
-            - 32GB for laptops (enables hibernation)
-            - Match RAM size for systems <8GB RAM
-          '';
-          example = "32G";
-        };
-      };
-    };
-  };
-
-  config = lib.mkMerge [
-    {
-      # ========== Disk Partitioning (Disko) ==========
-      disko.enableConfig = lib.mkDefault (cfg.device != null);
-    }
-
-    (lib.mkIf hasDiskConfig {
-      disko.devices = {
-        disk.main = {
-          type = "disk";
-          device = cfg.device;
-          content = {
-            type = "gpt";
-            partitions = {
-              # EFI System Partition
-              ESP = {
-                name = "ESP";
-                label = "BOOT";
-                size = "1G";
-                type = "EF00";
-                content = {
-                  type = "filesystem";
-                  format = "vfat";
-                  mountpoint = "/boot";
-                  mountOptions = [ "umask=0077" ];
-                  extraArgs = [
-                    "-n"
-                    "BOOT"
-                  ];
-                };
-              };
-
-              # Swap Partition (size configurable per host)
-              swap = lib.mkIf cfg.useSwap {
-                name = "swap";
-                label = "swap";
-                size = cfg.swapSize;
-                content = {
-                  type = "swap";
-                };
-              };
-
-              # Root Partition (takes remaining space)
-              root = {
-                name = "root";
-                label = "root";
-                size = "100%";
-                content = {
-                  type = "filesystem";
-                  format = "ext4";
-                  mountpoint = "/";
-                  extraArgs = [
-                    "-L"
-                    "ROOT"
-                  ];
-                };
-              };
-            };
-          };
-        };
-      };
-    })
-  ];
-}

fleet/user-config.nix

@@ -1,151 +0,0 @@
-{
-  pkgs,
-  config,
-  lib,
-  inputs,
-  ...
-}:
-
-# ============================================================================
-# User Configuration Module
-# ============================================================================
-# This module implements user account creation and home-manager setup.
-# Options are defined in fleet-option.nix for early availability.
-
-let
-  # Helper: Resolve external module path (with lazy Git fetching)
-  resolveExternalPath =
-    external:
-    if external == null then
-      null
-    # New format: { url, rev, submodules? } - only fetch when needed
-    else if builtins.isAttrs external && external ? url && external ? rev then
-      (builtins.fetchGit {
-        inherit (external) url rev;
-        submodules = external.submodules or false;
-      }).outPath
-    # Legacy: pre-fetched derivation/package
-    else if builtins.isAttrs external && external ? outPath then
-      external.outPath
-    # Direct path
-    else
-      external;
-
-  # Helper: Check if path exists and is valid
-  isValidPath =
-    path:
-    path != null
-    && (builtins.isPath path || (builtins.isString path && lib.hasPrefix "/" path))
-    && builtins.pathExists path;
-in
-{
-  config = {
-
-    # Generate NixOS users
-    users.users =
-      let
-        enabledAccounts = lib.filterAttrs (_: user: user.enable) config.athenix.users;
-      in
-      lib.mapAttrs (
-        name: user:
-        let
-          isPlasma6 = config.services.desktopManager.plasma6.enable;
-          defaultPackages = lib.optionals (isPlasma6 && name != "root") [ pkgs.kdePackages.kate ];
-          finalPackages = lib.subtractLists user.excludePackages (defaultPackages ++ user.extraPackages);
-          shells = {
-            bash = pkgs.bash;
-            zsh = pkgs.zsh;
-            fish = pkgs.fish;
-            tcsh = pkgs.tcsh;
-          };
-        in
-        rec {
-          isNormalUser = user.isNormalUser;
-          inherit (user) extraGroups hashedPassword;
-          description = if user.description != null then user.description else lib.mkDefault "";
-          openssh.authorizedKeys.keys = user.opensshKeys;
-          shell = if user.shell != null then shells.${user.shell} else pkgs.bash;
-          packages = finalPackages ++ [ shell ];
-        }
-      ) enabledAccounts;
-
-    # Home Manager configs per user
-    home-manager = {
-      useGlobalPkgs = true;
-      useUserPackages = true;
-      extraSpecialArgs = {
-        osConfig = config;
-        inherit inputs;
-      };
-
-      users =
-        let
-          enabledAccounts = lib.filterAttrs (_: user: user.enable) config.athenix.users;
-        in
-        lib.mapAttrs (
-          name: user:
-          let
-            # Resolve external module paths
-            hasExternal = user.external != null;
-            externalPath = resolveExternalPath user.external;
-            userNixPath = if externalPath != null then externalPath + "/user.nix" else null;
-            hasExternalUser = isValidPath userNixPath;
-
-            # Import external user.nix for home-manager (filter out athenix.* options)
-            externalUserModule =
-              if hasExternalUser then
-                let
-                  fullModule = import userNixPath { inherit inputs; };
-                in
-                # Only pass through non-athenix options to home-manager
-                {
-                  config,
-                  lib,
-                  pkgs,
-                  osConfig,
-                  ...
-                }:
-                let
-                  evaluated = fullModule {
-                    inherit
-                      config
-                      lib
-                      pkgs
-                      osConfig
-                      ;
-                  };
-                in
-                lib.filterAttrs (attrName: _: attrName != "athenix") evaluated
-              else
-                { };
-
-            # Common imports based on user flags
-            commonImports = lib.optional user.useZshTheme ../sw/theme.nix ++ [
-              (import ../sw/nvim.nix { inherit user; })
-            ];
-
-            # Build imports list
-            allImports = user.extraImports ++ commonImports ++ lib.optional hasExternalUser externalUserModule;
-          in
-          lib.mkMerge [
-            {
-              imports = allImports;
-
-              # Always set these required options
-              home.username = name;
-              home.homeDirectory = lib.mkOverride 999 (if name == "root" then "/root" else "/home/${name}");
-              home.stateVersion = "25.11";
-              programs.${user.editor} = {
-                enable = true;
-                defaultEditor = true;
-              };
-            }
-            (lib.mkIf (!hasExternal) {
-              # For local users only, add their packages
-              home.packages = user.homePackages;
-            })
-          ]
-        ) enabledAccounts;
-    };
-  };
-}

hosts/boot.nix

@@ -0,0 +1,194 @@
+# ============================================================================
+# Boot & Storage Configuration
+# ============================================================================
+# This module defines:
+# - Disko partition layout (EFI, swap, root)
+# - Bootloader configuration (systemd-boot with Plymouth)
+# - Filesystem options (device, swap size)
+# - Build method options (ISO, iPXE, LXC, Proxmox)
+# - Garbage collection settings
+# - Convenience options (forUser, useHostPrefix)
+
+{ config, lib, ... }:
+
+{
+  options.athenix = {
+    forUser = lib.mkOption {
+      type = lib.types.nullOr lib.types.str;
+      default = null;
+      description = ''
+        Convenience option to configure a host for a specific user.
+        Automatically enables the user (sets athenix.users.username.enable = true).
+        Value should be a username from athenix.users.accounts.
+      '';
+    };
+
+    host = {
+      useHostPrefix = lib.mkOption {
+        type = lib.types.bool;
+        default = true;
+        description = "Whether to prepend the host prefix to the hostname (used in inventory).";
+      };
+      filesystem = {
+        device = lib.mkOption {
+          type = lib.types.str;
+          description = "The main disk device to use for installation.";
+        };
+        useSwap = lib.mkOption {
+          type = lib.types.bool;
+          default = true;
+          description = "Whether to create and use a swap partition.";
+        };
+        swapSize = lib.mkOption {
+          type = lib.types.str;
+          description = "The size of the swap partition.";
+        };
+      };
+      buildMethods = lib.mkOption {
+        type = lib.types.listOf lib.types.str;
+        default = [ "installer-iso" ];
+        description = ''
+          List of allowed build methods for this host.
+          Supported methods:
+          - "installer-iso": Generates an auto-install ISO that installs this configuration to disk.
+          - "iso": Generates a live ISO (using nixos-generators).
+          - "ipxe": Generates iPXE netboot artifacts (kernel, initrd, script).
+          - "lxc": Generates an LXC container tarball.
+          - "proxmox": Generates a Proxmox VMA archive.
+        '';
+      };
+    };
+
+    system.gc = {
+      enable = lib.mkOption {
+        type = lib.types.bool;
+        default = true;
+        description = "Whether to enable automatic garbage collection.";
+      };
+      frequency = lib.mkOption {
+        type = lib.types.str;
+        default = "weekly";
+        description = "How often to run garbage collection (systemd timer format).";
+      };
+      retentionDays = lib.mkOption {
+        type = lib.types.int;
+        default = 30;
+        description = "Number of days to keep old generations before deletion.";
+      };
+      optimise = lib.mkOption {
+        type = lib.types.bool;
+        default = true;
+        description = "Whether to automatically optimize the Nix store.";
+      };
+    };
+  };
+
+  config = lib.mkMerge [
+    # Enable forUser if specified
+    (lib.mkIf (config.athenix.forUser != null) {
+      athenix.users.${config.athenix.forUser}.enable = true;
+    })
+
+    # Main configuration
+    {
+      # ========== Disk Partitioning (Disko) ==========
+      disko.enableConfig = lib.mkDefault true;
+
+      disko.devices = {
+        disk.main = {
+          type = "disk";
+          device = config.athenix.host.filesystem.device;
+          content = {
+            type = "gpt";
+            partitions = {
+              # EFI System Partition
+              ESP = {
+                name = "ESP";
+                label = "BOOT";
+                size = "1G";
+                type = "EF00";
+                content = {
+                  type = "filesystem";
+                  format = "vfat";
+                  mountpoint = "/boot";
+                  mountOptions = [ "umask=0077" ];
+                  extraArgs = [
+                    "-n"
+                    "BOOT"
+                  ];
+                };
+              };
+
+              # Swap Partition (size configurable per host)
+              swap = lib.mkIf config.athenix.host.filesystem.useSwap {
+                name = "swap";
+                label = "swap";
+                size = config.athenix.host.filesystem.swapSize;
+                content = {
+                  type = "swap";
+                };
+              };
+
+              # Root Partition (takes remaining space)
+              root = {
+                name = "root";
+                label = "root";
+                size = "100%";
+                content = {
+                  type = "filesystem";
+                  format = "ext4";
+                  mountpoint = "/";
+                  extraArgs = [
+                    "-L"
+                    "ROOT"
+                  ];
+                };
+              };
+            };
+          };
+        };
+      };
+
+      # Bootloader Configuration
+      boot = {
+        loader.systemd-boot.enable = true;
+        loader.efi.canTouchEfiVariables = true;
+        plymouth.enable = true;
+
+        # Enable "Silent boot"
+        consoleLogLevel = 3;
+        initrd.verbose = false;
+
+        # Hide the OS choice for bootloaders.
+        # It's still possible to open the bootloader list by pressing any key
+        # It will just not appear on screen unless a key is pressed
+        loader.timeout = lib.mkDefault 0;
+      };
+
+      # Set your time zone.
+      time.timeZone = "America/New_York";
+
+      # Select internationalisation properties.
+      i18n.defaultLocale = "en_US.UTF-8";
+
+      i18n.extraLocaleSettings = {
+        LC_ADDRESS = "en_US.UTF-8";
+        LC_IDENTIFICATION = "en_US.UTF-8";
+        LC_MEASUREMENT = "en_US.UTF-8";
+        LC_MONETARY = "en_US.UTF-8";
+        LC_NAME = "en_US.UTF-8";
+        LC_NUMERIC = "en_US.UTF-8";
+        LC_PAPER = "en_US.UTF-8";
+        LC_TELEPHONE = "en_US.UTF-8";
+        LC_TIME = "en_US.UTF-8";
+      };
+
+      systemd.sleep.extraConfig = ''
+        SuspendState=freeze
+        HibernateDelaySec=2h
+      '';
+
+      system.stateVersion = "25.11"; # Did you read the comment?
+    }
+  ];
+}

hosts/common.nix

@@ -0,0 +1,47 @@
+# ============================================================================
+# Common Modules
+# ============================================================================
+# This module contains all the common configuration shared by all host types.
+# It includes:
+# - Boot and user configuration
+# - Software configurations
+# - User management (users.nix)
+# - Home Manager integration
+# - Secret management (agenix)
+# - Disk partitioning (disko)
+# - System-wide Nix settings (experimental features, garbage collection)
+
+{ inputs }:
+{
+  config,
+  lib,
+  ...
+}:
+{
+  imports = [
+    ./boot.nix
+    ./user-config.nix
+    ../sw
+    ../users.nix
+    inputs.home-manager.nixosModules.home-manager
+    inputs.agenix.nixosModules.default
+    inputs.disko.nixosModules.disko
+  ];
+
+  system.stateVersion = "25.11";
+
+  nix.settings.experimental-features = [
+    "nix-command"
+    "flakes"
+  ];
+
+  # Automatic Garbage Collection
+  nix.gc = lib.mkIf config.athenix.system.gc.enable {
+    automatic = true;
+    dates = config.athenix.system.gc.frequency;
+    options = "--delete-older-than ${toString config.athenix.system.gc.retentionDays}d";
+  };
+
+  # Optimize storage
+  nix.optimise.automatic = config.athenix.system.gc.optimise;
+}

hosts/default.nix

@@ -1,25 +1,36 @@
 {
   inputs,
-  lib,
+  hosts ? import ../inventory.nix,
-  config,
-  self ? null,
-  users ? { },
   ...
 }:
 
 # ============================================================================
-# Fleet Generator
+# Host Generator
 # ============================================================================
 # This file contains the logic to generate NixOS configurations for all hosts
 # defined in inventory.nix. It supports both hostname-based and count-based
 # configurations with flexible type associations.
+#
+# Inventory format:
+# {
+#   "my-hostname" = {
+#     type = "nix-desktop";  # Host type module to use
+#     system = "x86_64-linux";  # Optional
+#     # ... any athenix.* options or device-specific config
+#   };
+#
+#   "lab-prefix" = {
+#     type = "nix-laptop";
+#     count = 5;  # Generates lab-prefix1, lab-prefix2, ... lab-prefix5
+#     devices = {
+#       "machine-1" = { ... };  # Override for lab-prefix1
+#     };
+#   };
+# }
 
 let
-
+  nixpkgs = inputs.nixpkgs;
-  # Evaluate inventory to get fleet data
+  lib = nixpkgs.lib;
-  # Import fleet-option.nix (defines athenix.fleet) and inventory.nix (sets values)
-  # We use a minimal module here to avoid circular dependencies from common.nix's imports
-
   # Helper to create a single NixOS system configuration
   mkHost =
     {
@@ -27,42 +38,13 @@ let
       system ? "x86_64-linux",
       hostType,
       configOverrides ? { },
-      externalModuleThunk ? null,
+      externalModulePath ? null,
     }:
     let
-      # Lazy evaluation: only fetch external module when building this host
-      externalModulePath =
-        if externalModuleThunk != null then
-          let
-            # Force evaluation of the thunk
-            fetchedPath =
-              if
-                builtins.isAttrs externalModuleThunk
-                && externalModuleThunk ? _type
-                && externalModuleThunk._type == "lazy-fetchGit"
-              then
-                # New format: lazy fetchGit - only execute when needed
-                (builtins.fetchGit {
-                  inherit (externalModuleThunk) url rev submodules;
-                }).outPath
-              else
-                # Legacy: pre-fetched derivation or path
-                externalModuleThunk;
-            # Extract outPath from fetchGit/fetchTarball results
-            extractedPath =
-              if builtins.isAttrs fetchedPath && fetchedPath ? outPath then fetchedPath.outPath else fetchedPath;
-          in
-          if builtins.isPath extractedPath then
-            extractedPath + "/default.nix"
-          else if lib.isDerivation extractedPath then
-            extractedPath + "/default.nix"
-          else
-            extractedPath + "/default.nix"
-        else
-          null;
-
       # Load users.nix to find external user modules
-      accounts = config.athenix.users or { };
+      pkgs = nixpkgs.legacyPackages.${system};
+      usersData = import ../users.nix { inherit pkgs; };
+      accounts = usersData.athenix.users or { };
 
       # Build a map of user names to their nixos module paths (if they exist)
       # We'll use this to conditionally import modules based on user.enable
@@ -71,19 +53,10 @@ let
           name: user:
           if (user ? external && user.external != null) then
             let
-              # Resolve external path (lazy fetchGit if needed)
               externalPath =
-                if builtins.isAttrs user.external && user.external ? url && user.external ? rev then
+                if builtins.isAttrs user.external && user.external ? outPath then
-                  # New format: lazy fetchGit
-                  (builtins.fetchGit {
-                    inherit (user.external) url rev;
-                    submodules = user.external.submodules or false;
-                  }).outPath
-                else if builtins.isAttrs user.external && user.external ? outPath then
-                  # Legacy: pre-fetched
                   user.external.outPath
                 else
-                  # Direct path
                   user.external;
               nixosModulePath = externalPath + "/nixos.nix";
             in
@@ -121,6 +94,14 @@ let
         }
       ) userNixosModulePaths;
 
+      # Load the host type module
+      typeFile = ./types + "/${hostType}.nix";
+      typeModule =
+        if builtins.pathExists typeFile then
+          import typeFile { inherit inputs; }
+        else
+          throw "Host type '${hostType}' not found in hosts/types/";
+
       # External module from fetchGit/fetchurl
       externalPathModule =
         if externalModulePath != null then import externalModulePath { inherit inputs; } else { };
@@ -148,35 +129,19 @@ let
           ];
         };
 
-      # Hardware-specific external modules
-      hwSpecificModules =
-        lib.optional (hostType == "nix-lxc")
-          "${inputs.nixpkgs.legacyPackages.${system}.path}/nixos/modules/virtualisation/proxmox-lxc.nix";
-
       allModules =
         userNixosModules
         ++ [
-          ./common.nix
+          typeModule
           overrideModule
           { networking.hostName = hostName; }
-          # Set athenix.host.name for secrets and other modules to use
-          { athenix.host.name = hostName; }
-          {
-            # Inject user definitions from flake-parts level
-            config.athenix.users = lib.mapAttrs (_: user: lib.mapAttrs (_: lib.mkDefault) user) users;
-          }
-          # Enable the appropriate hardware module based on hostType
-          { config.athenix.hw.${hostType}.enable = lib.mkDefault true; }
         ]
-        ++ hwSpecificModules
         ++ lib.optional (externalModulePath != null) externalPathModule;
     in
     {
       system = lib.nixosSystem {
         inherit system;
-        specialArgs = {
+        specialArgs = { inherit inputs; };
-          inputs = if self != null then inputs // { inherit self; } else inputs;
-        };
         modules = allModules;
       };
       modules = allModules;
@@ -188,6 +153,8 @@ let
     let
       hostType = config.type or prefix;
       system = config.system or "x86_64-linux";
+      devices = config.devices or { };
+      hasCount = config ? count;
 
       # Helper to generate hostname from prefix and suffix
       # Numbers get no dash: "nix-surface1", "nix-surface2"
@@ -225,38 +192,48 @@ let
         lib.mapAttrsToList (
           deviceKey: deviceConfig:
           let
-            # Check if deviceConfig has an 'external' field for lazy evaluation
+            # Check if deviceConfig is a path/derivation (from fetchGit, fetchurl, etc.)
-            hasExternalField = builtins.isAttrs deviceConfig && deviceConfig ? external;
+            # fetchGit/fetchTarball return an attrset with outPath attribute
+            isExternalModule =
+              (builtins.isPath deviceConfig)
+              || (builtins.isString deviceConfig && lib.hasPrefix "/" deviceConfig)
+              || (lib.isDerivation deviceConfig)
+              || (builtins.isAttrs deviceConfig && deviceConfig ? outPath);
 
-            # Extract external module spec (don't evaluate fetchGit yet!)
+            # Extract the actual path from fetchGit/fetchTarball results
-            externalModuleThunk =
+            extractedPath =
-              if hasExternalField then
+              if builtins.isAttrs deviceConfig && deviceConfig ? outPath then
-                let
+                deviceConfig.outPath
-                  ext = deviceConfig.external;
-                in
-                # New format: { url, rev, submodules? } - create lazy fetchGit thunk
-                if builtins.isAttrs ext && ext ? url && ext ? rev then
-                  {
-                    _type = "lazy-fetchGit";
-                    inherit (ext) url rev;
-                    submodules = ext.submodules or false;
-                  }
-                # Legacy: pre-fetched or path
               else
-                  ext
+                deviceConfig;
+
+            # If external module, we use base config + overrides as the config
+            # and pass the module path separately
+            actualConfig =
+              if isExternalModule then (lib.recursiveUpdate baseConfig overrides) else deviceConfig;
+
+            # Merge: base config -> overrides -> device-specific config (only if not external module)
+            mergedConfig =
+              if isExternalModule then
+                actualConfig
               else
-                null;
+                lib.recursiveUpdate (lib.recursiveUpdate baseConfig overrides) deviceConfig;
-
-            # Remove 'external' from config to avoid conflicts
-            cleanDeviceConfig =
-              if hasExternalField then lib.removeAttrs deviceConfig [ "external" ] else deviceConfig;
-
-            # Merge: base config -> overrides -> device-specific config
-            mergedConfig = lib.recursiveUpdate (lib.recursiveUpdate baseConfig overrides) cleanDeviceConfig;
 
             # Check useHostPrefix from the merged config
             usePrefix = mergedConfig.athenix.host.useHostPrefix or true;
             hostName = mkHostName prefix deviceKey usePrefix;
+
+            # If external module, also add a default.nix path for import
+            externalModulePath =
+              if isExternalModule then
+                if builtins.isPath extractedPath then
+                  extractedPath + "/default.nix"
+                else if lib.isDerivation extractedPath then
+                  extractedPath + "/default.nix"
+                else
+                  extractedPath + "/default.nix"
+              else
+                null;
           in
           {
             name = hostName;
@@ -265,7 +242,7 @@ let
                 hostName
                 system
                 hostType
-                externalModuleThunk
+                externalModulePath
                 ;
               configOverrides = mergedConfig;
             };
@@ -312,12 +289,10 @@ let
           { };
     in
     lib.recursiveUpdate deviceHosts countHosts
-  );
+  ) hosts;
-
-  fleetData = config.athenix.fleet;
 
   # Flatten the nested structure
-  allHosts = lib.foldl' lib.recursiveUpdate { } (lib.attrValues (processInventory fleetData));
+  allHosts = lib.foldl' lib.recursiveUpdate { } (lib.attrValues processInventory);
 in
 {
   nixosConfigurations = lib.mapAttrs (n: v: v.system) allHosts;

hosts/types/nix-desktop.nix

@@ -0,0 +1,52 @@
+# ============================================================================
+# Desktop Configuration
+# ============================================================================
+# Hardware and boot configuration for standard desktop workstations.
+# Includes Intel CPU support and NVMe storage.
+
+{ inputs, ... }:
+{
+  config,
+  lib,
+  modulesPath,
+  ...
+}:
+{
+  imports = [
+    (import ../common.nix { inherit inputs; })
+    (modulesPath + "/installer/scan/not-detected.nix")
+  ];
+
+  # ========== Boot Configuration ==========
+
+  boot.initrd.availableKernelModules = [
+    "xhci_pci" # USB 3.0 support
+    "nvme" # NVMe SSD support
+    "usb_storage" # USB storage devices
+    "sd_mod" # SD card support
+    "sdhci_pci" # SD card host controller
+  ];
+  boot.initrd.kernelModules = [ ];
+  boot.kernelModules = [ "kvm-intel" ]; # Intel virtualization support
+  boot.extraModulePackages = [ ];
+  boot.kernelParams = [
+    "quiet" # Minimal boot messages
+    "splash" # Show Plymouth boot splash
+    "boot.shell_on_fail" # Emergency shell on boot failure
+    "udev.log_priority=3" # Reduce udev logging
+    "rd.systemd.show_status=auto" # Show systemd status during boot
+  ];
+
+  # ========== Filesystem Configuration ==========
+  athenix.host.filesystem.swapSize = lib.mkDefault "16G";
+  athenix.host.filesystem.device = lib.mkDefault "/dev/nvme0n1";
+  athenix.host.buildMethods = lib.mkDefault [ "installer-iso" ];
+  nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
+
+  # ========== Hardware Configuration ==========
+  hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
+
+  # ========== Software Profile ==========
+  athenix.sw.enable = lib.mkDefault true;
+  athenix.sw.type = lib.mkDefault "desktop";
+}

hosts/types/nix-ephemeral.nix

@@ -0,0 +1,68 @@
+# ============================================================================
+# Ephemeral/Diskless System Configuration
+# ============================================================================
+# Configuration for systems that run entirely from RAM without persistent storage.
+# Suitable for kiosks, netboot clients, and stateless workstations.
+# All data is lost on reboot.
+
+{ inputs, ... }:
+{
+  config,
+  lib,
+  modulesPath,
+  ...
+}:
+{
+  imports = [
+    (import ../common.nix { inherit inputs; })
+    (modulesPath + "/installer/scan/not-detected.nix")
+  ];
+
+  # ========== Boot Configuration ==========
+  boot.initrd.availableKernelModules = [
+    "xhci_pci" # USB 3.0 support
+    "nvme" # NVMe support
+    "usb_storage" # USB storage devices
+    "sd_mod" # SD card support
+    "sdhci_pci" # SD card host controller
+  ];
+  boot.initrd.kernelModules = [ ];
+  boot.kernelModules = [ "kvm-intel" ]; # Intel virtualization support
+  boot.extraModulePackages = [ ];
+  boot.kernelParams = [
+    "quiet" # Minimal boot messages
+    "splash" # Show Plymouth boot splash
+    "boot.shell_on_fail" # Emergency shell on boot failure
+    "udev.log_priority=3" # Reduce udev logging
+    "rd.systemd.show_status=auto" # Show systemd status during boot
+  ];
+
+  # ========== Ephemeral Configuration ==========
+  # No persistent storage - everything runs from RAM
+  athenix.host.filesystem.swapSize = lib.mkForce "0G";
+  athenix.host.filesystem.device = lib.mkForce "/dev/null"; # Dummy device
+  athenix.host.buildMethods = lib.mkDefault [
+    "iso" # Live ISO image
+    "ipxe" # Network boot
+  ];
+
+  # Disable disk management for RAM-only systems
+  disko.enableConfig = lib.mkForce false;
+
+  # Define tmpfs root filesystem
+  fileSystems."/" = {
+    device = "none";
+    fsType = "tmpfs";
+    options = [
+      "defaults"
+      "size=50%"
+      "mode=755"
+    ];
+  };
+
+  nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
+  hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
+
+  athenix.sw.enable = lib.mkDefault true;
+  athenix.sw.type = lib.mkDefault "stateless-kiosk";
+}

hosts/types/nix-laptop.nix

@@ -0,0 +1,65 @@
+# ============================================================================
+# Laptop Configuration
+# ============================================================================
+# Hardware and boot configuration for laptop systems with mobile features.
+# Includes power management, lid switch handling, and Intel graphics fixes.
+
+{ inputs, ... }:
+{
+  config,
+  lib,
+  modulesPath,
+  ...
+}:
+{
+  imports = [
+    (import ../common.nix { inherit inputs; })
+    (modulesPath + "/installer/scan/not-detected.nix")
+  ];
+
+  # ========== Boot Configuration ==========
+
+  boot.initrd.availableKernelModules = [
+    "xhci_pci" # USB 3.0 support
+    "thunderbolt" # Thunderbolt support
+    "nvme" # NVMe SSD support
+    "usb_storage" # USB storage devices
+    "sd_mod" # SD card support
+    "sdhci_pci" # SD card host controller
+  ];
+  boot.initrd.kernelModules = [ ];
+  boot.kernelModules = [ "kvm-intel" ]; # Intel virtualization support
+  boot.extraModulePackages = [ ];
+  boot.kernelParams = [
+    "quiet" # Minimal boot messages
+    "splash" # Show Plymouth boot splash
+    "boot.shell_on_fail" # Emergency shell on boot failure
+    "udev.log_priority=3" # Reduce udev logging
+    "rd.systemd.show_status=auto" # Show systemd status during boot
+    "i915.enable_psr=0" # Disable Panel Self Refresh (stability)
+    "i915.enable_dc=0" # Disable display power saving
+    "i915.enable_fbc=0" # Disable framebuffer compression
+  ];
+
+  # ========== Hardware Configuration ==========
+  nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
+  hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
+
+  # ========== Filesystem Configuration ==========
+  athenix.host.filesystem.device = lib.mkDefault "/dev/nvme0n1";
+  athenix.host.filesystem.swapSize = lib.mkDefault "34G"; # Larger swap for hibernation
+  athenix.host.buildMethods = lib.mkDefault [ "installer-iso" ];
+
+  # ========== Power Management ==========
+  services.upower.enable = lib.mkDefault true;
+  services.logind.settings = {
+    Login = {
+      HandleLidSwitch = "suspend";
+      HandleLidSwitchExternalPower = "suspend";
+      HandleLidSwitchDocked = "ignore";
+    };
+  };
+
+  athenix.sw.enable = lib.mkDefault true;
+  athenix.sw.type = lib.mkDefault "desktop";
+}

hosts/types/nix-lxc.nix

@@ -0,0 +1,62 @@
+# ============================================================================
+# Proxmox LXC Container Configuration
+# ============================================================================
+# Configuration for lightweight Linux containers running in Proxmox.
+# Disables boot/disk management and enables remote development support.
+
+{ inputs, ... }:
+{
+  config,
+  lib,
+  modulesPath,
+  ...
+}:
+{
+  imports = [
+    (import ../common.nix { inherit inputs; })
+    inputs.vscode-server.nixosModules.default
+    "${modulesPath}/virtualisation/proxmox-lxc.nix"
+  ];
+
+  # ========== Nix Configuration ==========
+  nix.settings.trusted-users = [
+    "root"
+    "engr-ugaif"
+  ];
+  nix.settings.experimental-features = [
+    "nix-command"
+    "flakes"
+  ];
+
+  # ========== Container-Specific Configuration ==========
+  boot.isContainer = true;
+  boot.loader.systemd-boot.enable = lib.mkForce false; # No bootloader in container
+  disko.enableConfig = lib.mkForce false; # No disk management in container
+  console.enable = true;
+
+  # Allow getty to work in containers
+  systemd.services."getty@".unitConfig.ConditionPathExists = [
+    ""
+    "/dev/%I"
+  ];
+
+  # Suppress unnecessary systemd units for containers
+  systemd.suppressedSystemUnits = [
+    "dev-mqueue.mount"
+    "sys-kernel-debug.mount"
+    "sys-fs-fuse-connections.mount"
+  ];
+
+  # ========== Remote Development ==========
+  services.vscode-server.enable = true;
+
+  # ========== System Configuration ==========
+  system.stateVersion = "25.11";
+  athenix.host.buildMethods = lib.mkDefault [
+    "lxc" # LXC container tarball
+    "proxmox" # Proxmox VMA archive
+  ];
+
+  athenix.sw.enable = lib.mkDefault true;
+  athenix.sw.type = lib.mkDefault "headless";
+}

hosts/types/nix-surface.nix

@@ -0,0 +1,70 @@
+# ============================================================================
+# Microsoft Surface Tablet Configuration
+# ============================================================================
+# Hardware configuration for Surface Go tablets in kiosk mode.
+# Uses nixos-hardware module and older kernel for Surface-specific drivers.
+
+{ inputs, ... }:
+{
+  config,
+  lib,
+  pkgs,
+  modulesPath,
+  ...
+}:
+let
+  # Use older kernel version for better Surface Go compatibility
+  refSystem = inputs.nixpkgs-old-kernel.lib.nixosSystem {
+    system = pkgs.stdenv.hostPlatform.system;
+    modules = [ inputs.nixos-hardware.nixosModules.microsoft-surface-go ];
+  };
+  refKernelPackages = refSystem.config.boot.kernelPackages;
+in
+{
+  imports = [
+    (import ../common.nix { inherit inputs; })
+    (modulesPath + "/installer/scan/not-detected.nix")
+    inputs.nixos-hardware.nixosModules.microsoft-surface-go
+  ];
+
+  # ========== Boot Configuration ==========
+
+  boot.initrd.availableKernelModules = [
+    "xhci_pci" # USB 3.0 support
+    "nvme" # NVMe support (though Surface uses eMMC)
+    "usb_storage" # USB storage devices
+    "sd_mod" # SD card support
+    "sdhci_pci" # SD card host controller
+  ];
+  boot.initrd.kernelModules = [ ];
+  boot.kernelModules = [ "kvm-intel" ]; # Intel virtualization support
+  boot.extraModulePackages = [ ];
+  boot.kernelParams = [
+    "quiet" # Minimal boot messages
+    "splash" # Show Plymouth boot splash
+    "boot.shell_on_fail" # Emergency shell on boot failure
+    "udev.log_priority=3" # Reduce udev logging
+    "rd.systemd.show_status=auto" # Show systemd status during boot
+    "intel_ipu3_imgu" # Intel camera image processing
+    "intel_ipu3_isys" # Intel camera sensor interface
+    "fbcon=map:1" # Framebuffer console mapping
+    "i915.enable_psr=0" # Disable Panel Self Refresh (breaks resume)
+    "i915.enable_dc=0" # Disable display power saving
+  ];
+
+  # Use older kernel for better Surface hardware support
+  boot.kernelPackages = lib.mkForce refKernelPackages;
+
+  # ========== Filesystem Configuration ==========
+  athenix.host.filesystem.swapSize = lib.mkDefault "8G";
+  athenix.host.filesystem.device = lib.mkDefault "/dev/mmcblk0"; # eMMC storage # eMMC storage
+  athenix.host.buildMethods = lib.mkDefault [ "installer-iso" ];
+  nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
+
+  # ========== Hardware Configuration ==========
+  hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
+
+  # ========== Software Profile ==========
+  athenix.sw.enable = lib.mkDefault true;
+  athenix.sw.type = lib.mkDefault "tablet-kiosk"; # Touch-optimized kiosk mode
+}

hosts/types/nix-wsl.nix

@@ -4,46 +4,27 @@
 # Configuration for NixOS running in WSL2 on Windows.
 # Integrates with nixos-wsl for WSL-specific functionality.
 
+{ inputs, ... }:
 {
   lib,
   config,
   ...
 }:
-
-with lib;
-
-let
-  cfg = config.athenix.hw.nix-wsl;
-in
 {
-  options.athenix.hw.nix-wsl = mkOption {
+  imports = [
-    type = types.submodule {
+    (import ../common.nix { inherit inputs; })
-      options = {
+    inputs.nixos-wsl.nixosModules.default
-        enable = mkOption {
+    inputs.vscode-server.nixosModules.default
-          type = types.bool;
+  ];
-          default = false;
-          description = "Enable Windows Subsystem for Linux hardware configuration.";
-        };
-      };
-    };
-    default = { };
-    description = "WSL hardware type configuration.";
-  };
 
-  # WSL user option (at module level, not inside config)
+  # ========== Options ==========
   options.athenix.host.wsl.user = lib.mkOption {
     type = lib.types.str;
     default = "engr-ugaif";
-    description = ''
+    description = "The default user to log in as in WSL.";
-      The default user to automatically log in as when starting WSL.
-
-      This user must be enabled via athenix.users.<username>.enable = true.
-      Tip: Use athenix.forUser = "username" as a shortcut to set both.
-    '';
-    example = "alice";
   };
 
-  config = mkIf cfg.enable {
+  config = {
     # ========== WSL Configuration ==========
     wsl.enable = true;
     # Use forUser if set, otherwise fall back to wsl.user option
@@ -52,7 +33,7 @@ in
 
     # ========== Software Profile ==========
     athenix.sw.enable = lib.mkDefault true;
-    athenix.sw.headless.enable = lib.mkDefault true;
+    athenix.sw.type = lib.mkDefault "headless";
 
     # ========== Remote Development ==========
     services.vscode-server.enable = true;
@@ -69,8 +50,5 @@ in
     # Provide dummy values for required options from boot.nix
     athenix.host.filesystem.device = "/dev/null";
     athenix.host.filesystem.swapSize = "0G";
-
-    # WSL doesn't use installer ISOs
-    athenix.host.buildMethods = lib.mkDefault [ ];
   };
 }

hosts/types/nix-zima.nix

@@ -0,0 +1,51 @@
+# ============================================================================
+# Desktop Configuration
+# ============================================================================
+# Hardware and boot configuration for standard desktop workstations.
+# Includes Intel CPU support and NVMe storage.
+
+{ inputs, ... }:
+{
+  config,
+  lib,
+  modulesPath,
+  ...
+}:
+{
+  imports = [
+    (import ../common.nix { inherit inputs; })
+    (modulesPath + "/installer/scan/not-detected.nix")
+  ];
+
+  # ========== Boot Configuration ==========
+
+  boot.initrd.availableKernelModules = [
+    "xhci_pci" # USB 3.0 support
+    "usb_storage" # USB storage devices
+    "sd_mod" # SD card support
+    "sdhci_pci" # SD card host controller
+  ];
+  boot.initrd.kernelModules = [ ];
+  boot.kernelModules = [ "kvm-intel" ]; # Intel virtualization support
+  boot.extraModulePackages = [ ];
+  boot.kernelParams = [
+    "quiet" # Minimal boot messages
+    "splash" # Show Plymouth boot splash
+    "boot.shell_on_fail" # Emergency shell on boot failure
+    "udev.log_priority=3" # Reduce udev logging
+    "rd.systemd.show_status=auto" # Show systemd status during boot
+  ];
+
+  # ========== Filesystem Configuration ==========
+  athenix.host.filesystem.useSwap = lib.mkDefault false;
+  athenix.host.filesystem.device = lib.mkDefault "/dev/mmcblk0";
+  athenix.host.buildMethods = lib.mkDefault [ "installer-iso" ];
+  nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
+
+  # ========== Hardware Configuration ==========
+  hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
+
+  # ========== Software Profile ==========
+  athenix.sw.enable = lib.mkDefault true;
+  athenix.sw.type = lib.mkDefault "desktop";
+}

hosts/user-config.nix

@@ -0,0 +1,276 @@
+{
+  pkgs,
+  config,
+  lib,
+  inputs,
+  ...
+}:
+
+# ============================================================================
+# User Configuration Module
+# ============================================================================
+# This module defines the schema for user accounts and handles their creation.
+# It bridges the gap between the data in 'users.nix' and the actual NixOS
+# and Home Manager configuration.
+
+let
+  # Load users.nix to get account definitions
+  usersData = import ../users.nix { inherit pkgs; };
+  accounts = usersData.athenix.users or { };
+
+  # Helper: Resolve external module path from fetchGit/fetchTarball/path
+  resolveExternalPath =
+    external:
+    if external == null then
+      null
+    else if builtins.isAttrs external && external ? outPath then
+      external.outPath
+    else
+      external;
+
+  # Helper: Check if path exists and is valid
+  isValidPath =
+    path:
+    path != null
+    && (builtins.isPath path || (builtins.isString path && lib.hasPrefix "/" path))
+    && builtins.pathExists path;
+
+  # Extract athenix.users options from external user.nix modules
+  # First, build a cache of options per user from their external user.nix (if any).
+  externalUserModuleOptions = lib.genAttrs (lib.attrNames accounts) (
+    name:
+    let
+      user = accounts.${name};
+      externalPath = resolveExternalPath (user.external or null);
+      userNixPath = if externalPath != null then externalPath + "/user.nix" else null;
+    in
+    if isValidPath userNixPath then
+      let
+        # Import and evaluate the module with minimal args
+        outerModule = import userNixPath { inherit inputs; };
+        evaluatedModule = outerModule {
+          config = { };
+          inherit lib pkgs;
+          osConfig = null;
+        };
+        # Extract just the athenix.users.<name> options
+        athenixUsers = evaluatedModule.athenix.users or { };
+      in
+      athenixUsers.${name} or { }
+    else
+      { }
+  );
+
+  # externalUserOptions only contains users that actually have options defined
+  externalUserOptions = lib.filterAttrs (
+    _: moduleOptions: moduleOptions != { }
+  ) externalUserModuleOptions;
+
+  # Submodule defining the structure of a user account
+  userSubmodule = lib.types.submodule {
+    options = {
+      isNormalUser = lib.mkOption {
+        type = lib.types.bool;
+        default = true;
+      };
+      description = lib.mkOption {
+        type = lib.types.nullOr lib.types.str;
+        default = null;
+      };
+      extraGroups = lib.mkOption {
+        type = lib.types.listOf lib.types.str;
+        default = [ ];
+      };
+      hashedPassword = lib.mkOption {
+        type = lib.types.str;
+        default = "!";
+      };
+      extraPackages = lib.mkOption {
+        type = lib.types.listOf lib.types.package;
+        default = [ ];
+      };
+      excludePackages = lib.mkOption {
+        type = lib.types.listOf lib.types.package;
+        default = [ ];
+      };
+      homePackages = lib.mkOption {
+        type = lib.types.listOf lib.types.package;
+        default = [ ];
+      };
+      extraImports = lib.mkOption {
+        type = lib.types.listOf lib.types.path;
+        default = [ ];
+      };
+      external = lib.mkOption {
+        type = lib.types.nullOr (
+          lib.types.oneOf [
+            lib.types.path
+            lib.types.package
+            lib.types.attrs
+          ]
+        );
+        default = null;
+        description = ''
+          External user configuration module. Can be:
+          - A path to a local module directory
+          - A fetchGit/fetchTarball result pointing to a repository
+
+          The external module can contain:
+          - user.nix (optional): Sets athenix.users.<name> options AND home-manager config
+          - nixos.nix (optional): System-level NixOS configuration
+
+          Example: builtins.fetchGit { url = "https://github.com/user/dotfiles"; rev = "..."; }
+        '';
+      };
+      opensshKeys = lib.mkOption {
+        type = lib.types.listOf lib.types.str;
+        default = [ ];
+        description = "List of SSH public keys for the user.";
+      };
+      shell = lib.mkOption {
+        type = lib.types.nullOr lib.types.package;
+        default = null;
+        description = "The shell for this user.";
+      };
+      editor = lib.mkOption {
+        type = lib.types.nullOr lib.types.package;
+        default = null;
+        description = "The default editor for this user.";
+      };
+      useZshTheme = lib.mkOption {
+        type = lib.types.bool;
+        default = true;
+        description = "Whether to apply the system Zsh theme.";
+      };
+      useNvimPlugins = lib.mkOption {
+        type = lib.types.bool;
+        default = true;
+        description = "Whether to apply the system Neovim configuration.";
+      };
+      enable = lib.mkOption {
+        type = lib.types.bool;
+        default = false;
+        description = "Whether this user account is enabled on this system.";
+      };
+    };
+  };
+in
+{
+
+  options.athenix.users = lib.mkOption {
+    type = lib.types.attrsOf userSubmodule;
+    default = { };
+    description = "User accounts configuration. Set enable=true for users that should exist on this system.";
+  };
+
+  config = {
+    # Merge user definitions from users.nix with options from external user.nix modules
+    # External options take precedence over users.nix (which uses lib.mkDefault)
+    athenix.users = lib.mapAttrs (
+      name: user:
+      user
+      // {
+        description = lib.mkDefault (user.description or null);
+        shell = lib.mkDefault (user.shell or null);
+        extraGroups = lib.mkDefault (user.extraGroups or [ ]);
+      }
+      // (externalUserOptions.${name} or { })
+    ) accounts;
+
+    # Generate NixOS users
+    users.users =
+      let
+        enabledAccounts = lib.filterAttrs (_: user: user.enable) config.athenix.users;
+      in
+      lib.mapAttrs (
+        name: user:
+        let
+          isPlasma6 = config.services.desktopManager.plasma6.enable;
+          defaultPackages = lib.optionals (isPlasma6 && name != "root") [ pkgs.kdePackages.kate ];
+          finalPackages = lib.subtractLists user.excludePackages (defaultPackages ++ user.extraPackages);
+        in
+        {
+          inherit (user) isNormalUser extraGroups hashedPassword;
+          description = if user.description != null then user.description else lib.mkDefault "";
+          openssh.authorizedKeys.keys = user.opensshKeys;
+          packages = finalPackages;
+          shell = if user.shell != null then user.shell else pkgs.bash;
+        }
+      ) enabledAccounts;
+
+    # Home Manager configs per user
+    home-manager = {
+      useGlobalPkgs = true;
+      useUserPackages = true;
+      extraSpecialArgs = {
+        osConfig = config;
+        inherit inputs;
+      };
+
+      users =
+        let
+          enabledAccounts = lib.filterAttrs (_: user: user.enable) config.athenix.users;
+        in
+        lib.mapAttrs (
+          name: user:
+          let
+            # Resolve external module paths
+            hasExternal = user.external != null;
+            externalPath = resolveExternalPath user.external;
+            userNixPath = if externalPath != null then externalPath + "/user.nix" else null;
+            hasExternalUser = isValidPath userNixPath;
+
+            # Import external user.nix for home-manager (filter out athenix.* options)
+            externalUserModule =
+              if hasExternalUser then
+                let
+                  fullModule = import userNixPath { inherit inputs; };
+                in
+                # Only pass through non-athenix options to home-manager
+                {
+                  config,
+                  lib,
+                  pkgs,
+                  osConfig,
+                  ...
+                }:
+                let
+                  evaluated = fullModule {
+                    inherit
+                      config
+                      lib
+                      pkgs
+                      osConfig
+                      ;
+                  };
+                in
+                lib.filterAttrs (attrName: _: attrName != "athenix") evaluated
+              else
+                { };
+
+            # Common imports based on user flags
+            commonImports = lib.optional user.useZshTheme ../sw/theme.nix ++ [
+              (import ../sw/nvim.nix { inherit user; })
+            ];
+
+            # Build imports list
+            allImports = user.extraImports ++ commonImports ++ lib.optional hasExternalUser externalUserModule;
+          in
+          lib.mkMerge [
+            {
+              imports = allImports;
+
+              # Always set these required options
+              home.username = name;
+              home.homeDirectory = if name == "root" then "/root" else "/home/${name}";
+              home.stateVersion = "25.11";
+            }
+            (lib.mkIf (!hasExternal) {
+              # For local users only, add their packages
+              home.packages = user.homePackages;
+            })
+          ]
+        ) enabledAccounts;
+    };
+  };
+}

hw/default.nix

@@ -1,23 +0,0 @@
-# ============================================================================
-# Host Types Module
-# ============================================================================
-# This module exports all available host types as an attribute set.
-# Each type is a NixOS module (a function suitable for lib.types.submodule).
-
-{ inputs }:
-let
-  lib = inputs.nixpkgs.lib;
-  inherit (builtins) readDir attrNames;
-  inherit (lib) filterAttrs removeSuffix genAttrs;
-
-  files = readDir ./.;
-
-  # Keep only regular *.nix files except default.nix
-  nixFiles = filterAttrs (
-    name: type: type == "regular" && lib.hasSuffix ".nix" name && name != "default.nix"
-  ) files;
-
-  moduleNames = map (name: removeSuffix ".nix" name) (attrNames nixFiles);
-in
-# Export: { name = <module function from ./name.nix>; }
-genAttrs moduleNames (name: import (./. + ("/" + name + ".nix")))

hw/nix-desktop.nix

@@ -1,73 +0,0 @@
-# ============================================================================
-# Desktop Configuration
-# ============================================================================
-# Hardware and boot configuration for standard desktop workstations.
-# Includes Intel CPU support and NVMe storage.
-
-{
-  config,
-  lib,
-  modulesPath,
-  ...
-}:
-
-with lib;
-
-let
-  cfg = config.athenix.hw.nix-desktop;
-in
-{
-  imports = [
-    (modulesPath + "/installer/scan/not-detected.nix")
-  ];
-
-  options.athenix.hw.nix-desktop = mkOption {
-    type = types.submodule {
-      options = {
-        enable = mkOption {
-          type = types.bool;
-          default = false;
-          description = "Enable desktop workstation hardware configuration.";
-        };
-      };
-    };
-    default = { };
-    description = "Desktop workstation hardware type configuration.";
-  };
-
-  config = mkIf cfg.enable {
-
-    # ========== Boot Configuration ==========
-
-    boot.initrd.availableKernelModules = [
-      "xhci_pci" # USB 3.0 support
-      "nvme" # NVMe SSD support
-      "usb_storage" # USB storage devices
-      "sd_mod" # SD card support
-      "sdhci_pci" # SD card host controller
-    ];
-    boot.initrd.kernelModules = [ ];
-    boot.kernelModules = [ "kvm-intel" ]; # Intel virtualization support
-    boot.extraModulePackages = [ ];
-    boot.kernelParams = [
-      "quiet" # Minimal boot messages
-      "splash" # Show Plymouth boot splash
-      "boot.shell_on_fail" # Emergency shell on boot failure
-      "udev.log_priority=3" # Reduce udev logging
-      "rd.systemd.show_status=auto" # Show systemd status during boot
-    ];
-
-    # ========== Filesystem Configuration ==========
-    athenix.host.filesystem.swapSize = lib.mkDefault "16G";
-    athenix.host.filesystem.device = lib.mkDefault "/dev/nvme0n1";
-    athenix.host.buildMethods = lib.mkDefault [ "installer-iso" ];
-    nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
-
-    # ========== Hardware Configuration ==========
-    hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
-
-    # ========== Software Profile ==========
-    athenix.sw.enable = lib.mkDefault true;
-    athenix.sw.desktop.enable = lib.mkDefault true;
-  };
-}

hw/nix-ephemeral.nix

@@ -1,88 +0,0 @@
-# ============================================================================
-# Ephemeral/Diskless System Configuration
-# ============================================================================
-# Configuration for systems that run entirely from RAM without persistent storage.
-# Suitable for kiosks, netboot clients, and stateless workstations.
-# All data is lost on reboot.
-
-{
-  config,
-  lib,
-  modulesPath,
-  ...
-}:
-
-with lib;
-
-let
-  cfg = config.athenix.hw.nix-ephemeral;
-in
-{
-  imports = [
-    (modulesPath + "/installer/scan/not-detected.nix")
-  ];
-
-  options.athenix.hw.nix-ephemeral = mkOption {
-    type = types.submodule {
-      options = {
-        enable = mkOption {
-          type = types.bool;
-          default = false;
-          description = "Enable ephemeral/diskless system hardware configuration.";
-        };
-      };
-    };
-    default = { };
-    description = "Ephemeral hardware type configuration.";
-  };
-
-  config = mkIf cfg.enable {
-    # ========== Boot Configuration ==========
-    boot.initrd.availableKernelModules = [
-      "xhci_pci" # USB 3.0 support
-      "nvme" # NVMe support
-      "usb_storage" # USB storage devices
-      "sd_mod" # SD card support
-      "sdhci_pci" # SD card host controller
-    ];
-    boot.initrd.kernelModules = [ ];
-    boot.kernelModules = [ "kvm-intel" ]; # Intel virtualization support
-    boot.extraModulePackages = [ ];
-    boot.kernelParams = [
-      "quiet" # Minimal boot messages
-      "splash" # Show Plymouth boot splash
-      "boot.shell_on_fail" # Emergency shell on boot failure
-      "udev.log_priority=3" # Reduce udev logging
-      "rd.systemd.show_status=auto" # Show systemd status during boot
-    ];
-
-    # ========== Ephemeral Configuration ==========
-    # No persistent storage - everything runs from RAM
-    athenix.host.filesystem.swapSize = lib.mkForce "0G";
-    athenix.host.filesystem.device = lib.mkForce "/dev/null"; # Dummy device
-    athenix.host.buildMethods = lib.mkDefault [
-      "iso" # Live ISO image
-      "ipxe" # Network boot
-    ];
-
-    # Disable disk management for RAM-only systems
-    disko.enableConfig = lib.mkForce false;
-
-    # Define tmpfs root filesystem
-    fileSystems."/" = {
-      device = "none";
-      fsType = "tmpfs";
-      options = [
-        "defaults"
-        "size=50%"
-        "mode=755"
-      ];
-    };
-
-    nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
-    hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
-
-    athenix.sw.enable = lib.mkDefault true;
-    athenix.sw.stateless-kiosk.enable = lib.mkDefault true;
-  };
-}

hw/nix-laptop.nix

@@ -1,85 +0,0 @@
-# ============================================================================
-# Laptop Configuration
-# ============================================================================
-# Hardware and boot configuration for laptop systems with mobile features.
-# Includes power management, lid switch handling, and Intel graphics fixes.
-
-{
-  config,
-  lib,
-  modulesPath,
-  ...
-}:
-
-with lib;
-
-let
-  cfg = config.athenix.hw.nix-laptop;
-in
-{
-  imports = [
-    (modulesPath + "/installer/scan/not-detected.nix")
-  ];
-
-  options.athenix.hw.nix-laptop = mkOption {
-    type = types.submodule {
-      options = {
-        enable = mkOption {
-          type = types.bool;
-          default = false;
-          description = "Enable laptop hardware configuration with power management.";
-        };
-      };
-    };
-    default = { };
-    description = "Laptop hardware type configuration.";
-  };
-
-  config = mkIf cfg.enable {
-    # ========== Boot Configuration ==========
-
-    boot.initrd.availableKernelModules = [
-      "xhci_pci" # USB 3.0 support
-      "thunderbolt" # Thunderbolt support
-      "nvme" # NVMe SSD support
-      "usb_storage" # USB storage devices
-      "sd_mod" # SD card support
-      "sdhci_pci" # SD card host controller
-    ];
-    boot.initrd.kernelModules = [ ];
-    boot.kernelModules = [ "kvm-intel" ]; # Intel virtualization support
-    boot.extraModulePackages = [ ];
-    boot.kernelParams = [
-      "quiet" # Minimal boot messages
-      "splash" # Show Plymouth boot splash
-      "boot.shell_on_fail" # Emergency shell on boot failure
-      "udev.log_priority=3" # Reduce udev logging
-      "rd.systemd.show_status=auto" # Show systemd status during boot
-      "i915.enable_psr=0" # Disable Panel Self Refresh (stability)
-      "i915.enable_dc=0" # Disable display power saving
-      "i915.enable_fbc=0" # Disable framebuffer compression
-    ];
-
-    # ========== Hardware Configuration ==========
-    nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
-    hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
-
-    # ========== Filesystem Configuration ==========
-    athenix.host.filesystem.device = lib.mkDefault "/dev/nvme0n1";
-    athenix.host.filesystem.swapSize = lib.mkDefault "34G"; # Larger swap for hibernation
-    athenix.host.buildMethods = lib.mkDefault [ "installer-iso" ];
-
-    # ========== Power Management ==========
-    services.upower.enable = lib.mkDefault true;
-    services.logind.settings = {
-      Login = {
-        HandleLidSwitch = "suspend";
-        HandleLidSwitchExternalPower = "suspend";
-        HandleLidSwitchDocked = "ignore";
-      };
-    };
-
-    athenix.sw.enable = lib.mkDefault true;
-    athenix.sw.desktop.enable = lib.mkDefault true;
-  };
-}

hw/nix-lxc.nix

@@ -1,79 +0,0 @@
-# ============================================================================
-# Proxmox LXC Container Configuration
-# ============================================================================
-# Configuration for lightweight Linux containers running in Proxmox.
-# Disables boot/disk management and enables remote development support.
-
-{
-  config,
-  lib,
-  ...
-}:
-
-with lib;
-
-let
-  cfg = config.athenix.hw.nix-lxc;
-in
-{
-  options.athenix.hw.nix-lxc = mkOption {
-    type = types.submodule {
-      options = {
-        enable = mkOption {
-          type = types.bool;
-          default = false;
-          description = "Enable Proxmox LXC container hardware configuration.";
-        };
-      };
-    };
-    default = { };
-    description = "Proxmox LXC hardware type configuration.";
-  };
-
-  config = mkIf cfg.enable {
-    # ========== Nix Configuration ==========
-    nix.settings.trusted-users = [
-      "root"
-      "engr-ugaif"
-    ];
-    nix.settings.experimental-features = [
-      "nix-command"
-      "flakes"
-    ];
-
-    # ========== Container-Specific Configuration ==========
-    boot.isContainer = true;
-    boot.loader.systemd-boot.enable = lib.mkForce false; # No bootloader in container
-    disko.enableConfig = lib.mkForce false; # No disk management in container
-    console.enable = true;
-
-    # Set timezone to fix /etc/localtime for Docker containers
-    time.timeZone = lib.mkDefault "America/New_York";
-
-    # Allow getty to work in containers
-    systemd.services."getty@".unitConfig.ConditionPathExists = [
-      ""
-      "/dev/%I"
-    ];
-
-    # Suppress unnecessary systemd units for containers
-    systemd.suppressedSystemUnits = [
-      "dev-mqueue.mount"
-      "sys-kernel-debug.mount"
-      "sys-fs-fuse-connections.mount"
-    ];
-
-    # ========== Remote Development ==========
-    services.vscode-server.enable = true;
-
-    # ========== System Configuration ==========
-    system.stateVersion = "25.11";
-    athenix.host.buildMethods = lib.mkDefault [
-      "lxc" # LXC container tarball
-      "proxmox" # Proxmox VMA archive
-    ];
-
-    athenix.sw.enable = lib.mkDefault true;
-    athenix.sw.headless.enable = lib.mkDefault true;
-  };
-}

hw/nix-surface.nix

@@ -1,89 +0,0 @@
-# ============================================================================
-# Microsoft Surface Tablet Configuration
-# ============================================================================
-# Hardware configuration for Surface Go tablets in kiosk mode.
-# Uses nixos-hardware module and older kernel for Surface-specific drivers.
-
-{
-  config,
-  lib,
-  pkgs,
-  modulesPath,
-  inputs,
-  ...
-}:
-
-with lib;
-
-let
-  cfg = config.athenix.hw.nix-surface;
-  # Use older kernel version for better Surface Go compatibility
-  refSystem = inputs.nixpkgs-old-kernel.lib.nixosSystem {
-    system = pkgs.stdenv.hostPlatform.system;
-    modules = [ inputs.nixos-hardware.nixosModules.microsoft-surface-go ];
-  };
-  refKernelPackages = refSystem.config.boot.kernelPackages;
-in
-{
-  imports = [
-    (modulesPath + "/installer/scan/not-detected.nix")
-    inputs.nixos-hardware.nixosModules.microsoft-surface-go
-  ];
-
-  options.athenix.hw.nix-surface = mkOption {
-    type = types.submodule {
-      options = {
-        enable = mkOption {
-          type = types.bool;
-          default = false;
-          description = "Enable Microsoft Surface tablet hardware configuration.";
-        };
-      };
-    };
-    default = { };
-    description = "Microsoft Surface hardware type configuration.";
-  };
-
-  config = mkIf cfg.enable {
-    # ========== Boot Configuration ==========
-
-    boot.initrd.availableKernelModules = [
-      "xhci_pci" # USB 3.0 support
-      "nvme" # NVMe support (though Surface uses eMMC)
-      "usb_storage" # USB storage devices
-      "sd_mod" # SD card support
-      "sdhci_pci" # SD card host controller
-    ];
-    boot.initrd.kernelModules = [ ];
-    boot.kernelModules = [ "kvm-intel" ]; # Intel virtualization support
-    boot.extraModulePackages = [ ];
-    boot.kernelParams = [
-      "quiet" # Minimal boot messages
-      "splash" # Show Plymouth boot splash
-      "boot.shell_on_fail" # Emergency shell on boot failure
-      "udev.log_priority=3" # Reduce udev logging
-      "rd.systemd.show_status=auto" # Show systemd status during boot
-      "intel_ipu3_imgu" # Intel camera image processing
-      "intel_ipu3_isys" # Intel camera sensor interface
-      "fbcon=map:1" # Framebuffer console mapping
-      "i915.enable_psr=0" # Disable Panel Self Refresh (breaks resume)
-      "i915.enable_dc=0" # Disable display power saving
-    ];
-
-    # Use older kernel for better Surface hardware support
-    boot.kernelPackages = lib.mkForce refKernelPackages;
-
-    # ========== Filesystem Configuration ==========
-    athenix.host.filesystem.swapSize = lib.mkDefault "8G";
-    athenix.host.filesystem.device = lib.mkDefault "/dev/mmcblk0"; # eMMC storage # eMMC storage
-    athenix.host.buildMethods = lib.mkDefault [ "installer-iso" ];
-    nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
-
-    # ========== Hardware Configuration ==========
-    hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
-
-    # ========== Software Profile ==========
-    athenix.sw.enable = lib.mkDefault true;
-    athenix.sw.tablet-kiosk.enable = lib.mkDefault true; # Touch-optimized kiosk mode
-  };
-}

hw/nix-zima.nix

@@ -1,71 +0,0 @@
-# ============================================================================
-# Desktop Configuration
-# ============================================================================
-# Hardware and boot configuration for standard desktop workstations.
-# Includes Intel CPU support and NVMe storage.
-
-{
-  config,
-  lib,
-  modulesPath,
-  ...
-}:
-
-with lib;
-
-let
-  cfg = config.athenix.hw.nix-zima;
-in
-{
-  imports = [
-    (modulesPath + "/installer/scan/not-detected.nix")
-  ];
-
-  options.athenix.hw.nix-zima = mkOption {
-    type = types.submodule {
-      options = {
-        enable = mkOption {
-          type = types.bool;
-          default = false;
-          description = "Enable Zima-specific hardware configuration.";
-        };
-      };
-    };
-    default = { };
-    description = "Zima hardware type configuration.";
-  };
-
-  config = mkIf cfg.enable {
-    # ========== Boot Configuration ==========
-
-    boot.initrd.availableKernelModules = [
-      "xhci_pci" # USB 3.0 support
-      "usb_storage" # USB storage devices
-      "sd_mod" # SD card support
-      "sdhci_pci" # SD card host controller
-    ];
-    boot.initrd.kernelModules = [ ];
-    boot.kernelModules = [ "kvm-intel" ]; # Intel virtualization support
-    boot.extraModulePackages = [ ];
-    boot.kernelParams = [
-      "quiet" # Minimal boot messages
-      "splash" # Show Plymouth boot splash
-      "boot.shell_on_fail" # Emergency shell on boot failure
-      "udev.log_priority=3" # Reduce udev logging
-      "rd.systemd.show_status=auto" # Show systemd status during boot
-    ];
-
-    # ========== Filesystem Configuration ==========
-    athenix.host.filesystem.useSwap = lib.mkDefault false;
-    athenix.host.filesystem.device = lib.mkDefault "/dev/mmcblk0";
-    athenix.host.buildMethods = lib.mkDefault [ "installer-iso" ];
-    nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
-
-    # ========== Hardware Configuration ==========
-    hardware.cpu.intel.updateMicrocode = lib.mkDefault config.hardware.enableRedistributableFirmware;
-
-    # ========== Software Profile ==========
-    athenix.sw.enable = lib.mkDefault true;
-    athenix.sw.desktop.enable = lib.mkDefault true;
-  };
-}

installer/PROXMOX_LXC.md

@@ -46,7 +46,7 @@ Add the host to `inventory.nix` with the `nix-lxc` type or ensure it has the app
 }
 ```
 
-Your host type configuration (`hw/nix-lxc.nix`) should include:
+Your host type configuration (`hosts/types/nix-lxc.nix`) should include:
 
 ```nix
 {

installer/artifacts.nix

@@ -1,9 +1,8 @@
 {
   inputs,
-  fleet,
+  hosts,
   self,
   system,
-  users ? { },
 }:
 # This file defines the logic for generating various build artifacts (ISOs, Netboot, LXC, etc.)
 # It exports a set of packages that can be built using `nix build .#<artifact-name>`
@@ -30,7 +29,6 @@ let
           hostName
           targetSystemBuild
           diskoScript
-          users
           ;
         hostPlatform = system;
       };
@@ -47,10 +45,7 @@ let
     nixos-generators.nixosGenerate {
       inherit system;
       specialArgs = { inherit inputs; };
-      modules = fleet.modules.${hostName} ++ [
+      modules = hosts.modules.${hostName} ++ [
-        {
-          config.athenix.users = lib.mapAttrs (_: user: lib.mapAttrs (_: lib.mkDefault) user) users;
-        }
         {
           disko.enableConfig = lib.mkForce false;
           services.upower.enable = lib.mkForce false;
@@ -66,11 +61,8 @@ let
     nixpkgs.lib.nixosSystem {
       inherit system;
       specialArgs = { inherit inputs; };
-      modules = fleet.modules.${hostName} ++ [
+      modules = hosts.modules.${hostName} ++ [
         "${nixpkgs}/nixos/modules/installer/netboot/netboot.nix"
-        {
-          config.athenix.users = lib.mapAttrs (_: user: lib.mapAttrs (_: lib.mkDefault) user) users;
-        }
         {
           disko.enableConfig = lib.mkForce false;
           services.upower.enable = lib.mkForce false;
@@ -78,14 +70,14 @@ let
       ];
     };
 
-  hostNames = builtins.attrNames fleet.nixosConfigurations;
+  hostNames = builtins.attrNames hosts.nixosConfigurations;
 
   # Generate installer ISOs for hosts that have "installer-iso" in their buildMethods
   installerPackages = lib.listToAttrs (
     lib.concatMap (
       name:
       let
-        cfg = fleet.nixosConfigurations.${name};
+        cfg = hosts.nixosConfigurations.${name};
       in
       if lib.elem "installer-iso" cfg.config.athenix.host.buildMethods then
         [
@@ -104,7 +96,7 @@ let
     lib.concatMap (
       name:
       let
-        cfg = fleet.nixosConfigurations.${name};
+        cfg = hosts.nixosConfigurations.${name};
       in
       if lib.elem "iso" cfg.config.athenix.host.buildMethods then
         [
@@ -123,7 +115,7 @@ let
     lib.concatMap (
       name:
       let
-        cfg = fleet.nixosConfigurations.${name};
+        cfg = hosts.nixosConfigurations.${name};
       in
       if lib.elem "ipxe" cfg.config.athenix.host.buildMethods then
         [
@@ -153,7 +145,7 @@ let
     lib.concatMap (
       name:
       let
-        cfg = fleet.nixosConfigurations.${name};
+        cfg = hosts.nixosConfigurations.${name};
       in
       if lib.elem "lxc" cfg.config.athenix.host.buildMethods then
         [
@@ -172,7 +164,7 @@ let
     lib.concatMap (
       name:
       let
-        cfg = fleet.nixosConfigurations.${name};
+        cfg = hosts.nixosConfigurations.${name};
       in
       if lib.elem "proxmox" cfg.config.athenix.host.buildMethods then
         [

installer/auto-install.nix

@@ -2,7 +2,10 @@
 # It is intended to be used in an installation ISO.
 # It expects `targetSystem` (the closure to install) and `diskoScript` (the partitioning script) to be passed as arguments.
 {
+  config,
+  lib,
   pkgs,
+  inputs,
   hostName,
   hostPlatform,
   targetSystemBuild,
@@ -10,6 +13,7 @@
   ...
 }:
 {
+  # Ensure the entire system closure and all dependencies are included in the ISO
   environment.systemPackages = [
     pkgs.git
     pkgs.bashInteractive
@@ -17,15 +21,19 @@
     targetSystemBuild.toplevel
   ];
 
+  # Explicitly include the system closure in the ISO image to prevent any need to build or fetch
+  isoImage.contents = [
+    {
+      source = targetSystem;
+      target = "/system";
+    }
+  ];
+
   nixpkgs.hostPlatform = hostPlatform;
 
   nix.settings.experimental-features = "nix-command flakes";
 
-  system.extraDependencies = with targetSystemBuild; [
+  system.extraDependencies = with targetSystemBuild; [ toplevel etc bootStage2 ];
-    toplevel
-    etc
-    bootStage2
-  ];
 
   isoImage.storeContents = [ targetSystemBuild.toplevel ];
 
@@ -51,12 +59,27 @@
       echo ">>> Running disko script..."
       ${diskoScript}
 
+<<<<<<< HEAD
       echo ">>> Setting up NixOS..."
       nixos-install \
       --system ${targetSystemBuild.toplevel} \
       --no-root-passwd \
       --no-channel-copy \
       --substituters "" 
+=======
+      echo ">>> Copying system closure to target..."
+      # Copy the entire system closure without substitution
+      nix-store --store /mnt --load-db < <(nix-store --dump-db)
+      nix-copy-closure --to /mnt ${targetSystem} 2>/dev/null || true
+
+      echo ">>> Running nixos-install..."
+      # Install with pre-built closure already in store
+      nixos-install \
+        --no-root-passwd \
+        --root /mnt \
+        --system ${targetSystem} \
+        --option substitute false
+>>>>>>> parent of b23525d (fix: build closure in build-step instead of on iso)
 
       echo ">>> Done. Rebooting."
       systemctl reboot

installer/modules.nix

@@ -6,26 +6,40 @@
 #
 # Usage in another flake:
 #   # Full host type configurations (includes hardware + software + system config)
-#   inputs.athenix.nixosModules.nix-desktop
+#   inputs.nixos-systems.nixosModules.nix-desktop
-#   inputs.athenix.nixosModules.nix-laptop
+#   inputs.nixos-systems.nixosModules.nix-laptop
 #
-#   # Software-only configuration (for custom hardware setups)
+#   # Software-only configurations (for custom hardware setups)
-#   inputs.athenix.nixosModules.sw
+#   # Note: These include theme.nix in home-manager.sharedModules automatically
+#   inputs.nixos-systems.nixosModules.sw-desktop
+#   inputs.nixos-systems.nixosModules.sw-headless
+#
+#   # Home Manager modules (user-level configuration)
+#   # Theme module (no parameters):
+#   home-manager.users.myuser.imports = [ inputs.nixos-systems.homeManagerModules.theme ];
+#
+#   # Neovim module (requires user parameter):
+#   home-manager.users.myuser.imports = [
+#     (inputs.nixos-systems.homeManagerModules.nvim {
+#       user = config.athenix.users.accounts.myuser;
+#     })
+#   ];
 
 { inputs }:
-# Expose hardware type modules from hw/ directory
-# This returns an attribute set like: { nix-desktop = ...; nix-laptop = ...; nix-lxc = ...; }
-let
-  hostTypes = import ../hw { inherit inputs; };
-in
 {
-  # Software configuration module - main module with all athenix.sw options
+  # ========== Full Host Type Modules ==========
-  # Use athenix.sw.<type>.enable to enable software profiles: desktop, tablet-kiosk, headless, stateless-kiosk, builders
+  # Complete system configurations including hardware, boot, and software
-  hw = hostTypes;
+  nix-desktop = import ../hosts/types/nix-desktop.nix { inherit inputs; }; # Desktop workstations
-  sw =
+  nix-laptop = import ../hosts/types/nix-laptop.nix { inherit inputs; }; # Laptop systems
-    {
+  nix-surface = import ../hosts/types/nix-surface.nix { inherit inputs; }; # Surface tablets
-      inputs,
+  nix-lxc = import ../hosts/types/nix-lxc.nix { inherit inputs; }; # Proxmox containers
-      ...
+  nix-wsl = import ../hosts/types/nix-wsl.nix { inherit inputs; }; # WSL2 systems
-    }@args:
+  nix-ephemeral = import ../hosts/types/nix-ephemeral.nix { inherit inputs; }; # Diskless/RAM-only
-    (import ../sw/default.nix (args // { inherit inputs; }));
+
+  # ========== Software Configuration Module ==========
+  # Main software module with all athenix.sw options
+  # Use athenix.sw.type to select profile: "desktop", "tablet-kiosk", "headless", "stateless-kiosk"
+  # Use athenix.sw.extraPackages to add additional packages
+  # Use athenix.sw.kioskUrl to set kiosk mode URL
+  sw = { inputs, ... }@args: (import ../sw/default.nix (args // { inherit inputs; }));
 }

inventory.nix

@@ -1,79 +1,72 @@
-# ============================================================================
-# Fleet Inventory
-# ============================================================================
-# Top-level keys are ALWAYS hostname prefixes. Actual hostnames are generated
-# from the devices map or count.
-#
-# Hostname generation rules:
-# - Numeric suffixes: no dash (e.g., "nix-surface1", "nix-surface2")
-# - Non-numeric suffixes: add dash (e.g., "nix-surface-alpha", "nix-surface-beta")
-# - Set athenix.host.useHostPrefix = false to use suffix as full hostname
-#
-# Format:
-#   "prefix" = {
-#     type = "nix-desktop";        # Optional: defaults to prefix name
-#     system = "x86_64-linux";     # Optional: default is x86_64-linux
-#
-#     # Option 1: Simple count (quick syntax)
-#     devices = 5;                 # Creates: prefix1, prefix2, ..., prefix5
-#
-#     # Option 2: Explicit count
-#     count = 5;                   # Creates: prefix1, prefix2, ..., prefix5
-#
-#     # Option 3: Default count (for groups with mixed devices)
-#     defaultCount = 3;            # Creates default numbered hosts
-#
-#     # Option 4: Named device configurations
-#     devices = {
-#       "1" = { ... };             # Creates: prefix1
-#       "alpha" = { ... };         # Creates: prefix-alpha
-#       "custom" = {               # Creates: custom (no prefix)
-#         athenix.host.useHostPrefix = false;
-#       };
-#     };
-#
-#     # Common config for all devices in this group
-#     overrides = {
-#       athenix.users.user1.enable = true;  # Applied to all devices in this group
-#       # ... any other config
-#     };
-#   };
-#
-# Convenience options:
-#   athenix.forUser = "username";  # Automatically enables user (sets athenix.users.username.enable = true)
-#
-# External modules (instead of config):
-#   Device values can be a config attrset with an optional 'external' field:
-#   devices."hostname" = {
-#     external = { url = "..."; rev = "..."; submodules? = false; };  # Lazy: only fetched when building this host
-#     # ... additional config options
-#   };
-#   The external module will be imported and evaluated only when this specific host is built.
-#
-# Examples:
-#   "lab" = { devices = 3; };                           # Quick: lab1, lab2, lab3
-#   "lab" = { count = 3; };                             # Same as above
-#   "kiosk" = {
-#     defaultCount = 2;                                 # kiosk1, kiosk2 (default)
-#     devices."special" = {};                           # kiosk-special (custom)
-#   };
-#   "laptop" = {
-#     devices = 5;
-#     overrides.athenix.users.student.enable = true;     # All 5 laptops get this user
-#   };
-#   "wsl" = {
-#     devices."alice".athenix.forUser = "alice123";       # Sets up for user alice123
-#   };
-#   "external" = {
-#     devices."remote".external = { url = "..."; rev = "..."; };  # External module via Git (lazy)
-#       url = "https://github.com/example/config";
-#       rev = "e1ccd7cc3e709afe4f50b0627e1c4bde49165014";
-#     };
-#   };
-{ ... }:
 {
-  athenix.fleet = {
+  # ============================================================================
-    # ========== Lab Laptops ==========
+  # Fleet Inventory
+  # ============================================================================
+  # Top-level keys are ALWAYS hostname prefixes. Actual hostnames are generated
+  # from the devices map or count.
+  #
+  # Hostname generation rules:
+  # - Numeric suffixes: no dash (e.g., "nix-surface1", "nix-surface2")
+  # - Non-numeric suffixes: add dash (e.g., "nix-surface-alpha", "nix-surface-beta")
+  # - Set athenix.host.useHostPrefix = false to use suffix as full hostname
+  #
+  # Format:
+  #   "prefix" = {
+  #     type = "nix-desktop";        # Optional: defaults to prefix name
+  #     system = "x86_64-linux";     # Optional: default is x86_64-linux
+  #
+  #     # Option 1: Simple count (quick syntax)
+  #     devices = 5;                 # Creates: prefix1, prefix2, ..., prefix5
+  #
+  #     # Option 2: Explicit count
+  #     count = 5;                   # Creates: prefix1, prefix2, ..., prefix5
+  #
+  #     # Option 3: Default count (for groups with mixed devices)
+  #     defaultCount = 3;            # Creates default numbered hosts
+  #
+  #     # Option 4: Named device configurations
+  #     devices = {
+  #       "1" = { ... };             # Creates: prefix1
+  #       "alpha" = { ... };         # Creates: prefix-alpha
+  #       "custom" = {               # Creates: custom (no prefix)
+  #         athenix.host.useHostPrefix = false;
+  #       };
+  #     };
+  #
+  #     # Common config for all devices in this group
+  #     overrides = {
+  #       athenix.users.user1.enable = true;  # Applied to all devices in this group
+  #       # ... any other config
+  #     };
+  #   };
+  #
+  # Convenience options:
+  #   athenix.forUser = "username";  # Automatically enables user (sets athenix.users.username.enable = true)
+  #
+  # External modules (instead of config):
+  #   Device values can be either a config attrset OR a fetchGit/fetchurl call
+  #   that points to an external Nix module. The module will be imported and evaluated.
+  #
+  # Examples:
+  #   "lab" = { devices = 3; };                           # Quick: lab1, lab2, lab3
+  #   "lab" = { count = 3; };                             # Same as above
+  #   "kiosk" = {
+  #     defaultCount = 2;                                 # kiosk1, kiosk2 (default)
+  #     devices."special" = {};                           # kiosk-special (custom)
+  #   };
+  #   "laptop" = {
+  #     devices = 5;
+  #     overrides.athenix.users.student.enable = true;     # All 5 laptops get this user
+  #   };
+  #   "wsl" = {
+  #     devices."alice".athenix.forUser = "alice123";       # Sets up for user alice123
+  #   };
+  #   "external" = {
+  #     devices."remote" = builtins.fetchGit {            # External module via Git
+  #       url = "https://github.com/example/config";
+  #       rev = "e1ccd7cc3e709afe4f50b0627e1c4bde49165014";
+  #     };
+  #   };  # ========== Lab Laptops ==========
   # Creates: nix-laptop1, nix-laptop2
   # Both get hdh20267 user via overrides
   nix-laptop = {
@@ -92,10 +85,10 @@
   nix-surface = {
     defaultCount = 3;
     devices = {
-        "1".athenix.sw.tablet-kiosk.kioskUrl = "https://google.com";
+      "1".athenix.sw.kioskUrl = "https://google.com";
     };
     overrides = {
-        athenix.sw.tablet-kiosk.kioskUrl = "https://yahoo.com";
+      athenix.sw.kioskUrl = "https://yahoo.com";
     };
   };
 
@@ -106,10 +99,11 @@
       "nix-builder" = {
         # Gitea Actions self-hosted runner configuration
         athenix.sw = {
-            headless.enable = true;
+          type = [
-            builders = {
+            "headless"
-              enable = true;
+            "builders"
-              giteaRunner = {
+          ];
+          builders.giteaRunner = {
             enable = true;
             url = "https://git.factory.uga.edu";
             # Token file must be created manually at this path with a Gitea runner token
@@ -126,11 +120,10 @@
           };
         };
       };
-        };
+      "usda-dash" = builtins.fetchGit {
-        "usda-dash".external = {
         url = "https://git.factory.uga.edu/MODEL/usda-dash-config.git";
-          rev = "ce2700b0196e106f7c013bbcee851a5f96b146a3";
+        rev = "dab32f5884895cead0fae28cb7d88d17951d0c12";
-          submodules = false;
+        submodules = true;
       };
     };
     overrides = {
@@ -153,5 +146,34 @@
   # ========== Ephemeral/Netboot System ==========
   # Creates: nix-ephemeral1
   nix-ephemeral.devices = 1;
-  };
+
+  # ========== Example: External Module Configurations ==========
+  # Uncomment to use external modules from Git repositories:
+  #
+  # external-systems = {
+  #   devices = {
+  #     # Option 1: fetchGit with specific revision (recommended for reproducibility)
+  #     "prod-server" = builtins.fetchGit {
+  #       url = "https://github.com/example/server-config";
+  #       rev = "e1ccd7cc3e709afe4f50b0627e1c4bde49165014";  # Full commit hash
+  #       ref = "main";              # Optional: branch/tag name
+  #     };
+  #
+  #     # Option 2: fetchGit with latest from branch (less reproducible)
+  #     "dev-server" = builtins.fetchGit {
+  #       url = "https://github.com/example/server-config";
+  #       ref = "develop";
+  #     };
+  #
+  #     # Option 3: fetchTarball for specific release
+  #     "test-server" = builtins.fetchTarball {
+  #       url = "https://github.com/example/server-config/archive/v1.0.0.tar.gz";
+  #       sha256 = "sha256:0000000000000000000000000000000000000000000000000000";
+  #     };
+  #
+  #     # Option 4: Mix external module with local overrides
+  #     # Note: The external module's default.nix should export a NixOS module
+  #     # that accepts { inputs, ... } as parameters
+  #   };
+  # };
 }

lib/default.nix

@@ -1,8 +0,0 @@
-{
-  lib,
-  ...
-}:
-{
-  mkFleet = import ./mkFleet.nix;
-  macCaseBuilder = import ./macCaseBuilder.nix { inherit lib; };
-}

lib/macCaseBuilder.nix

@@ -1,33 +0,0 @@
-{ lib }:
-let
-  # Default MAC address to station number mapping
-  defaultHostmap = {
-    "00:e0:4c:46:0b:32" = "1";
-    "00:e0:4c:46:07:26" = "2";
-    "00:e0:4c:46:05:94" = "3";
-    "00:e0:4c:46:07:11" = "4";
-    "00:e0:4c:46:08:02" = "5";
-    "00:e0:4c:46:08:5c" = "6";
-  };
-
-  # macCaseBuilder: builds a shell case statement from a hostmap
-  # Parameters:
-  #   varName: the shell variable to assign
-  #   prefix: optional string to prepend to the value (default: "")
-  #   hostmap: optional attribute set to use (default: built-in hostmap)
-  #
-  # Example:
-  #   macCaseBuilder { varName = "STATION"; prefix = "nix-"; }
-  #   # Generates case statements like: 00:e0:4c:46:0b:32) STATION=nix-1 ;;
-  builder =
-    {
-      varName,
-      prefix ? "",
-      hostmap ? defaultHostmap,
-    }:
-    lib.concatStringsSep "\n" (
-      lib.mapAttrsToList (mac: val: "      ${mac}) ${varName}=${prefix}${val} ;;") hostmap
-    );
-in
-# Export the builder function with hostmap as an accessible attribute
-lib.setFunctionArgs builder { } // { hostmap = defaultHostmap; }

lib/mkFleet.nix

@@ -1,18 +0,0 @@
-# Generate fleet configurations with custom fleet and hardware types
-# Usage: nixosConfigurations = athenix.lib.mkFleet { fleet = { ... }; hwTypes = { ... }; }
-{
-  inputs,
-  lib,
-  config,
-  self ? null,
-  users ? { },
-}:
-import ../fleet/default.nix {
-  inherit
-    inputs
-    lib
-    config
-    self
-    users
-    ;
-}

parts/docs.nix

@@ -1,194 +0,0 @@
-# Documentation generation
-{
-  inputs,
-  self,
-  lib,
-  ...
-}:
-let
-  pkgs = inputs.nixpkgs.legacyPackages.x86_64-linux;
-
-  # Extract options from a sample configuration
-  getAthenixOptions =
-    configName:
-    let
-      nixosConfig = self.nixosConfigurations.${configName};
-      evaledOptions = nixosConfig.options;
-
-      # Filter to just athenix namespace
-      athenixOptions = evaledOptions.athenix or { };
-    in
-    athenixOptions;
-
-  # Generate wiki home page
-  wikiHome = pkgs.writeText "Home.md" ''
-    # Athenix - NixOS Fleet Management
-
-    Athenix is a NixOS configuration system for managing the UGA Innovation Factory's fleet of devices using Nix flakes and a custom configuration framework.
-
-    ## Quick Start
-
-    - [Configuration Options](Configuration-Options) - All available `athenix.*` options
-    - [User Guide](User-Configuration) - Setting up user accounts and dotfiles
-    - [Building](Building) - Creating installers and system images
-    - [Development](Development) - Contributing to Athenix
-
-    ## Features
-
-    - **Inventory-based fleet management** - Define entire device fleets in a single file
-    - **Multiple hardware types** - Desktops, laptops, Surface tablets, LXC containers, WSL
-    - **Flexible software configurations** - Desktop, headless, kiosk, and builder modes
-    - **External module support** - Load user dotfiles and system configs from Git repos
-    - **Declarative everything** - Reproducible builds with pinned dependencies
-
-    ## Software Types
-
-    Enable different system configurations:
-
-    - **desktop** - Full KDE Plasma 6 desktop environment
-    - **headless** - Minimal server/container configuration
-    - **tablet-kiosk** - Touch-optimized kiosk for Surface tablets
-    - **stateless-kiosk** - Diskless PXE boot kiosk
-    - **builders** - CI/CD build server with Gitea Actions runner
-
-    ## Hardware Types
-
-    - **nix-desktop** - Desktop workstations
-    - **nix-laptop** - Laptop computers
-    - **nix-surface** - Microsoft Surface Pro tablets
-    - **nix-lxc** - LXC containers (Proxmox)
-    - **nix-wsl** - Windows Subsystem for Linux
-    - **nix-ephemeral** - Stateless systems (PXE boot)
-
-    ## Documentation
-
-    Browse the documentation using the sidebar or start with:
-
-    - [README](README) - Repository overview and getting started
-    - [Configuration Options](Configuration-Options) - Complete option reference
-    - [Inventory Guide](Inventory) - Managing the device fleet
-    - [External Modules](External-Modules) - Using external configurations
-  '';
-
-  # Generate markdown documentation from options
-  optionsToMarkdown =
-    options:
-    pkgs.writeText "options.md" ''
-      # Configuration Options
-
-      This document describes all available configuration options in the Athenix namespace.
-
-      ## Quick Reference
-
-      - **athenix.sw** - Software configuration (desktop, headless, kiosk modes)
-      - **athenix.users** - User account management
-      - **athenix.host** - Host-specific settings (filesystem, build methods)
-      - **athenix.fleet** - Fleet inventory definitions
-      - **athenix.forUser** - Convenience option to enable a user
-      - **athenix.system.gc** - Garbage collection settings
-
-      ## Detailed Options
-
-      For detailed option information, use:
-      ```bash
-      # View all athenix options
-      nix eval .#nixosConfigurations.nix-desktop1.options.athenix --apply builtins.attrNames
-
-      # View specific option description
-      nix eval .#nixosConfigurations.nix-desktop1.options.athenix.sw.desktop.enable.description
-
-      # Export all options to JSON
-      nix build .#athenix-options
-      cat result | jq
-      ```
-
-      ## Software Types
-
-      Enable different system configurations:
-
-      - **desktop** - Full KDE Plasma desktop environment
-      - **headless** - Server/container configuration  
-      - **tablet-kiosk** - Touch-optimized kiosk for tablets
-      - **stateless-kiosk** - Diskless PXE boot kiosk
-      - **builders** - Build server with optional Gitea Actions runner
-
-      See the individual option descriptions for detailed information.
-    '';
-in
-{
-  perSystem =
-    { system, ... }:
-    lib.mkIf (system == "x86_64-linux") {
-      packages = {
-        # Generate option documentation in markdown
-        docs =
-          pkgs.runCommand "athenix-docs"
-            {
-              nativeBuildInputs = [ pkgs.jq ];
-            }
-            ''
-              mkdir -p $out
-
-              # Generate wiki home page
-              cat > $out/Home.md << 'EOF'
-              ${builtins.readFile wikiHome}
-              EOF
-
-              # Copy main README
-              cp ${../README.md} $out/README.md
-
-              # Copy documentation with wiki-friendly names
-              cp ${../docs/BUILDING.md} $out/Building.md
-              cp ${../docs/DEVELOPMENT.md} $out/Development.md
-              cp ${../docs/EXTERNAL_MODULES.md} $out/External-Modules.md
-              cp ${../docs/INVENTORY.md} $out/Inventory.md
-              cp ${../docs/NAMESPACE.md} $out/Namespace.md
-              cp ${../docs/USER_CONFIGURATION.md} $out/User-Configuration.md
-
-              # Generate options reference
-              cat > $out/Configuration-Options.md << 'EOF'
-              ${builtins.readFile (optionsToMarkdown (getAthenixOptions "nix-desktop1"))}
-              EOF
-
-              echo "Documentation generated in $out"
-            '';
-
-        # Extract just the athenix namespace options as JSON
-        athenix-options =
-          let
-            nixosConfig =
-              self.nixosConfigurations.nix-desktop1
-                or (builtins.head (builtins.attrValues self.nixosConfigurations));
-
-            # Recursively extract option information
-            extractOption =
-              opt:
-              if opt ? _type && opt._type == "option" then
-                {
-                  inherit (opt) description;
-                  type = opt.type.description or (opt.type.name or "unknown");
-                  default =
-                    if opt ? default then
-                      if builtins.isAttrs opt.default && opt.default ? _type then "<special>" else opt.default
-                    else
-                      null;
-                  example =
-                    if opt ? example then
-                      if builtins.isAttrs opt.example && opt.example ? _type then "<special>" else opt.example
-                    else
-                      null;
-                }
-              else if builtins.isAttrs opt then
-                lib.mapAttrs (name: value: extractOption value) (
-                  # Filter out internal attributes
-                  lib.filterAttrs (n: _: !lib.hasPrefix "_" n) opt
-                )
-              else
-                null;
-
-            athenixOpts = nixosConfig.options.athenix or { };
-          in
-          pkgs.writeText "athenix-options.json" (builtins.toJSON (extractOption athenixOpts));
-      };
-    };
-}

parts/formatter.nix

@@ -1,9 +0,0 @@
-# Formatter configuration for flake-parts
-{ ... }:
-{
-  perSystem =
-    { pkgs, ... }:
-    {
-      formatter = pkgs.nixfmt-rfc-style;
-    };
-}

parts/lib.nix

@@ -1,8 +0,0 @@
-# Library functions for flake-parts
-{ inputs, ... }:
-{
-  flake.lib = import ../lib {
-    inherit inputs;
-    lib = inputs.nixpkgs.lib;
-  };
-}

parts/nixos-configurations.nix

@@ -1,28 +0,0 @@
-# NixOS configurations generated from fleet
-{
-  inputs,
-  self,
-  lib,
-  config,
-  ...
-}:
-{
-  imports = [
-    ../fleet/fleet-option.nix
-  ];
-
-  flake.nixosConfigurations =
-    let
-      users = config.athenix.users;
-      fleet = self.lib.mkFleet {
-        inherit
-          inputs
-          lib
-          config
-          self
-          users
-          ;
-      };
-    in
-    fleet.nixosConfigurations;
-}

parts/nixos-modules.nix

@@ -1,5 +0,0 @@
-# Expose host type modules and installer modules for external use
-{ inputs, ... }:
-{
-  flake.nixosModules = import ../installer/modules.nix { inherit inputs; };
-}

parts/packages.nix

@@ -1,37 +0,0 @@
-# Build artifacts (ISOs, LXC containers, etc.)
-{
-  inputs,
-  self,
-  lib,
-  config,
-  ...
-}:
-{
-  perSystem =
-    { system, ... }:
-    lib.mkIf (system == "x86_64-linux") {
-      packages =
-        let
-          users = config.athenix.users;
-          fleet = self.lib.mkFleet {
-            inherit
-              inputs
-              lib
-              config
-              self
-              users
-              ;
-          };
-          artifacts = import ../installer/artifacts.nix {
-            inherit
-              inputs
-              fleet
-              self
-              system
-              users
-              ;
-          };
-        in
-        artifacts;
-    };
-}

parts/templates.nix

@@ -1,5 +0,0 @@
-# Templates for external configurations
-{ ... }:
-{
-  flake.templates = import ../templates;
-}

secrets.nix

@@ -1,187 +0,0 @@
-# ============================================================================
-# Agenix Secret Recipients Configuration (Auto-Generated)
-# ============================================================================
-# This file automatically discovers hosts and their public keys from the
-# secrets/ directory structure and generates recipient configurations.
-#
-# Directory structure:
-#   secrets/{hostname}/*.pub  -> SSH/age public keys for that host
-#   secrets/global/*.pub      -> Keys accessible to all hosts
-#
-# Usage:
-#   ragenix -e secrets/global/example.age     # Edit/create secret
-#   ragenix -r                                # Re-key all secrets
-#
-# To add admin keys for editing secrets, create secrets/admins/*.pub files
-# with your personal age public keys (generated with: age-keygen)
-
-let
-  lib = builtins;
-
-  # Helper functions not in builtins
-  filterAttrs =
-    pred: set:
-    lib.listToAttrs (
-      lib.filter (item: pred item.name item.value) (
-        lib.map (name: {
-          inherit name;
-          value = set.${name};
-        }) (lib.attrNames set)
-      )
-    );
-
-  concatLists = lists: lib.foldl' (acc: list: acc ++ list) [ ] lists;
-
-  unique =
-    list:
-    let
-      go =
-        acc: remaining:
-        if remaining == [ ] then
-          acc
-        else if lib.elem (lib.head remaining) acc then
-          go acc (lib.tail remaining)
-        else
-          go (acc ++ [ (lib.head remaining) ]) (lib.tail remaining);
-    in
-    go [ ] list;
-
-  hasSuffix =
-    suffix: str:
-    let
-      lenStr = lib.stringLength str;
-      lenSuffix = lib.stringLength suffix;
-    in
-    lenStr >= lenSuffix && lib.substring (lenStr - lenSuffix) lenSuffix str == suffix;
-
-  nameValuePair = name: value: { inherit name value; };
-
-  secretsPath = ./secrets;
-
-  # Read all directories in secrets/
-  secretDirs = if lib.pathExists secretsPath then lib.readDir secretsPath else { };
-
-  # Filter to only directories (excludes files)
-  isDirectory = name: type: type == "directory";
-  directories = lib.filter (name: isDirectory name secretDirs.${name}) (lib.attrNames secretDirs);
-
-  # Read public keys from a directory and convert to age format
-  readHostKeys =
-    dirName:
-    let
-      dirPath = secretsPath + "/${dirName}";
-      files = if lib.pathExists dirPath then lib.readDir dirPath else { };
-
-      # Prefer .age.pub files (pre-converted), fall back to .pub files
-      agePubFiles = filterAttrs (name: type: type == "regular" && hasSuffix ".age.pub" name) files;
-
-      sshPubFiles = filterAttrs (
-        name: type: type == "regular" && hasSuffix ".pub" name && !(hasSuffix ".age.pub" name)
-      ) files;
-
-      # Read age public keys (already in correct format)
-      ageKeys = lib.map (
-        name:
-        let
-          content = lib.readFile (dirPath + "/${name}");
-          # Trim whitespace/newlines
-          trimmed = lib.replaceStrings [ "\n" " " "\r" "\t" ] [ "" "" "" "" ] content;
-        in
-        trimmed
-      ) (lib.attrNames agePubFiles);
-
-      # For SSH keys, just include them as-is (user needs to convert with ssh-to-age)
-      # Or they can run the update-age-keys.sh script
-      sshKeys =
-        if (lib.length (lib.attrNames sshPubFiles)) > 0 then
-          lib.trace "Warning: ${dirName} has unconverted SSH keys. Run secrets/update-age-keys.sh" [ ]
-        else
-          [ ];
-    in
-    lib.filter (k: k != null && k != "") (ageKeys ++ sshKeys);
-
-  # Build host key mappings: { hostname = [ "age1..." "age2..." ]; }
-  hostKeys = lib.listToAttrs (
-    lib.map (dir: nameValuePair dir (readHostKeys dir)) (
-      lib.filter (d: d != "global" && d != "admins") directories
-    )
-  );
-
-  # Global keys that all hosts can use
-  globalKeys = if lib.elem "global" directories then readHostKeys "global" else [ ];
-
-  # Admin keys for editing secrets
-  adminKeys = if lib.elem "admins" directories then readHostKeys "admins" else [ ];
-
-  # All host keys combined
-  allHostKeys = concatLists (lib.attrValues hostKeys);
-
-  # Find all .age files in the secrets directory
-  findSecrets =
-    dir:
-    let
-      dirPath = secretsPath + "/${dir}";
-      files = if lib.pathExists dirPath then lib.readDir dirPath else { };
-      ageFiles = filterAttrs (name: type: type == "regular" && hasSuffix ".age" name) files;
-    in
-    lib.map (name: "secrets/${dir}/${name}") (lib.attrNames ageFiles);
-
-  # Generate recipient list for a secret based on its location
-  getRecipients =
-    secretPath:
-    let
-      # Extract directory name from path: "secrets/nix-builder/foo.age" -> "nix-builder"
-      pathParts = lib.split "/" secretPath;
-      dirName = lib.elemAt pathParts 2;
-    in
-    if dirName == "global" then
-      # Global secrets: all hosts + admins
-      allHostKeys ++ globalKeys ++ adminKeys
-    else if hostKeys ? ${dirName} then
-      # Host-specific secrets: that host + global keys + admins
-      hostKeys.${dirName} ++ globalKeys ++ adminKeys
-    else
-      # Fallback: just admins
-      adminKeys;
-
-  # Find all secrets across all directories
-  allSecrets = concatLists (lib.map findSecrets directories);
-
-  # Generate the configuration
-  secretsConfig = lib.listToAttrs (
-    lib.map (
-      secretPath:
-      let
-        recipients = getRecipients secretPath;
-        # Remove duplicates and empty keys
-        uniqueRecipients = unique (lib.filter (k: k != null && k != "") recipients);
-      in
-      nameValuePair secretPath {
-        publicKeys = uniqueRecipients;
-      }
-    ) allSecrets
-  );
-
-  # Generate wildcard rules for each directory to allow creating new secrets
-  wildcardRules = lib.listToAttrs (
-    lib.concatMap (dir: [
-      # Match with and without .age extension for ragenix compatibility
-      (nameValuePair "secrets/${dir}/*" {
-        publicKeys =
-          let
-            recipients = getRecipients "secrets/${dir}/dummy.age";
-          in
-          unique (lib.filter (k: k != null && k != "") recipients);
-      })
-      (nameValuePair "secrets/${dir}/*.age" {
-        publicKeys =
-          let
-            recipients = getRecipients "secrets/${dir}/dummy.age";
-          in
-          unique (lib.filter (k: k != null && k != "") recipients);
-      })
-    ]) (lib.filter (d: d != "admins") directories)
-  );
-
-in
-secretsConfig // wildcardRules

secrets/DESIGN.md

@@ -1,174 +0,0 @@
-# Athenix Secrets System Design
-
-## Overview
-
-The Athenix secrets management system integrates ragenix (agenix) with automatic host discovery based on the repository's fleet inventory structure. It provides a seamless workflow for managing encrypted secrets across all systems.
-
-## Architecture
-
-### Auto-Discovery Module (`sw/secrets.nix`)
-
-**Purpose**: Automatically load and configure secrets at system deployment time.
-
-**Features**:
-- Discovers `.age` encrypted files from `secrets/` directories
-- Loads global secrets from `secrets/global/` on ALL systems
-- Loads host-specific secrets from `secrets/{hostname}/` on matching hosts
-- Auto-configures decryption keys based on `.pub` files in directories
-- Supports custom secret configuration via `default.nix` in each directory
-
-**Key Behaviors**:
-- Secrets are decrypted to `/run/agenix/{name}` at boot
-- Identity paths include: system SSH keys + global keys + host-specific keys
-- Host-specific secrets override global secrets with the same name
-
-### Dynamic Recipients Configuration (`secrets/secrets.nix`)
-
-**Purpose**: Generate ragenix recipient configuration from directory structure.
-
-**Features**:
-- Automatically discovers hosts from `secrets/` subdirectories
-- Reads age public keys from `.age.pub` files (converted from SSH keys)
-- Generates recipient lists based on secret location:
-  - `secrets/global/*.age` → ALL hosts + admins
-  - `secrets/{hostname}/*.age` → that host + global keys + admins
-- Supports admin keys in `secrets/admins/` for secret editing
-
-**Key Behaviors**:
-- No manual recipient list maintenance required
-- Adding a new host = create directory + add .pub key + run `update-age-keys.sh`
-- Works with ragenix CLI: `ragenix -e`, `ragenix -r`
-
-## Workflow
-
-### Adding a New Host
-
-1. **Capture SSH host key**:
-   ```bash
-   # From the running system
-   cat /etc/ssh/ssh_host_ed25519_key.pub > secrets/new-host/ssh_host_ed25519_key.pub
-   ```
-
-2. **Convert to age format**:
-   ```bash
-   cd secrets/
-   ./update-age-keys.sh
-   ```
-
-3. **Re-key existing secrets** (if needed):
-   ```bash
-   ragenix -r
-   ```
-
-### Creating a New Secret
-
-1. **Choose location**:
-   - `secrets/global/` → all systems can decrypt
-   - `secrets/{hostname}/` → only that host can decrypt
-
-2. **Create/edit secret**:
-   ```bash
-   ragenix -e secrets/global/my-secret.age
-   ```
-   
-3. **Recipients are auto-determined** from `secrets.nix`:
-   - Global secrets: all host keys + admin keys
-   - Host-specific: that host + global keys + admin keys
-
-### Cross-Host Secret Management
-
-Any Athenix host can manage secrets for other hosts because:
-- All public keys are in the repository (`*.age.pub` files)
-- `secrets/secrets.nix` auto-generates recipient lists
-- Hosts decrypt using their own private keys (not shared)
-
-Example: From `nix-builder`, create a secret for `usda-dash`:
-```bash
-ragenix -e secrets/usda-dash/database-password.age
-# Encrypted for usda-dash's public key + admins
-# usda-dash will decrypt using its private key at /etc/ssh/ssh_host_ed25519_key
-```
-
-## Directory Structure
-
-```
-secrets/
-├── secrets.nix              # Auto-generated recipient config
-├── update-age-keys.sh       # Helper to convert SSH → age keys
-├── README.md                # User documentation
-├── DESIGN.md                # This file
-│
-├── global/                  # Secrets for ALL hosts
-│   ├── *.pub                # SSH public keys
-│   ├── *.age.pub            # Age public keys (generated)
-│   ├── *.age                # Encrypted secrets
-│   └── default.nix          # Optional: custom secret config
-│
-├── {hostname}/              # Host-specific secrets
-│   ├── *.pub
-│   ├── *.age.pub
-│   ├── *.age
-│   └── default.nix
-│
-└── admins/                  # Admin keys for editing
-    └── *.age.pub
-```
-
-## Security Model
-
-1. **Public keys in git**: Safe to commit (only public keys, `.age.pub` and `.pub`)
-2. **Private keys on hosts**: Never leave the system (`/etc/ssh/ssh_host_*_key`, `/etc/age/identity.key`)
-3. **Encrypted secrets in git**: Safe to commit (`.age` files)
-4. **Decrypted secrets**: Only in memory/tmpfs (`/run/agenix/*`)
-
-## Integration Points
-
-### With NixOS Configuration
-
-```nix
-# Access decrypted secrets in any NixOS module
-config.age.secrets.my-secret.path  # => /run/agenix/my-secret
-
-# Example usage
-services.myapp.passwordFile = config.age.secrets.database-password.path;
-```
-
-### With Inventory System
-
-The system automatically matches `secrets/{hostname}/` to hostnames from `inventory.nix`. No manual configuration needed.
-
-### With External Modules
-
-External user/system modules can reference secrets:
-```nix
-# In external module
-{ config, ... }:
-{
-  programs.git.extraConfig.credential.helper = 
-    "store --file ${config.age.secrets.git-credentials.path}";
-}
-```
-
-## Advantages
-
-1. **Zero manual recipient management**: Just add directories and keys
-2. **Cross-host secret creation**: Any host can manage secrets for others
-3. **Automatic host discovery**: Syncs with inventory structure
-4. **Flexible permission model**: Global vs host-specific + custom configs
-5. **Version controlled**: All public data in git, auditable history
-6. **Secure by default**: Private keys never shared, secrets encrypted at rest
-
-## Limitations
-
-1. **Requires age key conversion**: SSH keys must be converted to age format (automated by script)
-2. **Bootstrap chicken-egg**: Need initial host key before encrypting secrets (capture from first boot or generate locally)
-3. **No secret rotation automation**: Must manually re-key with `ragenix -r`
-4. **Git history contains old encrypted versions**: Rotating keys doesn't remove old ciphertexts from history
-
-## Future Enhancements
-
-- Auto-run `update-age-keys.sh` in pre-commit hook
-- Integrate with inventory.nix to auto-generate host directories
-- Support for multiple identity types per host
-- Automated secret rotation scheduling
-- Integration with hardware security modules (YubiKey, etc.)

secrets/README.md

@@ -1,250 +0,0 @@
-# Secrets Management with Agenix
-
-This directory contains age-encrypted secrets for Athenix hosts. Secrets are automatically loaded based on directory structure.
-
-## Directory Structure
-
-```
-secrets/
-├── global/              # Secrets installed on ALL systems
-│   ├── default.nix      # Optional: Custom config for global secrets
-│   └── example.age      # Decrypted to /run/agenix/example on all hosts
-├── nix-builder/         # Secrets only for nix-builder host
-│   ├── default.nix      # Optional: Custom config for nix-builder secrets
-│   └── ssh_host_ed25519_key.age
-└── usda-dash/           # Secrets only for usda-dash host
-    └── ssh_host_ed25519_key.age
-```
-
-## How It Works
-
-1. **Global secrets** (`./secrets/global/*.age`) are installed on every system
-2. **Host-specific secrets** (`./secrets/{hostname}/*.age`) are only installed on matching hosts
-3. Only `.age` encrypted files are loaded; `.pub` public keys are ignored
-4. Secrets are decrypted at boot to `/run/agenix/{secret-name}` with mode `0400` and owner `root:root`
-5. **Custom configurations** can be defined in `default.nix` files within each directory
-
-## Creating Secrets
-
-### 1. Generate Age Keys
-
-For a new host, generate an age identity:
-```bash
-# On the target system
-mkdir -p /etc/age
-age-keygen -o /etc/age/identity.key
-chmod 600 /etc/age/identity.key
-```
-
-Or use SSH host keys (automatically done by Athenix):
-```bash
-# Get the age public key from SSH host key
-nix shell nixpkgs#ssh-to-age -c sh -c 'cat /etc/ssh/ssh_host_ed25519_key.pub | ssh-to-age'
-```
-
-### 2. Store Public Keys
-
-Save the public key to `secrets/{hostname}/` for reference:
-```bash
-# Example for nix-builder
-echo "age1..." > secrets/nix-builder/identity.pub
-```
-
-Or from SSH host key:
-```bash
-cat /etc/ssh/ssh_host_ed25519_key.pub > secrets/nix-builder/ssh_host_ed25519_key.pub
-```
-
-**Then convert SSH keys to age format:**
-```bash
-cd secrets/
-./update-age-keys.sh
-```
-
-This creates `.age.pub` files that `secrets.nix` uses for ragenix recipient configuration.
-
-### 3. Encrypt Secrets
-
-Encrypt a secret for specific hosts:
-```bash
-# For a single host
-age -r age1publickey... -o secrets/nix-builder/my-secret.age <<< "secret value"
-
-# For multiple hosts (recipient list)
-age -R recipients.txt -o secrets/global/shared-secret.age < plaintext-file
-
-# Using SSH public keys
-age -R secrets/nix-builder/ssh_host_ed25519_key.pub \
-    -o secrets/nix-builder/ssh_host_key.age < /etc/ssh/ssh_host_ed25519_key
-```
-
-### 4. Creating and Editing Secrets
-
-**For new secrets**, use the helper script (automatically determines recipients):
-
-```bash
-cd secrets/
-
-# Create a host-specific secret
-./create-secret.sh usda-dash/database-url.age <<< "postgresql://..."
-
-# Create a global secret
-echo "shared-api-key" | ./create-secret.sh global/api-key.age
-
-# From a file
-./create-secret.sh nix-builder/ssh-key.age < ~/.ssh/id_ed25519
-```
-
-The script automatically includes the correct recipients:
-- **Host-specific**: that host's keys + global keys + admin keys
-- **Global**: all host keys + admin keys
-
-**To edit existing secrets**, use `ragenix`:
-
-```bash
-# Install ragenix
-nix shell github:yaxitech/ragenix
-
-# Edit an existing secret (you must have a decryption key)
-ragenix -e secrets/global/existing-secret.age
-
-# Re-key all secrets after adding new hosts
-ragenix -r
-```
-
-**Why create with `age` first?** Ragenix requires the `.age` file to exist before editing. The `secrets/secrets.nix` configuration auto-discovers recipients from the directory structure, but ragenix doesn't support wildcard patterns for creating new files.
-
-**Recipient management** is automatic:
-- **Global secrets** (`secrets/global/*.age`): encrypted for ALL hosts + admins
-- **Host secrets** (`secrets/{hostname}/*.age`): encrypted for that host + global keys + admins
-- **Admin keys** from `secrets/admins/*.age.pub` allow editing from your workstation
-
-After creating new .age files with `age`, use `ragenix -r` to re-key all secrets with the updated recipient configuration.
-
-To add admin keys for editing secrets:
-```bash
-# Generate personal age key
-age-keygen -o ~/.config/age/personal.key
-
-# Extract public key and add to secrets
-grep "public key:" ~/.config/age/personal.key | cut -d: -f2 | tr -d ' ' > secrets/admins/your-name.age.pub
-```
-
-## Using Secrets in Configuration
-
-Secrets are automatically loaded. Reference them in your NixOS configuration:
-
-```nix
-# Example: Using a secret for a service
-services.myservice = {
-  enable = true;
-  passwordFile = config.age.secrets.my-password.path;  # /run/agenix/my-password
-};
-
-# Example: Setting up SSH host key from secret
-services.openssh = {
-  hostKeys = [{
-    path = config.age.secrets.ssh_host_ed25519_key.path;
-    type = "ed25519";
-  }];
-};
-```
-
-## Custom Secret Configuration
-
-For secrets needing custom permissions, use `athenix.sw.secrets.extraSecrets`:
-
-```nix
-# In inventory.nix or host config
-athenix.sw.secrets.extraSecrets = {
-  "nginx-cert" = {
-    file = ./secrets/custom/cert.age;
-    mode = "0440";
-    owner = "nginx";
-    group = "nginx";
-  };
-};
-```
-
-### Using default.nix in Secret Directories
-
-Alternatively, create a `default.nix` file in the secret directory to configure all secrets in that directory:
-
-```nix
-# secrets/global/default.nix
-{
-  "example" = {
-    mode = "0440";        # Custom file mode (default: "0400")
-    owner = "nginx";      # Custom owner (default: "root")
-    group = "nginx";      # Custom group (default: "root")
-    path = "/run/secrets/example";  # Custom path (default: /run/agenix/{name})
-  };
-  
-  "api-key" = {
-    mode = "0400";
-    owner = "myservice";
-    group = "myservice";
-  };
-}
-```
-
-The `default.nix` file should return an attribute set where:
-- **Keys** are secret names (without the `.age` extension)
-- **Values** are configuration objects with optional fields:
-  - `mode` - File permissions (string, e.g., `"0440"`)
-  - `owner` - File owner (string, e.g., `"nginx"`)
-  - `group` - File group (string, e.g., `"nginx"`)
-  - `path` - Custom installation path (string, e.g., `"/custom/path"`)
-  
-Secrets not listed in `default.nix` will use default settings.
-
-## Security Best Practices
-
-1. **Never commit unencrypted secrets** - Only `.age` and `.pub` files belong in this directory
-2. **Use host-specific secrets** when possible - Limit exposure by using hostname directories
-3. **Rotate secrets regularly** - Re-encrypt with new keys periodically
-4. **Backup age identity keys** - Store `/etc/age/identity.key` securely offline
-5. **Use SSH keys** - Leverage existing SSH host keys for age encryption when possible
-6. **Pin to commits** - When using external secrets modules, always use `rev = "commit-hash"`
-
-## Converting SSH Keys to Age Format
-
-```bash
-# Convert SSH public key to age public key
-nix shell nixpkgs#ssh-to-age -c ssh-to-age < secrets/nix-builder/ssh_host_ed25519_key.pub
-
-# Convert SSH private key to age identity (for editing secrets)
-nix shell nixpkgs#ssh-to-age -c ssh-to-age -private-key -i ~/.ssh/id_ed25519
-```
-
-## Disabling Automatic Secrets
-
-To disable automatic secret loading:
-
-```nix
-# In inventory.nix or host config
-athenix.sw.secrets.enable = false;
-```
-
-## Troubleshooting
-
-### Secret not found
-- Ensure the `.age` file exists in `secrets/global/` or `secrets/{hostname}/`
-- Check `hostname` matches directory name: `echo $HOSTNAME` on the target system
-- Run `nix flake check` to verify secrets are discovered
-
-### Permission denied
-- Verify secret permissions in `/run/agenix/`
-- Check if custom permissions are needed (use `extraSecrets`)
-- Ensure the service user/group has access to the secret file
-
-### Age decrypt failed
-- Verify the host's age identity exists: `ls -l /etc/age/identity.key`
-- Check that the secret was encrypted with the host's public key
-- Confirm SSH host key hasn't changed (would change derived age key)
-
-## References
-
-- [ragenix GitHub](https://github.com/yaxitech/ragenix)
-- [agenix upstream](https://github.com/ryantm/agenix)
-- [age encryption tool](https://age-encryption.org/)

secrets/admins/temp-admin.age.pub

@@ -1 +0,0 @@
-age14emzyraytqzmre58c452t07rtcj87cwqwmd9z3gj7upugtxk8s3sda5tju

secrets/create-secret.sh

@@ -1,121 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# Create a new age-encrypted secret with auto-determined recipients
-# Usage: ./create-secret.sh <path> [content]
-#   path: relative to secrets/ (e.g., "usda-dash/my-secret.age" or "global/shared.age")
-#   content: stdin if not provided
-
-SECRETS_DIR="$(cd "$(dirname "$0")" && pwd)"
-
-if [ $# -lt 1 ]; then
-    echo "Usage: $0 <path> [content]" >&2
-    echo "Examples:" >&2
-    echo "  $0 usda-dash/database-url.age <<< 'postgresql://...'" >&2
-    echo "  $0 global/api-key.age < secret-file.txt" >&2
-    echo "  echo 'secret' | $0 nix-builder/token.age" >&2
-    exit 1
-fi
-
-SECRET_PATH="$1"
-shift
-
-# Extract directory from path (e.g., "usda-dash/file.age" -> "usda-dash")
-SECRET_DIR="$(dirname "$SECRET_PATH")"
-SECRET_FILE="$(basename "$SECRET_PATH")"
-
-# Ensure .age extension
-if [[ ! "$SECRET_FILE" =~ \.age$ ]]; then
-    echo "Error: Secret file must have .age extension" >&2
-    exit 1
-fi
-
-TARGET_FILE="$SECRETS_DIR/$SECRET_PATH"
-
-# Ensure target directory exists
-mkdir -p "$(dirname "$TARGET_FILE")"
-
-# Collect recipient keys
-RECIPIENTS=()
-
-if [ "$SECRET_DIR" = "global" ]; then
-    echo "Creating global secret (encrypted for all hosts + admins)..." >&2
-    
-    # Add all host keys
-    for host_dir in "$SECRETS_DIR"/*/; do
-        host_name="$(basename "$host_dir")"
-        # Skip non-host directories
-        if [ "$host_name" = "admins" ] || [ "$host_name" = "global" ]; then
-            continue
-        fi
-        
-        # Add all .age.pub files from this host
-        while IFS= read -r -d '' key_file; do
-            RECIPIENTS+=("$key_file")
-        done < <(find "$host_dir" -maxdepth 1 -name "*.age.pub" -print0)
-    done
-    
-    # Add global keys
-    while IFS= read -r -d '' key_file; do
-        RECIPIENTS+=("$key_file")
-    done < <(find "$SECRETS_DIR/global" -maxdepth 1 -name "*.age.pub" -print0 2>/dev/null || true)
-    
-else
-    echo "Creating host-specific secret for $SECRET_DIR..." >&2
-    
-    # Check if host directory exists
-    if [ ! -d "$SECRETS_DIR/$SECRET_DIR" ]; then
-        echo "Error: Host directory $SECRET_DIR does not exist" >&2
-        echo "Create it first: mkdir -p secrets/$SECRET_DIR" >&2
-        exit 1
-    fi
-    
-    # Add this host's keys
-    while IFS= read -r -d '' key_file; do
-        RECIPIENTS+=("$key_file")
-    done < <(find "$SECRETS_DIR/$SECRET_DIR" -maxdepth 1 -name "*.age.pub" -print0)
-    
-    # Add global keys (so global hosts can also decrypt)
-    while IFS= read -r -d '' key_file; do
-        RECIPIENTS+=("$key_file")
-    done < <(find "$SECRETS_DIR/global" -maxdepth 1 -name "*.age.pub" -print0 2>/dev/null || true)
-fi
-
-# Add admin keys (for editing from workstations)
-if [ -d "$SECRETS_DIR/admins" ]; then
-    while IFS= read -r -d '' key_file; do
-        RECIPIENTS+=("$key_file")
-    done < <(find "$SECRETS_DIR/admins" -maxdepth 1 -name "*.age.pub" -print0 2>/dev/null || true)
-fi
-
-# Check if we have any recipients
-if [ ${#RECIPIENTS[@]} -eq 0 ]; then
-    echo "Error: No recipient keys found!" >&2
-    echo "Run ./update-age-keys.sh first to generate .age.pub files" >&2
-    exit 1
-fi
-
-echo "Found ${#RECIPIENTS[@]} recipient key(s):" >&2
-for key in "${RECIPIENTS[@]}"; do
-    echo "  - $(basename "$key")" >&2
-done
-
-# Create recipient list file (temporary)
-RECIPIENT_LIST=$(mktemp)
-trap "rm -f $RECIPIENT_LIST" EXIT
-
-for key in "${RECIPIENTS[@]}"; do
-    cat "$key" >> "$RECIPIENT_LIST"
-done
-
-# Encrypt the secret
-if [ $# -gt 0 ]; then
-    # Content provided as argument
-    echo "$@" | age -R "$RECIPIENT_LIST" -o "$TARGET_FILE"
-else
-    # Content from stdin
-    age -R "$RECIPIENT_LIST" -o "$TARGET_FILE"
-fi
-
-echo "✓ Created $TARGET_FILE" >&2
-echo "  Edit with: ragenix -e secrets/$SECRET_PATH" >&2

secrets/global/hunter_halloran_key.age.pub

@@ -1 +0,0 @@
-age1udmpqkedupd33gyut85ud3nvppydzeg04kkuneymkvxcjjej244s4v8xjc

secrets/nix-builder/default.nix

@@ -1,10 +0,0 @@
-# Host-specific secret configuration for nix-builder
-{
-  # SSH host key should be readable by sshd
-  ssh_host_ed25519_key = {
-    mode = "0600";
-    owner = "root";
-    group = "root";
-    path = "/etc/ssh/ssh_host_ed25519_key";
-  };
-}

secrets/nix-builder/ssh_host_ed25519_key.age.pub

@@ -1 +0,0 @@
-age1u5tczg2sx90n03uuz9h549f4h3h7sq5uehhqpampzs7vj8ew7y6s2mjwz0

secrets/secrets.nix

@@ -1,176 +0,0 @@
-# ============================================================================
-# Agenix Secret Recipients Configuration (Auto-Generated)
-# ============================================================================
-# This file automatically discovers hosts and their public keys from the
-# secrets/ directory structure and generates recipient configurations.
-#
-# Directory structure:
-#   secrets/{hostname}/*.pub  -> SSH/age public keys for that host
-#   secrets/global/*.pub      -> Keys accessible to all hosts
-#
-# Usage:
-#   ragenix -e secrets/global/example.age     # Edit/create secret
-#   ragenix -r                                # Re-key all secrets
-#
-# To add admin keys for editing secrets, create secrets/admins/*.pub files
-# with your personal age public keys (generated with: age-keygen)
-
-let
-  lib = builtins;
-
-  # Helper functions not in builtins
-  filterAttrs =
-    pred: set:
-    lib.listToAttrs (
-      lib.filter (item: pred item.name item.value) (
-        lib.map (name: {
-          inherit name;
-          value = set.${name};
-        }) (lib.attrNames set)
-      )
-    );
-
-  concatLists = lists: lib.foldl' (acc: list: acc ++ list) [ ] lists;
-
-  unique =
-    list:
-    let
-      go =
-        acc: remaining:
-        if remaining == [ ] then
-          acc
-        else if lib.elem (lib.head remaining) acc then
-          go acc (lib.tail remaining)
-        else
-          go (acc ++ [ (lib.head remaining) ]) (lib.tail remaining);
-    in
-    go [ ] list;
-
-  hasSuffix =
-    suffix: str:
-    let
-      lenStr = lib.stringLength str;
-      lenSuffix = lib.stringLength suffix;
-    in
-    lenStr >= lenSuffix && lib.substring (lenStr - lenSuffix) lenSuffix str == suffix;
-
-  nameValuePair = name: value: { inherit name value; };
-
-  secretsPath = ./secrets;
-
-  # Read all directories in secrets/
-  secretDirs = if lib.pathExists secretsPath then lib.readDir secretsPath else { };
-
-  # Filter to only directories (excludes files)
-  isDirectory = name: type: type == "directory";
-  directories = lib.filter (name: isDirectory name secretDirs.${name}) (lib.attrNames secretDirs);
-
-  # Read public keys from a directory and convert to age format
-  readHostKeys =
-    dirName:
-    let
-      dirPath = secretsPath + "/${dirName}";
-      files = if lib.pathExists dirPath then lib.readDir dirPath else { };
-
-      # Prefer .age.pub files (pre-converted), fall back to .pub files
-      agePubFiles = filterAttrs (name: type: type == "regular" && hasSuffix ".age.pub" name) files;
-
-      sshPubFiles = filterAttrs (
-        name: type: type == "regular" && hasSuffix ".pub" name && !(hasSuffix ".age.pub" name)
-      ) files;
-
-      # Read age public keys (already in correct format)
-      ageKeys = lib.map (
-        name:
-        let
-          content = lib.readFile (dirPath + "/${name}");
-          # Trim whitespace/newlines
-          trimmed = lib.replaceStrings [ "\n" " " "\r" "\t" ] [ "" "" "" "" ] content;
-        in
-        trimmed
-      ) (lib.attrNames agePubFiles);
-
-      # For SSH keys, just include them as-is (user needs to convert with ssh-to-age)
-      # Or they can run the update-age-keys.sh script
-      sshKeys =
-        if (lib.length (lib.attrNames sshPubFiles)) > 0 then
-          lib.trace "Warning: ${dirName} has unconverted SSH keys. Run secrets/update-age-keys.sh" [ ]
-        else
-          [ ];
-    in
-    lib.filter (k: k != null && k != "") (ageKeys ++ sshKeys);
-
-  # Build host key mappings: { hostname = [ "age1..." "age2..." ]; }
-  hostKeys = lib.listToAttrs (
-    lib.map (dir: nameValuePair dir (readHostKeys dir)) (
-      lib.filter (d: d != "global" && d != "admins") directories
-    )
-  );
-
-  # Global keys that all hosts can use
-  globalKeys = if lib.elem "global" directories then readHostKeys "global" else [ ];
-
-  # Admin keys for editing secrets
-  adminKeys = if lib.elem "admins" directories then readHostKeys "admins" else [ ];
-
-  # All host keys combined
-  allHostKeys = concatLists (lib.attrValues hostKeys);
-
-  # Find all .age files in the secrets directory
-  findSecrets =
-    dir:
-    let
-      dirPath = secretsPath + "/${dir}";
-      files = if lib.pathExists dirPath then lib.readDir dirPath else { };
-      ageFiles = filterAttrs (name: type: type == "regular" && hasSuffix ".age" name) files;
-    in
-    lib.map (name: "secrets/${dir}/${name}") (lib.attrNames ageFiles);
-
-  # Generate recipient list for a secret based on its location
-  getRecipients =
-    secretPath:
-    let
-      # Extract directory name from path: "secrets/nix-builder/foo.age" -> "nix-builder"
-      pathParts = lib.split "/" secretPath;
-      dirName = lib.elemAt pathParts 2;
-    in
-    if dirName == "global" then
-      # Global secrets: all hosts + admins
-      allHostKeys ++ globalKeys ++ adminKeys
-    else if hostKeys ? ${dirName} then
-      # Host-specific secrets: that host + global keys + admins
-      hostKeys.${dirName} ++ globalKeys ++ adminKeys
-    else
-      # Fallback: just admins
-      adminKeys;
-
-  # Find all secrets across all directories
-  allSecrets = concatLists (lib.map findSecrets directories);
-
-  # Generate the configuration
-  secretsConfig = lib.listToAttrs (
-    lib.map (
-      secretPath:
-      let
-        recipients = getRecipients secretPath;
-        # Remove duplicates and empty keys
-        uniqueRecipients = unique (lib.filter (k: k != null && k != "") recipients);
-      in
-      nameValuePair secretPath {
-        publicKeys = uniqueRecipients;
-      }
-    ) allSecrets
-  );
-
-in
-secretsConfig
-// {
-  # Export helper information for debugging
-  _meta = {
-    hostKeys = hostKeys;
-    globalKeys = globalKeys;
-    adminKeys = adminKeys;
-    allHostKeys = allHostKeys;
-    discoveredSecrets = allSecrets;
-  };
-}

secrets/update-age-keys.sh

@@ -1,36 +0,0 @@
-#!/usr/bin/env bash
-# ============================================================================
-# Update Age Keys from SSH Public Keys
-# ============================================================================
-# This script converts SSH public keys to age format for use with ragenix.
-# Run this after adding new SSH .pub files to create corresponding .age.pub files.
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-cd "$SCRIPT_DIR"
-
-echo "Converting SSH public keys to age format..."
-
-# Find all .pub files that are SSH keys (not already .age.pub)
-find . -name "*.pub" -not -name "*.age.pub" -type f | while read -r pubkey; do
-    # Check if it's an SSH key
-    if grep -q "^ssh-" "$pubkey" 2>/dev/null || grep -q "^ecdsa-" "$pubkey" 2>/dev/null; then
-        age_key=$(nix shell nixpkgs#ssh-to-age -c ssh-to-age < "$pubkey" 2>/dev/null || true)
-        
-        if [ -n "$age_key" ]; then
-            # Create .age.pub file with the age key
-            age_file="${pubkey%.pub}.age.pub"
-            echo "$age_key" > "$age_file"
-            echo "✓ Converted: $pubkey -> $age_file"
-        else
-            echo "⚠ Skipped: $pubkey (conversion failed)"
-        fi
-    fi
-done
-
-echo ""
-echo "Done! Age public keys have been generated."
-echo "You can now use ragenix to manage secrets:"
-echo "  ragenix -e secrets/global/my-secret.age"
-echo "  ragenix -r  # Re-key all secrets with updated keys"

secrets/usda-dash/default.nix

@@ -1,8 +0,0 @@
-# Host-specific secret configuration for usda-dash
-{
-  usda-vision-azure-env = {
-    mode = "0600";
-    owner = "root";
-    group = "root";
-  };
-}

secrets/usda-dash/ssh_host_ed25519_key.age.pub

@@ -1 +0,0 @@
-age1lr24yvk7rdfh5wkle7h32jpxqxm2e8vk85mc4plv370u2sh4yfmszaaejx

secrets/usda-dash/ssh_host_ed25519_key.pub

@@ -1 +0,0 @@
-ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIHI73LOEK2RgfjhZWpryntlLbx0LouHrhQ6v0vZu4Etr root@usda-dash

sw/builders/default.nix

@@ -11,108 +11,7 @@
   ...
 }:
 
-with lib;
+lib.mkMerge [
-
-let
-  cfg = config.athenix.sw.builders;
-in
-{
-  options.athenix.sw.builders = mkOption {
-    type = lib.types.submodule {
-      options = {
-        enable = mkOption {
-          type = lib.types.bool;
-          default = false;
-          description = ''
-            Enable build server configuration.
-
-            Includes:
-            - SSH host keys for common Git servers (factory.uga.edu, github.com)
-            - Gitea Actions runner support (optional)
-            - Build tools and dependencies
-
-            Recommended for: CI/CD servers, build containers, development infrastructure
-          '';
-          example = true;
-        };
-
-        giteaRunner = mkOption {
-          type = lib.types.submodule {
-            options = {
-              enable = mkOption {
-                type = lib.types.bool;
-                default = false;
-                description = ''
-                  Enable Gitea Actions self-hosted runner.
-
-                  This runner will connect to a Gitea instance and execute CI/CD workflows.
-                  Requires manual setup of the token file before the service will start.
-                '';
-                example = true;
-              };
-
-              url = mkOption {
-                type = lib.types.str;
-                description = ''
-                  URL of the Gitea instance to connect to.
-                  This should be the base URL without any path components.
-                '';
-                example = "https://git.factory.uga.edu";
-              };
-
-              tokenFile = mkOption {
-                type = lib.types.path;
-                default = "/var/lib/gitea-runner-token";
-                description = ''
-                  Path to file containing Gitea runner registration token.
-
-                  To generate:
-                  1. Go to your Gitea repository settings
-                  2. Navigate to Actions > Runners
-                  3. Click "Create new Runner"
-                  4. Save the token to this file:
-                     echo "TOKEN=your-token-here" | sudo tee /var/lib/gitea-runner-token > /dev/null
-
-                  The service will not start until this file exists.
-                '';
-                example = "/var/secrets/gitea-runner-token";
-              };
-
-              extraLabels = mkOption {
-                type = lib.types.listOf lib.types.str;
-                default = [ ];
-                description = ''
-                  Additional labels to identify this runner in workflow files.
-                  Use labels to target specific runners for different job types.
-                '';
-                example = [
-                  "self-hosted"
-                  "nix"
-                  "x86_64-linux"
-                ];
-              };
-
-              name = mkOption {
-                type = lib.types.str;
-                default = "athenix";
-                description = ''
-                  Unique name for this runner instance.
-                  Shown in Gitea's runner list and logs.
-                '';
-                example = "nix-builder-1";
-              };
-            };
-          };
-          default = { };
-          description = "Gitea Actions runner configuration.";
-        };
-      };
-    };
-    default = { };
-    description = "Build server configuration (CI/CD, Gitea Actions).";
-  };
-
-  config = mkIf cfg.enable (mkMerge [
   (import ./programs.nix {
     inherit
       config
@@ -129,5 +28,4 @@ in
       inputs
       ;
   })
-  ]);
+]
-}

sw/builders/programs.nix

@@ -1,6 +1,8 @@
 {
   config,
   lib,
+  pkgs,
+  inputs,
   ...
 }:
 
@@ -8,7 +10,7 @@ with lib;
 
 let
   cfg = config.athenix.sw;
-  basePackages = [
+  basePackages = with pkgs; [
     # Build-related packages can be added here if needed
   ];
 in

sw/default.nix

@@ -10,79 +10,115 @@
 # Software Module Entry Point
 # ============================================================================
 # This module manages the software configuration for the system. It provides
-# enable options for each system type (desktop, headless, builders, etc.)
+# options to select the system type ('desktop' or 'kiosk') and handles
-# that can be enabled independently or in combination. Each type is a proper
+# the conditional importation of the appropriate sub-modules.
-# NixOS submodule with its own enable flag and type-specific options.
 
 with lib;
 
 let
   cfg = config.athenix.sw;
+
+  # Normalize type to always be a list
+  swTypes = if isList cfg.type then cfg.type else [ cfg.type ];
+
+  # Helper to check if a type is enabled
+  hasType = type: elem type swTypes;
 in
 {
   imports = [
     ./python.nix
     ./ghostty.nix
-    ./gc.nix
     ./updater.nix
     ./update-ref.nix
-    ./secrets.nix
-    ./desktop
-    ./headless
-    ./builders
-    ./tablet-kiosk
-    ./stateless-kiosk
-    inputs.home-manager.nixosModules.home-manager
-    inputs.agenix.nixosModules.default
-    inputs.disko.nixosModules.disko
   ];
 
   options.athenix.sw = {
-    enable = mkOption {
+    enable = mkEnableOption "Standard Workstation Configuration";
-      type = lib.types.bool;
-      default = true;
-      description = ''
-        Enable standard workstation configuration with base packages.
-
-        Provides:
-        - Base CLI tools (htop, git, binutils)
-        - Shell configuration (Zsh)
-        - Secret management (agenix)
-        - Oh My Posh shell theme
-
-        This is typically enabled automatically when any sw type is enabled.
-      '';
-    };
 
     type = mkOption {
-      type = lib.types.nullOr (lib.types.either lib.types.str (lib.types.listOf lib.types.str));
+      type = types.oneOf [
-      default = null;
+        (types.enum [
-      description = "DEPRECATED: Use athenix.sw.<type>.enable instead. Legacy type selection.";
+          "desktop"
-      visible = false;
+          "tablet-kiosk"
+          "headless"
+          "stateless-kiosk"
+          "builders"
+        ])
+        (types.listOf (
+          types.enum [
+            "desktop"
+            "tablet-kiosk"
+            "headless"
+            "stateless-kiosk"
+            "builders"
+          ]
+        ))
+      ];
+      default = "desktop";
+      description = "Type(s) of system configuration. Can be a single type or a list of types to combine multiple configurations.";
     };
 
     extraPackages = mkOption {
-      type = lib.types.listOf lib.types.package;
+      type = types.listOf types.package;
       default = [ ];
-      description = ''
+      description = "Extra packages to install.";
-        Additional system packages to install beyond the defaults.
-        These packages are added to environment.systemPackages.
-      '';
-      example = lib.literalExpression "[ pkgs.vim pkgs.wget pkgs.curl ]";
     };
 
     excludePackages = mkOption {
-      type = lib.types.listOf lib.types.package;
+      type = types.listOf types.package;
       default = [ ];
+      description = "Packages to exclude from the default list.";
+    };
+
+    kioskUrl = mkOption {
+      type = types.str;
+      default = "https://ha.factory.uga.edu";
+      description = "URL to open in Chromium kiosk mode.";
+    };
+
+    # Builders-specific options
+    builders = mkOption {
+      type = types.submodule {
+        options = {
+          giteaRunner = {
+            enable = mkEnableOption "Gitea Actions self-hosted runner";
+
+            url = mkOption {
+              type = types.str;
+              description = "Gitea instance URL for the runner";
+            };
+
+            tokenFile = mkOption {
+              type = types.path;
+              default = "/var/lib/gitea-runner-token";
               description = ''
-        Packages to exclude from the default package list.
+                Path to file containing Gitea runner token.
-        Useful for removing unwanted default packages.
+                Generate in Gitea repository settings under Actions > Runners.
+                The token must have runner registration access.
               '';
-      example = lib.literalExpression "[ pkgs.htop ]";
+            };
+
+            extraLabels = mkOption {
+              type = types.listOf types.str;
+              default = [ ];
+              description = "Extra labels to identify this runner in workflows";
+            };
+
+            name = mkOption {
+              type = types.str;
+              default = "athenix";
+              description = "Name of the Gitea runner service";
+            };
+          };
+        };
+      };
+      default = { };
+      description = "Builder-specific configuration options";
     };
   };
 
-  config = mkIf cfg.enable {
+  config = mkIf cfg.enable (mkMerge [
+    {
       # ========== System-Wide Configuration ==========
       nixpkgs.config.allowUnfree = true;
 
@@ -99,9 +135,59 @@ in
           zsh # Z shell
           git # Version control
           oh-my-posh # Shell prompt theme
-        age # Simple file encryption tool
-        age-plugin-fido2-hmac # age FIDO2 support
           inputs.agenix.packages.${stdenv.hostPlatform.system}.default # Secret management
         ];
-  };
+    }
+    # ========== Software Profile Imports ==========
+    (mkIf (hasType "desktop") (
+      import ./desktop {
+        inherit
+          config
+          lib
+          pkgs
+          inputs
+          ;
+      }
+    ))
+    (mkIf (hasType "tablet-kiosk") (
+      import ./tablet-kiosk {
+        inherit
+          config
+          lib
+          pkgs
+          inputs
+          ;
+      }
+    ))
+    (mkIf (hasType "headless") (
+      import ./headless {
+        inherit
+          config
+          lib
+          pkgs
+          inputs
+          ;
+      }
+    ))
+    (mkIf (hasType "stateless-kiosk") (
+      import ./stateless-kiosk {
+        inherit
+          config
+          lib
+          pkgs
+          inputs
+          ;
+      }
+    ))
+    (mkIf (hasType "builders") (
+      import ./builders {
+        inherit
+          config
+          lib
+          pkgs
+          inputs
+          ;
+      }
+    ))
+  ]);
 }

sw/desktop/default.nix

@@ -10,41 +10,7 @@
   inputs,
   ...
 }:
-
+lib.mkMerge [
-with lib;
-
-let
-  cfg = config.athenix.sw.desktop;
-in
-{
-  options.athenix.sw.desktop = mkOption {
-    type = lib.types.submodule {
-      options = {
-        enable = mkOption {
-          type = lib.types.bool;
-          default = false;
-          description = ''
-            Enable full desktop environment with KDE Plasma 6.
-
-            Includes:
-            - KDE Plasma 6 desktop with SDDM display manager
-            - Full graphical software suite (Firefox, Chromium, LibreOffice)
-            - Printing and scanning support (CUPS)
-            - Virtualization (libvirt, virt-manager)
-            - Bluetooth and audio (PipeWire)
-            - Video conferencing (Zoom, Teams)
-
-            Recommended for: Workstations, development machines, user desktops
-          '';
-          example = true;
-        };
-      };
-    };
-    default = { };
-    description = "Desktop environment configuration (KDE Plasma 6).";
-  };
-
-  config = mkIf cfg.enable (mkMerge [
   (import ./programs.nix {
     inherit
       config
@@ -61,5 +27,4 @@ in
       inputs
       ;
   })
-  ]);
+]
-}

sw/desktop/programs.nix

@@ -2,6 +2,7 @@
   config,
   lib,
   pkgs,
+  inputs,
   ...
 }:
 

sw/desktop/services.nix

@@ -1,4 +1,5 @@
 {
+  config,
   lib,
   pkgs,
   ...

sw/gc.nix

@@ -1,75 +0,0 @@
-{
-  config,
-  lib,
-  ...
-}:
-{
-  options.athenix = {
-    system.gc = {
-      enable = lib.mkOption {
-        type = lib.types.bool;
-        default = true;
-        description = ''
-          Enable automatic garbage collection of old NixOS generations.
-          Helps keep disk usage under control on long-running systems.
-        '';
-      };
-      frequency = lib.mkOption {
-        type = lib.types.str;
-        default = "weekly";
-        description = ''
-          How often to run garbage collection (systemd timer format).
-
-          Common values: "daily", "weekly", "monthly"
-          Advanced: "*-*-* 03:00:00" (daily at 3 AM)
-        '';
-        example = "daily";
-      };
-      retentionDays = lib.mkOption {
-        type = lib.types.int;
-        default = 30;
-        description = ''
-          Number of days to keep old system generations before deletion.
-
-          Older generations allow rolling back system changes.
-          Recommended: 30-90 days for workstations, 7-14 for servers.
-        '';
-        example = 60;
-      };
-      optimise = lib.mkOption {
-        type = lib.types.bool;
-        default = true;
-        description = ''
-          Whether to automatically hard-link identical files in the Nix store.
-          Can save significant disk space but uses CPU during optimization.
-        '';
-      };
-    };
-
-    host.buildMethods = lib.mkOption {
-      type = lib.types.listOf lib.types.str;
-      default = [ "installer-iso" ];
-      description = ''
-        List of allowed build methods for this host (used by installer/artifacts.nix).
-        Supported methods:
-        - "installer-iso": Generates an auto-install ISO that installs this configuration to disk.
-        - "iso": Generates a live ISO (using nixos-generators).
-        - "ipxe": Generates iPXE netboot artifacts (kernel, initrd, script).
-        - "lxc": Generates an LXC container tarball.
-        - "proxmox": Generates a Proxmox VMA archive.
-      '';
-    };
-  };
-
-  config = {
-    # Automatic Garbage Collection
-    nix.gc = lib.mkIf config.athenix.system.gc.enable {
-      automatic = true;
-      dates = config.athenix.system.gc.frequency;
-      options = "--delete-older-than ${toString config.athenix.system.gc.retentionDays}d";
-    };
-
-    # Optimize storage
-    nix.optimise.automatic = config.athenix.system.gc.optimise;
-  };
-}

sw/ghostty.nix

@@ -12,11 +12,7 @@
 # It reconstructs the terminfo database from the provided definition and
 # adds it to the system packages.
 
-with lib;
-
 let
-  cfg = config.athenix.sw;
-
   ghostty-terminfo = pkgs.runCommand "ghostty-terminfo" { } ''
     mkdir -p $out/share/terminfo
     cat > ghostty.info <<'EOF'
@@ -105,7 +101,5 @@ let
   '';
 in
 {
-  config = mkIf cfg.enable {
   environment.systemPackages = [ ghostty-terminfo ];
-  };
 }

sw/headless/default.nix

@@ -11,38 +11,7 @@
   ...
 }:
 
-with lib;
+lib.mkMerge [
-
-let
-  cfg = config.athenix.sw.headless;
-in
-{
-  options.athenix.sw.headless = mkOption {
-    type = lib.types.submodule {
-      options = {
-        enable = mkOption {
-          type = lib.types.bool;
-          default = false;
-          description = ''
-            Enable minimal headless server configuration.
-
-            Includes:
-            - SSH server with password authentication
-            - Minimal CLI tools (tmux, man)
-            - Systemd-networkd for networking
-            - No graphical environment
-
-            Recommended for: Servers, containers (LXC), WSL, remote systems
-          '';
-          example = true;
-        };
-      };
-    };
-    default = { };
-    description = "Headless server configuration (SSH, minimal CLI tools).";
-  };
-
-  config = mkIf cfg.enable (mkMerge [
   (import ./programs.nix {
     inherit
       config
@@ -59,5 +28,4 @@ in
       inputs
       ;
   })
-  ]);
+]
-}

sw/headless/programs.nix

@@ -2,6 +2,7 @@
   config,
   lib,
   pkgs,
+  inputs,
   ...
 }:
 

sw/headless/services.nix

@@ -1,4 +1,7 @@
 {
+  config,
+  lib,
+  pkgs,
   ...
 }:
 

sw/python.nix

@@ -18,28 +18,11 @@ let
   cfg = config.athenix.sw.python;
 in
 {
-  options.athenix.sw.python = lib.mkOption {
+  options.athenix.sw.python = {
-    type = lib.types.submodule {
+    enable = mkEnableOption "Python development tools (pixi, uv)" // {
-      options = {
-        enable = lib.mkOption {
-          type = lib.types.bool;
       default = true;
-          description = ''
-            Enable Python development tools (pixi, uv).
-
-            Provides:
-            - pixi: Fast, cross-platform package manager for Python
-            - uv: Extremely fast Python package installer and resolver
-
-            These tools manage project-based dependencies rather than global
-            Python packages, avoiding conflicts and improving reproducibility.
-          '';
     };
   };
-    };
-    default = { };
-    description = "Python development environment configuration.";
-  };
 
   config = mkIf cfg.enable {
     environment.systemPackages = [

sw/secrets.nix

@@ -1,230 +0,0 @@
-# ============================================================================
-# Automatic Secret Management with Agenix
-# ============================================================================
-# This module automatically loads age-encrypted secrets from ./secrets based on
-# the hostname. Secrets are organized by directory:
-#   - ./secrets/global/          -> Installed on ALL systems
-#   - ./secrets/{hostname}/      -> Installed only on matching host
-#
-# Secret files should be .age encrypted files. Public keys (.pub) are ignored.
-
-{
-  config,
-  lib,
-  pkgs,
-  ...
-}:
-
-with lib;
-
-let
-  cfg = config.athenix.sw;
-  secretsPath = ../secrets;
-
-  # Get the fleet-assigned hostname (avoids issues with LXC empty hostnames)
-  hostname = config.athenix.host.name;
-
-  # Read all directories in ./secrets
-  secretDirs = if builtins.pathExists secretsPath then builtins.readDir secretsPath else { };
-
-  # Filter to only directories (excludes files)
-  isDirectory = name: type: type == "directory";
-  directories = lib.filterAttrs isDirectory secretDirs;
-
-  # Read secrets from a specific directory
-  readSecretsFromDir =
-    dirName:
-    let
-      dirPath = secretsPath + "/${dirName}";
-      files = builtins.readDir dirPath;
-
-      # Check if there's a default.nix with custom secret configurations
-      hasDefaultNix = files ? "default.nix";
-      customConfigs = if hasDefaultNix then import (dirPath + "/default.nix") else { };
-
-      # Only include .age files (exclude .pub public keys and other files)
-      secretFiles = lib.filterAttrs (name: type: type == "regular" && lib.hasSuffix ".age" name) files;
-    in
-    lib.mapAttrs' (
-      name: _:
-      let
-        # Remove .age extension for the secret name
-        secretName = lib.removeSuffix ".age" name;
-
-        # Get custom config for this secret if defined
-        customConfig = customConfigs.${secretName} or { };
-
-        # Base configuration with file path
-        baseConfig = {
-          file = dirPath + "/${name}";
-        };
-      in
-      lib.nameValuePair secretName (baseConfig // customConfig)
-    ) secretFiles;
-
-  # Read public keys from a specific directory and map to private key paths
-  readIdentityPathsFromDir =
-    dirName:
-    let
-      dirPath = secretsPath + "/${dirName}";
-      files = if builtins.pathExists dirPath then builtins.readDir dirPath else { };
-      # Only include .pub public key files
-      pubKeyFiles = lib.filterAttrs (name: type: type == "regular" && lib.hasSuffix ".pub" name) files;
-    in
-    lib.mapAttrsToList (
-      name: _:
-      let
-        # Map public key filename to expected private key location
-        baseName = lib.removeSuffix ".pub" name;
-        filePath = dirPath + "/${name}";
-        fileContent = builtins.readFile filePath;
-        # Check if it's an SSH key by looking at the content
-        isSSHKey = lib.hasPrefix "ssh-" fileContent || lib.hasPrefix "ecdsa-" fileContent;
-      in
-      if lib.hasPrefix "ssh_host_" name then
-        # SSH host keys: ssh_host_ed25519_key.pub -> /etc/ssh/ssh_host_ed25519_key
-        "/etc/ssh/${baseName}"
-      else if name == "identity.pub" then
-        # Standard age identity: identity.pub -> /etc/age/identity.key
-        "/etc/age/identity.key"
-      else if isSSHKey then
-        # Other SSH keys (user keys, etc.): hunter_halloran_key.pub -> /etc/ssh/hunter_halloran_key
-        "/etc/ssh/${baseName}"
-      else
-        # Generic age keys: key.pub -> /etc/age/key
-        "/etc/age/${baseName}"
-    ) pubKeyFiles;
-
-  # Determine which secrets apply to this host
-  applicableSecrets =
-    let
-      # Global secrets apply to all hosts
-      globalSecrets = if directories ? "global" then readSecretsFromDir "global" else { };
-
-      # Host-specific secrets
-      hostSecrets = if directories ? ${hostname} then readSecretsFromDir hostname else { };
-    in
-    globalSecrets // hostSecrets; # Host-specific secrets override global if same name
-
-  # Determine which identity paths (private keys) to use for decryption
-  identityPaths =
-    let
-      # Global identity paths (keys in global/ that all hosts can use)
-      globalPaths = if directories ? "global" then readIdentityPathsFromDir "global" else [ ];
-
-      # Host-specific identity paths
-      hostPaths = if directories ? ${hostname} then readIdentityPathsFromDir hostname else [ ];
-
-      # Default paths that NixOS/agenix use
-      defaultPaths = [
-        "/etc/ssh/ssh_host_rsa_key"
-        "/etc/ssh/ssh_host_ed25519_key"
-        "/etc/age/identity.key"
-      ];
-
-      # Combine all paths and remove duplicates
-      allPaths = lib.unique (defaultPaths ++ globalPaths ++ hostPaths);
-    in
-    allPaths;
-in
-{
-  options.athenix.sw.secrets = {
-    enable = mkOption {
-      type = types.bool;
-      default = true;
-      description = ''
-        Enable automatic secret management using agenix.
-
-        Secrets are loaded from ./secrets based on directory structure:
-        - ./secrets/global/       -> All systems
-        - ./secrets/{hostname}/   -> Specific host only
-
-        Only .age encrypted files are loaded; .pub files are ignored.
-      '';
-    };
-
-    extraSecrets = mkOption {
-      type = types.attrsOf (
-        types.submodule {
-          options = {
-            file = mkOption {
-              type = types.path;
-              description = "Path to the encrypted secret file";
-            };
-            mode = mkOption {
-              type = types.str;
-              default = "0400";
-              description = "Permissions mode for the decrypted secret";
-            };
-            owner = mkOption {
-              type = types.str;
-              default = "root";
-              description = "Owner of the decrypted secret file";
-            };
-            group = mkOption {
-              type = types.str;
-              default = "root";
-              description = "Group of the decrypted secret file";
-            };
-          };
-        }
-      );
-      default = { };
-      description = ''
-        Additional secrets to define manually, beyond the auto-discovered ones.
-        Use this for secrets that need custom permissions or are stored elsewhere.
-      '';
-      example = lib.literalExpression ''
-        {
-          "my-secret" = {
-            file = ./secrets/custom/secret.age;
-            mode = "0440";
-            owner = "nginx";
-            group = "nginx";
-          };
-        }
-      '';
-    };
-  };
-
-  config = mkIf (cfg.enable && cfg.secrets.enable) {
-    # Auto-discovered secrets with default permissions
-    age.secrets = applicableSecrets // cfg.secrets.extraSecrets;
-
-    # Generate age identity files from SSH host keys at boot
-    # This is needed because age can't reliably use OpenSSH private keys directly
-    # Must run before agenix tries to decrypt secrets
-    system.activationScripts.convertSshToAge = {
-      deps = [
-        "users"
-        "groups"
-      ];
-      text = ''
-        mkdir -p /etc/age
-        if [ -f /etc/ssh/ssh_host_ed25519_key ]; then
-          ${pkgs.ssh-to-age}/bin/ssh-to-age -private-key -i /etc/ssh/ssh_host_ed25519_key > /etc/age/ssh_host_ed25519.age || true
-          chmod 600 /etc/age/ssh_host_ed25519.age 2>/dev/null || true
-        fi
-        if [ -f /etc/ssh/ssh_host_rsa_key ]; then
-          ${pkgs.ssh-to-age}/bin/ssh-to-age -private-key -i /etc/ssh/ssh_host_rsa_key > /etc/age/ssh_host_rsa.age 2>/dev/null || true
-          chmod 600 /etc/age/ssh_host_rsa.age 2>/dev/null || true
-        fi
-      '';
-    };
-
-    # Add the converted age keys to identity paths (in addition to auto-discovered ones)
-    age.identityPaths = identityPaths ++ [
-      "/etc/age/ssh_host_ed25519.age"
-      "/etc/age/ssh_host_rsa.age"
-    ];
-
-    # Optional: Add assertion to warn if no secrets found
-    warnings =
-      let
-        hasSecrets = (builtins.length (builtins.attrNames applicableSecrets)) > 0;
-      in
-      lib.optional (
-        !hasSecrets
-      ) "No age-encrypted secrets found in ./secrets/global/ or ./secrets/${hostname}/";
-  };
-}

sw/stateless-kiosk/default.nix

@@ -7,52 +7,7 @@
   inputs,
   ...
 }:
-
+lib.mkMerge [
-with lib;
-
-let
-  cfg = config.athenix.sw.stateless-kiosk;
-in
-{
-  options.athenix.sw.stateless-kiosk = mkOption {
-    type = lib.types.submodule {
-      options = {
-        enable = mkOption {
-          type = lib.types.bool;
-          default = false;
-          description = ''
-            Enable stateless kiosk mode for diskless PXE boot systems.
-
-            Includes:
-            - Sway (Wayland compositor)
-            - Chromium in fullscreen kiosk mode
-            - MAC address-based URL routing
-            - Network-only boot (no local storage)
-            - Auto-start browser on boot
-
-            Recommended for: Assembly line stations, diskless kiosks, PXE boot displays
-          '';
-          example = true;
-        };
-
-        kioskUrl = mkOption {
-          type = lib.types.str;
-          default = "https://ha.factory.uga.edu";
-          description = ''
-            Default URL to display in the kiosk browser.
-
-            Note: For stateless-kiosk, MAC address-based routing may override this.
-            See sw/stateless-kiosk/mac-hostmap.nix for MAC-to-URL mappings.
-          '';
-          example = "https://homeassistant.lan:8123/lovelace/dashboard";
-        };
-      };
-    };
-    default = { };
-    description = "Stateless kiosk configuration (PXE boot, Sway, MAC-based routing).";
-  };
-
-  config = mkIf cfg.enable (mkMerge [
   (import ./kiosk-browser.nix {
     inherit
       config
@@ -85,5 +40,4 @@ in
       inputs
       ;
   })
-  ]);
+]
-}

sw/stateless-kiosk/kiosk-browser.nix

@@ -1,13 +1,14 @@
 # This module configures Chromium for kiosk mode under Sway.
 # It includes a startup script that determines the kiosk URL based on the machine's MAC address.
 {
+  config,
+  lib,
   pkgs,
-  inputs,
   ...
 }:
 
 let
-  macCaseBuilder = inputs.self.lib.macCaseBuilder;
+  macCaseBuilder = (import ./mac-hostmap.nix { inherit lib; }).macCaseBuilder;
   macCases = macCaseBuilder {
     varName = "STATION";
   };

sw/stateless-kiosk/mac-hostmap.nix

@@ -0,0 +1,28 @@
+# Shared MAC address to station mapping and case builder for stateless-kiosk modules
+{ lib }:
+let
+  hostmap = {
+    "00:e0:4c:46:0b:32" = "1";
+    "00:e0:4c:46:07:26" = "2";
+    "00:e0:4c:46:05:94" = "3";
+    "00:e0:4c:46:07:11" = "4";
+    "00:e0:4c:46:08:02" = "5";
+    "00:e0:4c:46:08:5c" = "6";
+  };
+  # macCaseBuilder: builds a shell case statement from a hostmap
+  # varName: the shell variable to assign
+  # prefix: optional string to prepend to the value (default: "")
+  # attrset: attribute set to use (default: hostmap)
+  macCaseBuilder =
+    {
+      varName,
+      prefix ? "",
+      attrset ? hostmap,
+    }:
+    lib.concatStringsSep "\n" (
+      lib.mapAttrsToList (mac: val: "      ${mac}) ${varName}=${prefix}${val} ;;") attrset
+    );
+in
+{
+  inherit hostmap macCaseBuilder;
+}

sw/stateless-kiosk/net.nix

@@ -26,5 +26,5 @@
   };
 
   # Disable systemd-networkd and systemd-hostnamed
-  systemd.network.enable = lib.mkForce false;
+  systemd.network.enable = false;
 }

sw/stateless-kiosk/programs.nix

@@ -1,4 +1,7 @@
 {
+  config,
+  lib,
+  pkgs,
   ...
 }:
 {

sw/stateless-kiosk/services.nix

@@ -1,10 +1,11 @@
 {
+  config,
+  lib,
   pkgs,
-  inputs,
   ...
 }:
 let
-  macCaseBuilder = inputs.self.lib.macCaseBuilder;
+  macCaseBuilder = (import ./mac-hostmap.nix { inherit lib; }).macCaseBuilder;
   shellCases = macCaseBuilder {
     varName = "NEW_HOST";
     prefix = "nix-station";

sw/tablet-kiosk/default.nix

@@ -5,51 +5,7 @@
   inputs,
   ...
 }:
-
+lib.mkMerge [
-with lib;
-
-let
-  cfg = config.athenix.sw.tablet-kiosk;
-in
-{
-  options.athenix.sw.tablet-kiosk = mkOption {
-    type = lib.types.submodule {
-      options = {
-        enable = mkOption {
-          type = lib.types.bool;
-          default = false;
-          description = ''
-            Enable tablet kiosk mode with touch-optimized interface.
-
-            Includes:
-            - Phosh mobile desktop environment
-            - Chromium in fullscreen kiosk mode
-            - On-screen keyboard (Squeekboard)
-            - Auto-login and auto-start browser
-            - Touch gesture support
-            - Optimized for Surface Pro tablets
-
-            Recommended for: Surface tablets, touchscreen kiosks, interactive displays
-          '';
-          example = true;
-        };
-
-        kioskUrl = mkOption {
-          type = lib.types.str;
-          default = "https://ha.factory.uga.edu";
-          description = ''
-            URL to display in the kiosk browser on startup.
-            The browser will automatically navigate to this URL in fullscreen mode.
-          '';
-          example = "https://dashboard.example.com";
-        };
-      };
-    };
-    default = { };
-    description = "Tablet kiosk configuration (Phosh, touch interface).";
-  };
-
-  config = mkIf cfg.enable (mkMerge [
   (import ./programs.nix {
     inherit
       config
@@ -74,5 +30,4 @@ in
       inputs
       ;
   })
-  ]);
+]
-}

sw/tablet-kiosk/services.nix

@@ -155,7 +155,7 @@
           --noerrdialogs \
           --disable-session-crashed-bubble \
           --disable-infobars \
-          ${config.athenix.sw.tablet-kiosk.kioskUrl}
+          ${config.athenix.sw.kioskUrl}
       '';
     };
   };

sw/theme.nix

@@ -1,6 +1,7 @@
 {
   pkgs,
   config,
+  osConfig,
   lib,
   ...
 }:
@@ -32,18 +33,6 @@ in
     programs.zsh = {
       enable = true;
 
-      initContent = ''
-        bindkey '^[[H' beginning-of-line # Home key
-        bindkey '^[[F' end-of-line       # End key
-        bindkey '^[[3~' delete-char      # Delete key
-        bindkey '^[[1~' beginning-of-line # Alternative Home key
-        bindkey '^[[4~' end-of-line       # Alternative End key
-        bindkey '^[[2~' overwrite-mode    # Insert key
-        bindkey '^[[5~' up-line-or-history   # Page Up
-        bindkey '^[[6~' down-line-or-history # Page Down
-        bindkey -e
-      '';
-
       # Plugins
       historySubstringSearch = {
         enable = true;

sw/update-ref.nix

@@ -1,17 +1,5 @@
+{ pkgs, ... }:
 {
-  config,
-  lib,
-  pkgs,
-  ...
-}:
-
-with lib;
-
-let
-  cfg = config.athenix.sw;
-in
-{
-  config = mkIf cfg.enable {
   environment.systemPackages = with pkgs; [
     python3
     git
@@ -28,7 +16,7 @@ in
         update-ref [-R PATH|--athenix-repo=PATH] [-b BRANCH|--athenix-branch=BRANCH]
                   [-m "msg"|--message "msg"]
                   [-p[=false] [remote[=URL]]|--push[=false] [remote[=URL]]]
-                    [--make-local|-l] [--make-remote|-r] [--ssh]
+                  [--make-local|-l] [--make-remote|-r]
                   user=<username> | system=<device-type>:<hostkey>
       EOF
         exit 2
@@ -72,39 +60,16 @@ in
 
       extract_existing_fetch_url() {
         # args: mode file username key
-          python3 - "$1" "$2" "$3" "$4" "$5"<<'PY'
+        python3 - "$1" "$2" "$3" "$4" <<'PY'
       import sys, re, pathlib
-        mode, file, username, key, use_ssh = sys.argv[1:5]
+      mode, file, username, key = sys.argv[1:5]
       t = pathlib.Path(file).read_text()
 
       def url_from_block(block: str) -> str:
           if not block:
               return ""
           m = re.search(r'url\s*=\s*"([^"]+)"\s*;', block)
-            url = m.group(1) if m else ""
+          return m.group(1) if m else ""
-
-            if use_ssh = "true":
-              return url
-
-            # Already https
-            if url.startswith("https://"):
-                return url
-
-            # ssh://git@host/org/repo.git
-            m = re.match(r"ssh://(?:.+?)@([^/]+)/(.+)", url)
-            if m:
-                host, path = m.groups()
-                return f"https://{host}/{path}"
-
-            # git@host:org/repo.git
-            m = re.match(r"(?:.+?)@([^:]+):(.+)", url)
-            if m:
-                host, path = m.groups()
-                return f"https://{host}/{path}"
-
-            # If you gave me something cursed
-            raise ValueError(f"Unrecognized SSH git URL format: {url}")
-
 
       if mode == "user":
           m = re.search(r'(?s)\n\s*' + re.escape(username) + r'\.external\s*=\s*builtins\.fetchGit\s*\{(.*?)\n\s*\};', t)
@@ -189,7 +154,6 @@ in
 
           --make-local|-l) MODE_FORCE="local"; shift ;;
           --make-remote|-r) MODE_FORCE="remote"; shift ;;
-            --ssh) USE_SSH="true"; shift ;;
           -h|--help) usage ;;
           *) die "Unknown argument: $1" ;;
         esac
@@ -250,7 +214,7 @@ in
       EXISTING_URL=""
       ENTRY_EXISTS=0
       if [ "$MODE" = "user" ]; then
-          EXISTING_URL="$(extract_existing_fetch_url user "$FILE" "$USERNAME" "" "false")"
+        EXISTING_URL="$(extract_existing_fetch_url user "$FILE" "$USERNAME" "")"
         [ -n "$EXISTING_URL" ] && ENTRY_EXISTS=1 || true
       else
         FULL="$(derive_full_hostname "$DEVTYPE" "$HOSTKEY")"
@@ -520,5 +484,4 @@ in
       printf "  rev = %s\n" "$CUR_REV" >&2
     '')
   ];
-  };
 }

sw/updater.nix

@@ -9,47 +9,27 @@ with lib;
 
 {
   options.athenix.sw.remoteBuild = lib.mkOption {
-    type = lib.types.submodule {
+    type = types.submodule {
       options = {
         hosts = mkOption {
-          type = lib.types.listOf lib.types.str;
+          type = types.listOf types.str;
           default = [ "engr-ugaif@192.168.11.133 x86_64-linux" ];
-          description = ''
+          description = "List of remote build hosts for system rebuilding.";
-            List of remote build hosts for system rebuilding.
-
-            Format: "user@hostname architecture"
-            Each host must have SSH access and nix-daemon available.
-
-            Useful for offloading builds from low-power devices (tablets, laptops)
-            to more powerful build servers.
-          '';
-          example = lib.literalExpression ''
-            [
-                        "builder@nix-builder x86_64-linux"
-                        "user@192.168.1.100 aarch64-linux"
-                      ]'';
         };
 
         enable = mkOption {
-          type = lib.types.bool;
+          type = types.bool;
           default = false;
-          description = ''
+          description = "Whether to enable remote build for 'update-system' command.";
-            Whether to enable remote builds for the 'update-system' command.
-
-            When enabled, 'update-system' will use the configured remote hosts
-            to build the new system configuration instead of building locally.
-
-            Automatically enabled for tablet-kiosk systems.
-          '';
         };
       };
     };
     default = { };
-    description = "Remote build configuration for system updates.";
+    description = "Remote build configuration";
   };
 
   config = {
-    athenix.sw.remoteBuild.enable = lib.mkDefault (config.athenix.sw.tablet-kiosk.enable);
+    athenix.sw.remoteBuild.enable = lib.mkDefault (config.athenix.sw.type == "tablet-kiosk");
 
     environment.systemPackages = [
       (pkgs.writeShellScriptBin "update-system" ''
@@ -221,10 +201,8 @@ with lib;
       description = "System daemon to one-shot run the Nix updater from fleet flake as root";
       path = with pkgs; [
         git
-        openssh
         nixos-rebuild
         nix
-        coreutils
       ];
       serviceConfig = {
         Type = "oneshot";

templates/user/user.nix

@@ -1,4 +1,4 @@
-{ ... }:
+{ inputs, ... }:
 
 # ============================================================================
 # User Configuration
@@ -15,6 +15,7 @@
 # nixos-systems configuration (nixpkgs, home-manager, etc.).
 
 {
+  config,
   lib,
   pkgs,
   osConfig ? null, # Only available in home-manager context
@@ -59,7 +60,7 @@
       fd
       bat
     ]
-    ++ lib.optional (osConfig.athenix.sw.desktop.enable or false) firefox;
+    ++ lib.optional (osConfig.athenix.sw.type or null == "desktop") firefox;
   # Conditionally add packages based on system type
 
   # ========== Programs ==========

users.nix

@@ -1,4 +1,4 @@
-{ ... }:
+{ pkgs, ... }:
 {
   # ============================================================================
   # User Definitions
@@ -13,9 +13,8 @@
   #
   # External User Configuration:
   # Users can specify external configuration modules via the 'external' attribute:
-  #   external = { url = "..."; rev = "..."; submodules? = false; };
+  #   external = builtins.fetchGit { url = "..."; rev = "..."; };
   #   external = /path/to/local/config;
-  #   external = builtins.fetchGit { ... }; # legacy, still supported
   #
   # External repositories should contain:
   #   - user.nix (required): Defines athenix.users.<name> options AND home-manager config
@@ -27,7 +26,7 @@
   #
   # User options can be set in users.nix OR in the external module's user.nix.
   # External module options take precedence over users.nix defaults.
-  config.athenix.users = {
+  athenix.users = {
     root = {
       isNormalUser = false;
       hashedPassword = "!";
@@ -48,10 +47,9 @@
       enable = true; # Default user, enabled everywhere
     };
     hdh20267 = {
-      external = {
+      external = builtins.fetchGit {
         url = "https://git.factory.uga.edu/hdh20267/hdh20267-nix";
-        rev = "dbdf65c7bd59e646719f724a3acd2330e0c922ec";
+        rev = "c538e0c0510045b58264627bb897fc499dc7c490";
-        # submodules = false; # optional, defaults to false
       };
     };
     sv22900 = {
@@ -60,7 +58,7 @@
         "networkmanager"
         "wheel"
       ];
-      shell = "zsh";
+      shell = pkgs.zsh;
       # enable = false by default, set to true per-system
     };
   };