Fr1nge's Dotfiles

Personal system and home configuration managed with a Nix flake. The repository contains one NixOS host, two standalone Home Manager profiles, one nix-darwin host, and the application configuration they share.

This is a personal configuration rather than a generic installer. Usernames, home directories, hardware, storage, and host-specific settings should be reviewed before activating it on another machine.

Hosts

Host	Flake output	Platform	Purpose
ursa	nixosConfigurations.ursa	x86_64-linux	NixOS desktop with Hyprland and impermanence
ara	homeConfigurations.ara	x86_64-linux	Standalone Home Manager desktop profile
lyra	homeConfigurations.lyra	x86_64-linux	Standalone Home Manager headless development profile
vela	darwinConfigurations.vela	aarch64-darwin	nix-darwin macOS profile

The main desktop stack is Hyprland, Eww/Waybar, Mako, Alacritty, tmux, zsh, Neovim, Firefox, and Catppuccin Mocha.

Repository layout

• nix/flake.nix defines the system, Home Manager, Darwin, package, and overlay outputs.
• nix/hosts/ contains the host entrypoints.
• nix/modules/ contains NixOS modules.
• nix/home/ contains shared Home Manager modules.
• nix/hardware/ contains machine-specific hardware configuration.
• nix/pkgs/ contains custom packages exposed through the flake and pkgs.our overlay.
• .config/ contains application configuration used by Home Manager.
• .local/bin/ contains personal scripts installed into the home profile.

Application configuration should remain readable in .config/. Home Manager either installs those files directly or uses them as the source for generated configuration. In particular, .config/tmux/tmux.conf is the single source for the custom tmux configuration.

Prerequisites

• Nix with the nix-command and flakes features enabled.
• home-manager for the standalone Linux profiles.
• nix-darwin for the macOS profile.
• just for the repository shortcuts below.
• nh, nixfmt, and nom for the recipes that invoke them.

Installation and activation

Clone the repository at the path expected by the live configuration links:

git clone https://github.com/arg3t/dotfiles.git ~/.dots
cd ~/.dots
nix flake check ./nix

Activate the appropriate host:

# NixOS desktop
nh os switch ./nix#ursa

# Standalone Home Manager profiles
home-manager switch --flake ./nix#ara
home-manager switch --flake ./nix#lyra

# macOS
darwin-rebuild switch --flake ./nix#vela

ursa contains machine-specific LUKS, Btrfs, impermanence, and hardware configuration. Do not activate it unchanged on different hardware.

Machine-local script settings and secrets can be added to ~/.config/config.env.local; the generated ~/.config/config.env sources it when present.

Common commands

Run just to list the available recipes.

Command	Action
just check	Evaluate and check all flake outputs
just test	Alias for just check
just fmt	Format the Nix files with nixfmt
just build	Build the custom oh-my-pi package with nom
just update	Update flake inputs, then check the flake
just switch	Activate the NixOS configuration with nh
just boot	Build the NixOS configuration for the next boot
just clean	Remove old Nix generations while retaining five rollbacks

The switch and boot recipes are intended for the NixOS host. The standalone Home Manager and nix-darwin profiles use their explicit activation commands above.