Files
nixos-setup/modules/home/ABOUTME.md
T
2026-08-27 12:09:26 -04:00

47 lines
2.2 KiB
Markdown

# modules/home/
The Home Manager layer. **Unlike the rest of the repo, these files are not NixOS modules** —
they are plain functions that return Home Manager attribute sets. `core/user.nix` imports
this directory and calls the exported builders to populate `home-manager.users.<name>`.
## Files
```
home/
├── default.nix # Exports makeRootUser and makeCommonUser; composes the modules below
├── programs.nix # programs.* — shell + CLI tooling (zsh, nushell, neovim, starship, …)
├── services.nix # services.* — gpg-agent with SSH support
├── git.nix # makeCommonGitConfigs — git/delta config + includes from gitconfigs/
├── fonts.nix # fontconfig default font families
└── gitconfigs/ # Raw .gitconfig fragments included by every user (aliases, …)
```
## Entry points
`default.nix` exports two builder functions, both consumed by `core/user.nix`:
- `makeRootUser { hostName }` — minimal root profile (jq, kubectl, …) with a
`root@<hostName>` git identity.
- `makeCommonUser { name, fullName, email, extraGitConfigs ? [] }` — the full human profile:
dev packages, the shared shell/program config, and the user's git identity.
Both apply the shared `homeModule` (state version + shell aliases like `cat→bat`,
`ls→eza`, `du→dust`, `df→duf`), `programsModule`, `servicesModule`, and `fontsModule`.
## Notable details
- **Shells**: zsh is the login shell, with autosuggestions, syntax highlighting, and a
`notify-send` hook for long-running commands. Nushell, starship, carapace, zellij, and
tmux are all configured here.
- **Git** (`git.nix`): `makeCommonGitConfigs` auto-includes every file under `gitconfigs/`
plus any per-user `extraGitConfigs`. Uses delta for diffs.
- The standalone (non-NixOS) Home Manager path in `modules/lib.nix`
(`makeHomeManagerUsers`) also calls `makeCommonUser`.
## Conventions
- These are **functions, not modules** — there is no `options`/`config`/`lib.mkIf` here.
Keep that pattern; the NixOS module system is applied one level up in `core/user.nix`.
- Add new shared CLI programs to `programs.nix`, services to `services.nix`, and global
packages to the relevant `home.packages` list in `default.nix`.