Files
2026-11-05 15:21:01 -05:00

50 lines
2.4 KiB
Markdown

# modules/
All reusable NixOS and Home Manager modules. Every host gets the full module tree via
`modules/main.nix`, which is wired up in `flake.nix` through the `makeNixOs` helper.
## Structure
```
modules/
├── lib.nix # makeNixOs / makeIso / makeHomeManagerUsers / makeDarwinModule / eachSystem
│ # (registers flake-input NixOS modules:
│ # hhstream → services.hyprland-headless-stream)
├── main.nix # Base module imported by every host: core/ + nixos/ + network-drives.nix
│ # + skyg.internalNetworkingMap (global app registry + appNetwork)
├── internal-networking.nix # Renders skyg.internalNetworkingMap → router generalMappings
├── skyg-utils.nix # makeHyperlinkScriptToConfigs (symlinks configs/ → ~/.config/;
│ # backs up an existing real dir to <path>.backup.<timestamp>)
├── macos.nix # macOS / nix-darwin module
├── network-drives.nix # skyg.networkDrives — NFS automount options
├── core/ # User, binary caches, distributed builds, macOS workarounds
├── home/ # Home Manager: shell, programs, git, fonts, services
├── nixos/
│ ├── common/ # Core system settings, networking, SSH, QEMU, fonts, hardware
│ ├── server/ # Server services: K3s/K8s, DNS, AI stack, ARRs, media…
│ └── desktop/ # Desktop: tiler (niri/hyprland), packages, theming, crypto
├── openwrt/ # OpenWrt router config generator
```
## Option Namespace
All custom options live under `skyg.*`. Never introduce options outside this namespace.
```
skyg.user.* → core/user.nix
skyg.networkDrives.* → network-drives.nix
skyg.internalNetworkingMap.* → main.nix (global app registry; rendered into router DNS by internal-networking.nix)
skyg.rootDir → core/default.nix (set by the flake; repo root store path)
skyg.nixos.common.* → nixos/common/
skyg.nixos.desktop.* → nixos/desktop/
skyg.nixos.server.* → nixos/server/
skyg.core.* → core/
```
## Key Conventions
- All modules gate config with `lib.mkIf cfg.enable { ... }`
- Default for every `enable` option is `false` unless universally required
- New modules go in the most specific subdirectory that matches their scope
- See `docs/modules/README.md` for full option reference and architecture diagram