Files
nixos-setup/modules/core/ABOUTME.md
T
ari 3c86efa4ff clean up & hyprland experiments
- Cleaned up docs
- removed hyprglass
- added various ways to do scroll view
2026-08-28 12:58:27 -04:00

47 lines
2.1 KiB
Markdown

# modules/core/
Cross-platform base configuration imported by **every** host (NixOS and macOS) via
`modules/main.nix`. This is where the primary user, Nix binary caches, distributed builds,
and a couple of nixpkgs overlays/workarounds live.
## Files
```
core/
├── default.nix # Entry point: imports the files below + overlays + remote builder
├── user.nix # skyg.user.* — the human user + Home Manager wiring
├── nix-substituters.nix # skyg.core.substituters.* — binary caches & trusted keys
└── macos.nix # skyg.user.macos.enableOverride — macOS-only HM tweaks
```
## What lives here
- **Overlays** (`default.nix`): exposes the `pkgs/` packages — `grok-cli`, `ds4`
(+`ds4-rocm`/`ds4-cuda`), `colibri` (+`colibri-rocm`), `niri-touchscreen-gestures`,
`buzz-desktop`, `ollama` (+`ollama-rocm`/`ollama-vulkan`) — and patches
`python3Packages.pipx` to skip its flaky install check on nixpkgs 26.05.
- **Distributed builds** (`default.nix`): registers `bigbox1.lab.internal` and
`fwdesk.lab.internal` as remote `x86_64-linux` build machines and enables
`builders-use-substitutes`.
- **User** (`user.nix`): defines `skyg.user.{name,fullName,email}` plus
`skyg.home-manager.{version,extraImports}`. When `skyg.user.enable` is set it wires up
Home Manager for both `root` and the named user using the functions in `modules/home`.
- **Substituters** (`nix-substituters.nix`): the standing list of caches (local `minipc1`
cache, cache.nixos.org, cachix caches for cuda/cosmic/ai/noctalia, flox, devenv) and the
trusted public keys. Extra entries can be appended per-host via `skyg.core.substituters.{urls,keys}`.
## Option Namespace
```
skyg.user.* → user.nix (+ macos.nix for the macOS override)
skyg.home-manager.* → user.nix
skyg.core.substituters.* → nix-substituters.nix
```
## Conventions
- `skyg.user.enable` triggers Home Manager setup and asserts that `name`, `fullName`, and
`email` are non-empty.
- Cache URLs/keys here are global defaults; add host-specific caches through the
`skyg.core.substituters.{urls,keys}` options rather than editing this file.