README.md

Dotfiles

Declarative dotfiles, user environments, and NixOS hosts for my macOS and Linux machines, written in Nix.

One flake defines everything a machine needs as a user: packages, shell, git, SSH, Neovim, fonts, terminal. Applying it rebuilds that environment from these files, so every machine matches and every change is a commit.

Profiles

• personal with alias al

Every file under modules/ is an opt-in module, such as nvim, ghostty, or zsh. A profile gets all of them unless it lists the ones it wants in modules.

nix run home-manager -- switch --flake . resolves via the alias on each machine. The explicit form .#personal remains available.

A profile that does not belong in a public repository lives in its own flake. The flake module closes over this flake's inputs, so that flake needs only:

{
  inputs.dotfiles.url = "github:alDuncanson/dotfiles";

  outputs =
    inputs@{ dotfiles, ... }:
    dotfiles.inputs.flake-parts.lib.mkFlake { inherit inputs; } {
      imports = [ dotfiles.flakeModules.default ];
      dotfiles.profiles.work = {
        aliases = [ "<login>" ];
        userName = "<login>";
        homeModule = ./home.nix;
      };
    };
}

Hosts that compose the user environment themselves can import individual modules from homeModules.<name>, or all of them from homeModules.default.

Hosts

• thinkpad: NixOS on a ThinkPad 13 with Sway, ghostty, Firefox, and the nvim module

sudo nixos-rebuild switch --flake .#thinkpad

Commands

# format all Nix files via the flake formatter
nix fmt

# run the standard repo checks
nix flake check

# inspect exports
nix flake show --all-systems

# evaluate profiles
nix eval .#homeConfigurations.personal.activationPackage.drvPath

# build profiles without switching
nix run home-manager -- build --flake .#personal

# apply the current machine profile
nix run home-manager -- switch --flake .

# run the exported Neovim app
nix run .#neovim
nix run .#neovim -- --headless '+qa!'

Bootstrap

nix shell nixpkgs#git -c git clone <repo-url> ~/.config/home-manager
cd ~/.config/home-manager
nix run home-manager -- switch --flake .

After bootstrap, updates are just git pull and nix run home-manager -- switch --flake ..