current build
This commit is contained in:
1 parent
842ac07091
commit
c031fc7ae1
11 files changed
+401
-1
No files matched your search
@@ -0,0 +1,42 @@
|
||||
# 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
|
||||
├── main.nix # Base module imported by every host: core/ + nixos/ + network-drives.nix
|
||||
├── skyg-utils.nix # makeHyperlinkScriptToConfigs (symlinks configs/ → ~/.config/)
|
||||
├── 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, Gitea, AI stack, DNS, Dockge, ARRs...
|
||||
│ └── 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.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
|
||||
Reference in new issue
Block a user