A comprehensive, cross-platform Nix Home Manager configuration for managing development environments across macOS and Linux systems.

Gibbix is a flake-based Home Manager configuration that provides:

• Declarative environment management - Version control your entire development setup
• Cross-platform consistency - Same tools and configurations across macOS and Linux
• Modular design - Easy to customize and extend for different use cases
• Reproducible builds - Deterministic package management with Nix flakes

This configuration supports five different host systems:

Before using this configuration, ensure you have:

1. Nix Package Manager (with flakes enabled)
2. Home Manager (installed via this configuration)
3. Git (for cloning the repository)

sh <(curl -L https://nixos.org/nix/install) --daemon

Add the following to ~/.config/nix/nix.conf (create if it doesn't exist):

experimental-features = nix-command flakes

Or set it globally in /etc/nix/nix.conf:

experimental-features = nix-command flakes

git clone https://github.com/ScottGibb/Gibbix.git ~/.config/home-manager
cd ~/.config/home-manager

Select the appropriate configuration for your system:

nix  switch --flake ~/.config/home-manager#scogib01@work-mac

nix  switch --flake ~/.config/home-manager#scott@work-linux

nix  switch --flake ~/.config/home-manager#scottgibb@personal-mac

nix  switch --flake ~/.config/home-manager#pi@nas

nix  switch --flake ~/.config/home-manager#pi@pi

Once Home Manager is installed, you can apply future changes with:

home-manager switch --flake ~/.config/home-manager#<your-config>

• flake.nix - Defines all Home Manager configurations and outputs
• home.nix - Base configuration imported by all hosts
• hosts/ - System-specific settings (username, home directory, packages)
• modules/ - Reusable configuration modules for specific purposes

Update flake inputs (nixpkgs, home-manager):

nix flake update
home-manager switch

Validate your configuration without applying:

nix flake check --all-systems

Format all .nix files using the configured formatter:

nix fmt **/*.nix

List all packages installed by Home Manager:

home-manager packages

To add a new host configuration:

1. Create a host file in hosts/:

# hosts/new-host.nix
{ pkgs, lib, ... }:

{
  home.username = "yourusername";
  home.homeDirectory = "/home/yourusername";  # or /Users/yourusername on macOS

  home.packages = with pkgs; [
    # Host-specific packages
  ];
}

1. Add the configuration to flake.nix:

"yourusername@new-host" = mkHomeConfiguration "x86_64-linux" [
  ./home.nix
  ./modules/personal.nix  # or ./modules/work.nix
  ./hosts/new-host.nix
];

1. Apply the configuration:

home-manager switch --flake ~/.config/home-manager#yourusername@new-host

If you see error: experimental Nix feature 'flakes' is disabled:

1. Add to ~/.config/nix/nix.conf:

   experimental-features = nix-command flakes
   

2. Restart your terminal or run:

   source /etc/bashrc  # or /etc/zshrc

If you get package collision errors:

1. Check for duplicate packages in your configuration
2. Use lib.mkForce to override conflicting options
3. Review your home.packages lists for duplicates

If a build fails:

1. Check the error message carefully
2. Ensure you're on a supported system architecture
3. Try updating inputs: nix flake update
4. Check GitHub Actions for known issues

If Home Manager complains about existing files:

1. Backup your existing dotfiles
2. Remove conflicting files
3. Run home-manager switch again