nix-config-ryan4yin/lib/README.md

Library

This directory contains helper functions used by outputs/default.nix (and the installer flake) to reduce code duplication and make it easier to add new machines.

Current Functions

Core System Generators

1. attrs.nix - Attribute set manipulation utilities
2. macosSystem.nix - macOS configuration generator for nix-darwin
3. nixosSystem.nix - NixOS configuration generator
4. colmenaSystem.nix - Remote deployment configuration for colmena

Specialized Module Generators

5. genK3sServerModule.nix - K3s server node configuration generator
6. genVmHostModule.nix - physical VM host (bridge + libvirt) configuration generator
7. genMicrovmGuestModule.nix - NixOS microVM guest configuration generator
8. genLibvirtDomainXml.nix - libvirt domain XML generator (imported directly by host configs)

Entry Point

9. default.nix - Main entry point that imports the generators and exports them as a single attribute set, plus the relativeToRoot and scanPaths helpers

Usage

These functions are designed to:

• Generate consistent configurations across different architectures
• Provide type-safe configuration for complex systems
• Enable easy scaling of the infrastructure
• Support both local development and production deployments

Architecture Support

• x86_64-linux: Primary desktop systems
• aarch64-linux: ARM64 Linux systems (Apple Silicon, SBCs)
• aarch64-darwin: Apple Silicon macOS systems