How quintisimo/mac-nix-config works
Project type and purpose
• This is a declarative “dotfiles”/macOS system configuration project using Nix (nix-darwin + home-manager).
• Its goal is to manage and reproduce a user’s macOS environment (packages, secrets, VSCode settings, system services) purely in Nix.
File structure
Top-level files
• README.md – setup instructions
• flake.nix – entry point of the Nix flake
• flake.lock – locked flake inputs
• agents.nix – agenix configuration helper
• dock.nix – dock layout module
• home.nix – home-manager configuration
Directories
• packages/ – custom package sets (casks, mas, nix pkgs)
• secrets/ – encrypted secrets (secrets.nix + secrets.age)
• vscode/ – VSCode extensions & settings modules
README for operational flow
• Install Nix via a bootstrap script
• Clone into /etc/nix-darwin
• Run darwin-rebuild switch to apply system configuration
• Use agenix to decrypt/encrypt secrets
Main components & interactions
a. Flake Entry Point (flake.nix)
– Declares inputs: nixpkgs, darwin modules, agenix tool
– References local modules (agents.nix, dock.nix, home.nix, packages, secrets, vscode)
b. Nix Flake Resolution
– Lock file (flake.lock) ensures reproducible dependencies
c. Module Layers
– System modules (dock.nix, agents.nix) feed into darwin-rebuild
– Home-manager module (home.nix) configures user-level dotfiles and services
– Package sets (packages/casks.nix, mas.nix, nix.nix)
– VSCode settings & extensions (vscode/settings.nix, extensions.nix)
d. Secret Management
– agenix (external tool) decrypts secrets.age → secrets.nix → consumed by Nix modules
e. Output & Deployment
– sudo darwin-rebuild switch applies system config (launchd services, brew casks, dock layout)
– home-manager switch (implicit via darwin) applies user packages and dotfiles
Architectural patterns & design principles
• Declarative layering: Separate system vs. user vs. secret concerns
• Reproducibility via flake.lock
• Extensibility: each module (dock, vscode, packages) can be added/removed
• Security: encrypted secrets module