Nix Home Manager configuration template

This repo provides a Nix flake template that you can use to create a new Home Manager configuration for your environment.

To initialize the template inside an existing project:

nix flake init \
--template github:the-nix-way/home-manager-config-template

To create a new project using the template:

nix flake new \
--template github:the-nix-way/home-manager-config-template \
./my-home-manager-config

Then, inside the directory with the templated contents, you may need to personalize these values:

• username
• system
• stateVersion

Once those values are in place, build and run an activator executable, substituting your provided username for ${USER}:

nix build '.#homeConfigurations.${USER}.activationPackage'
./result/activate

That creates the initial generation and installs the home-manager executable. From now on, you can update your Home Manager config using the provided shell script:

reload-home-manager-config

This is a very simple, baseline config, so feel free to customize away!