Getting Started Guide

Steps you can follow after cloning this template:

macOS (Home Manager standalone)

This repo is now a standalone Home Manager flake (no nix-darwin).

Prereqs

1. Xcode Command Line Tools

xcode-select --install

1. Install Nix (multi-user recommended)

curl -L https://nixos.org/nix/install | sh

1. Enable flakes + nix-command (per-user)

mkdir -p ~/.config/nix
printf "experimental-features = nix-command flakes\n" >> ~/.config/nix/nix.conf

Use

From the repo root:

# build (does not modify your home)
nix run .#build

# apply/switch (updates your Home Manager-managed dotfiles and packages)
nix run .

One-time cleanup (recommended before first switch)

If you previously managed these tools outside Home Manager, remove legacy files so Home Manager can take over cleanly (it will still back up conflicting files using the .bak extension via home-manager -b bak).

rm -f ~/.aerospace.toml

If you have an existing ~/.zshrc that you want to keep, rename it first:

mv ~/.zshrc ~/.zshrc.bak

The Home Manager configuration is exposed as:

• homeConfigurations.jrreed

If you copy this repo for another user, you typically only need to:

• add their username to homeConfigurations in flake.nix (see comment)

Neovim flake input

This repo includes your Neovim flake as an input:

• github:neonvoidx/nvim

If it exports a default package, you can enable it by uncommenting the example in modules/home.nix.