⚠️ Screenshots may be outdated. Documentation is updated incrementally.

→ Full feature descriptions

• Adaptive host support via denix (per-host modules and constants)
• Host-specific home-manager modules (/users + /modules) and manual-import templates (/templates)
• Hybrid declarative + non-declarative modules (shells, caelestia, noctalia)
• Theming: base16 + optional Catppuccin via stylix
• Host-specific wallpapers tied to monitor list
• Multiple desktop environments: Hyprland with waybar, Hyprland with caelestia, Hyprland with noctalia, niri with noctalia, MangoWM with mangowc, KDE, GNOME, Cosmic
• NixOS specializations: guest (ephemeral RAM home), safe-mode (IceWM recovery shell), deep-focus (distraction-free workspaces), secure-travel (hardened, kill-switch VPN)
• flakes & Home Manager integration
• Multiple shells (bash, zsh, fish)
• Optional BTRFS snapshots with per-host retention policy
• SOPS-nix secret management
• Impermanence (root wiped on reboot, /persist for state)
• Cachix binary cache support
• Multi-architecture: x86_64-linux, aarch64-linux, aarch64-darwin ⚠️ best-effort — no physical aarch64-linux or aarch64-darwin hardware available for testing

1. Boot a NixOS Minimal ISO from a USB stick (UEFI, Secure Boot off).
2. Connect to the internet (sudo nmtui for WiFi).
3. Download the config:

   nix-shell -p git
   git clone https://github.com/nicolkrit999/nix.git
   cd ~/nix

4. Change homeManagerUser in flake.nix to your chosen username.
5. Copy a host template, configure the minimal variables, such as user, homeManagerSystem, then proceed with your chosen method below.

→ Daily usage guide

→ Troubleshooting guides

Quick reference:

• path '.../hardware-configuration.nix' does not exist → git add -f hosts/<hostname>/hardware-configuration.nix
• permission denied on flake.lock → sudo chown -R $USER:users ~/nix
• returned non-zero exit status 4 → usually a service restart failure after a successful build; try rebuilding again
• Weird keyboard layout during install → loadkeys <layout> to fix temporarily
• Caelestia/noctalia font issues → install the font in configuration.nix or home-packages.nix