Skip to content

Contents

Conceptual documentation to help you understand the architecture and design patterns used in this infrastructure.

  • Architecture overview - Understanding the architecture combining deferred module composition, clan, and multi-channel overlay composition
  • Module system primitives - Understanding deferredModule, evalModules, and fixpoint computation - the foundations that enable Nix configuration composition
  • Flake-parts and the module system - How flake-parts wraps nixpkgs evalModules to provide flake composition, perSystem evaluation, and namespace conventions
  • Deferred module composition - Understanding deferred module composition where every Nix file is a module organized by aspect
  • Clan Integration - Multi-machine coordination with clan and clear boundaries with other tools
  • System-user integration - Understanding admin users with integrated home-manager vs non-admin standalone users