macOS dotfiles for multiple machines using Nix flakes, nix-darwin, Home Manager, and nix-homebrew.

# Nix (multi-user)
sh <(curl -L https://nixos.org/nix/install)

# Xcode Command Line Tools
xcode-select --install

git clone https://github.com/tutods/macos-setup.git ~/.dotfiles
cd ~/.dotfiles

./nix.sh macbook   # personal MacBook
./nix.sh work      # work laptop

This builds and applies the full system configuration via darwin-rebuild switch. Fish is set as the default shell, App Store apps and VSCode marketplace extensions are all installed automatically — no post-deploy script needed.

On the work laptop, run ./nix.sh work from admin.daniel.a.sousa — the admin user owns Homebrew. Home Manager still configures daniel.a.sousa independently.

Git name and email are not stored in this repo. Set them on each machine:

mkdir -p ~/.config/git
git config --file ~/.config/git/private user.name "Your Name"
git config --file ~/.config/git/private user.email "[email protected]"

See docs/private-git-config.md for full details.

# Rebuild and apply changes
./nix.sh macbook

# Build only (no apply, useful to check for errors)
./nix.sh macbook --build-only

# Force rebuild
./nix.sh macbook --force

# Format all Nix files
nix fmt

.
├── flake.nix                  # Entry point — defines mkDarwin and formatter
├── lib/
│   └── mkHost.nix             # Shared host factory (fish, home-manager, nix-homebrew)
├── modules/
│   ├── common.nix             # Nix settings, timezone, GC, store optimisation
│   ├── darwin/                # macOS defaults, security, firewall, networking
│   └── packages/
│       ├── default.nix        # Imports all package modules
│       ├── cli.nix            # CLI tools (fd, fnm, jq, httpie, doppler, …)
│       ├── development.nix    # Dev tools and IDEs (claude-code, terraform, …)
│       ├── media.nix          # Media processing (ffmpeg, imagemagick, …)
│       └── fonts.nix          # System fonts (JetBrains Mono, Nerd Fonts, …)
├── hosts/darwin/
│   ├── macbook/               # Personal MacBook
│   │   ├── default.nix        # Calls mkHost with macbook values
│   │   ├── dock.nix           # Dock layout
│   │   └── homebrew/          # Macbook-specific casks and MAS apps
│   └── work/                  # Work laptop
│       ├── default.nix        # Calls mkHost with work values
│       ├── dock.nix
│       └── homebrew/          # Work-specific casks (shared base from modules/)
├── home/
│   ├── programs/              # Shared Home Manager programs (fish, VSCode, etc.)
│   ├── tutods/                # tutods user config
│   └── daniel.a.sousa/        # Work user config
└── docs/                      # Additional documentation

1. Create the host directory:

   cp -r hosts/darwin/macbook hosts/darwin/new-machine

2. Edit hosts/darwin/new-machine/default.nix — update the mkHost call:

   { pkgs, mkHost, ... }:
   {
     imports = [
       ./dock.nix
       ./homebrew
       ./networking.nix
       (mkHost {
         username   = "newuser";
         hostname   = "new-machine";
         brewUser   = "newuser";
         homeConfig = import ../../../home/newuser/default.nix;
       })
     ];
   }

3. Create the home config:

   cp -r home/tutods home/newuser
   # edit home/newuser/default.nix to set the correct username/homeDirectory

4. Register in flake.nix:

   new-machine = mkDarwin ./hosts/darwin/new-machine;

5. Deploy:

   ./nix.sh new-machine

Nix garbage collection runs automatically every Sunday (keeps last 7 days of generations).

# Manual clean-up if needed
nix-collect-garbage -d

# If Homebrew has issues after a rebuild
brew doctor

Home Manager creates .backup files when overwriting existing configs — find and remove stale ones with:

find ~ -name "*.backup" -mtime +7

Dependency updates are automated via Renovate — minor and patch updates for nixpkgs, home-manager, nix-darwin, and nix-homebrew are auto-merged. Major updates require manual review.