Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Modules

Custom NixOS and home-manager modules under the atelier.* namespace. These wrap and extend upstream packages with opinionated defaults and structured configuration.

All modules live under modules/nixos/ and modules/home/. Machines using import-tree automatically discover every .nix file in those trees. Modules only activate when their enable option is set to true.

Documented modules

These have detailed option references and examples:

NixOS

  • tuigreet — login greeter (atelier.apps.tuigreet)
  • wifi — declarative Wi-Fi profiles with eduroam (atelier.network.wifi)

Home-manager

  • shell — zsh + oh-my-posh + Tangled tooling (atelier.shell)
  • ssh — SSH config with zmx persistent sessions (atelier.ssh)
  • helix — evil-helix with LSPs, wakatime, harper (atelier.apps.helix)
  • bore (client) — tunnel client CLI (atelier.bore)
  • pbnj — pastebin CLI (atelier.pbnj)
  • wut — git worktree manager (atelier.shell.wut)

Other modules

Many more modules exist without dedicated doc pages. Browse the source:

  • modules/home/apps/ — ghostty, alacritty, git, jj, qutebrowser, spotify, halloy, irssi, tofi
  • modules/home/aesthetics/ — theming (Catppuccin), wallpapers
  • modules/home/wm/ — hyprland, yabai/skhd
  • modules/nixos/system/ — authentication, machine metadata
  • modules/nixos/services/ — 20+ service modules (see Services)