Unified Nix Flake: macOS (nix-darwin) + NixOS

A single Nix flake managing both macOS (via nix-darwin) and NixOS from one repository. Declarative, reproducible system configurations for every machine.

Features

• Single flake, multiple systems — macOS and NixOS hosts share inputs, overlays, and Home Manager modules.
• macOS support — nix-darwin system configuration with Homebrew integration via nix-homebrew.
• NixOS + ZFS — chopper laptop runs NixOS with ZFS root provisioned by disko.
• Home Manager — per-user environment for both platforms, usable standalone or integrated into the system rebuild.
• Neovim — configured via nixvim.
• Rust toolchain — nightly Rust via fenix.

Planned / in-progress

• Secrets management — sops-nix is in the flake inputs but not yet wired up. Secrets currently live at plaintext paths under /home/vysakh/.
• CI — nix flake check in GitHub Actions.
• treefmt — unified formatting (currently nixpkgs-fmt via nix fmt).

Repository Structure

.
├── flake.nix                  # Flake entrypoint: inputs, outputs, host configs
├── flake.lock
├── CLAUDE.md                  # Audit notes & improvement checklist
├── ROADMAP.md                 # Milestone plan
├── CONTRIBUTING.md            # Contributor guide
│
├── hosts/
│   ├── darwin/                # macOS — "Vysakhs-MacBook-Pro"
│   │   ├── configuration.nix  #   system-level nix-darwin config
│   │   ├── programs.nix       #   GUI / CLI programs
│   │   ├── services.nix       #   launchd / background services
│   │   └── NVIM.md            #   Neovim notes
│   └── chopper/               # NixOS — "chopper" laptop
│       ├── configuration.nix  #   NixOS entry (imports default.nix)
│       ├── default.nix        #   bulk of host config
│       ├── disko-config.nix   #   ZFS partition layout
│       └── hardware-configuration.nix
│
├── home/                      # Home Manager configurations
│   ├── darwin-home.nix        #   HM entry point for macOS
│   ├── linux-home.nix         #   HM entry point for NixOS
│   ├── common/                #   cross-platform HM modules
│   ├── darwin/                #   mac-only HM modules
│   └── chopper/               #   chopper-only HM modules
│
├── modules/                   # NixOS service modules
│   ├── arr.nix                #   *arr media stack
│   ├── care.nix               #   care service
│   ├── conduit.nix            #   Conduit / conduwuit Matrix homeserver
│   ├── garage.nix             #   Garage S3-compatible storage
│   ├── neondb.nix             #   NeonDB wrapper
│   ├── nextcloud.nix          #   Nextcloud server
│   └── zfs.nix                #   ZFS maintenance / scrub config
│
└── packages/                  # Custom packages & overlays
    ├── default.nix
    ├── chopper/               #   packages for chopper
    ├── darwin/                #   packages for macOS
    └── neondb/                #   NeonDB derivation

Module Composition

graph TD
    F[flake.nix] --> L[lib/default.nix]
    F --> DC[darwinConfigurations]
    F --> NC[nixosConfigurations]
    F --> HC[homeConfigurations]

    L --> |mkDarwinHost| DC
    L --> |mkHost| NC
    L --> |mkHome| HC
    L --> |discoverHosts| MD[hosts/*/metadata.nix]

    DC --> DH[hosts/darwin/configuration.nix]
    DH --> DP[hosts/darwin/programs.nix]
    DH --> DS[hosts/darwin/services.nix]
    DH --> DB[hosts/darwin/homebrew.nix]

    NC --> CH[hosts/chopper/configuration.nix]
    CH --> CD[hosts/chopper/default.nix]
    CD --> PB[parts/boot.nix]
    CD --> PN[parts/network.nix]
    CD --> PP[parts/power.nix]
    CD --> PD[parts/display.nix]
    CD --> PV[parts/virtualisation.nix]
    CD --> PPR[parts/programs.nix]
    CD --> PU[parts/users.nix]
    CD --> PS[parts/services.nix]

    CH --> MOD[modules/]
    MOD --> MZ[zfs.nix]
    MOD --> MN[nextcloud.nix]
    MOD --> MC[conduit.nix]
    MOD --> MA[arr.nix]

    HC --> HDH[home/darwin-home.nix]
    HC --> HLH[home/linux-home.nix]
    HDH --> HCO[home/common/]
    HDH --> HDA[home/darwin/]
    HLH --> HCO
    HLH --> HCH[home/chopper/]

    NC --> PROF[profiles/]
    PROF --> PRB[base.nix]
    PROF --> PRL[laptop.nix]
    PROF --> PRS[server.nix]
    PROF --> PRZ[zfs.nix]
    PROF --> PRW[wayland.nix]
    PROF --> PRD[dev.nix]

Loading

Hosts

Host	System	Manager	Description
Vysakhs-MacBook-Pro	aarch64-darwin	nix-darwin	MacBook Pro (Apple Silicon)
chopper	x86_64-linux	NixOS	Laptop, ZFS root via disko

Home Manager targets:

Target	Platform
mathewalex@Vysakhs-MacBook-Pro	macOS
vysakh@chopper	NixOS

Usage

Rebuild the system

# macOS (nix-darwin)
nh darwin switch .

# NixOS
nh os switch .

Standalone Home Manager

# macOS
home-manager switch --flake .#mathewalex@Vysakhs-MacBook-Pro

# NixOS
home-manager switch --flake .#vysakh@chopper

Other common commands

# Update all flake inputs
nix flake update

# Format nix files
nix fmt

# Search packages
nix search nixpkgs <package-name>

# Check flake evaluation
nix flake check

Customization

• Add a host — create hosts/<name>/ with a configuration.nix (and optionally default.nix, hardware-configuration.nix, etc.), then wire it into flake.nix. See CONTRIBUTING.md for more detail.
• Add a Home Manager module — create a directory under home/common/ (cross-platform) or home/<host>/ (host-specific) with a default.nix, then import it from the relevant entry point.
• Add a NixOS service — create modules/<service>.nix and import it from the host that needs it.
• Add a package — add it under packages/ and expose via the overlay in packages/default.nix.

Key Inputs

Input	Purpose
nixpkgs (unstable)	Package set
home-manager	User environment
nix-darwin	macOS system config
nix-homebrew	Homebrew cask integration
fenix	Nightly Rust toolchain
nixvim	Neovim configuration
disko	Declarative disk partitioning
sops-nix	Secrets management (planned)
nix-index-database	command-not-found index

Resources

• NixOS Manual
• nix-darwin Manual
• Home Manager Manual
• Disko docs
• Nix Flakes wiki

License

See LICENSE for details.