NixOS Configuration

My personal NixOS configuration with a focus on modularity, reproducibility, and aesthetics.

Features

• 🔄 Flakes — fully reproducible builds
• 🏠 Home Manager — declarative user environment management
• 🎨 Catppuccin Macchiato — consistent theming across the system
• 🪟 Hyprland — modern Wayland compositor
• 📦 Modular Architecture — easily extensible and maintainable configuration

📸 Screenshots

🗂️ Project Structure

.
├── flake.nix              # Main entry point
├── flake.lock
├── hosts/                 # Host-specific configurations
│   └── default/           # Default host configuration
├── modules/               # Reusable modules
│   ├── nixos/            # System-level modules (NixOS)
│   └── home-manager/     # User-level modules (Home Manager)
├── LICENSE
└── README.md

🎨 System Components

System Level

Component	Value
Display Manager	SDDM with Catppuccin theme
Desktop Environment	GNOME + Hyprland (your choice)
Wallpaper Engine	AWWW
Theme	Catppuccin Macchiato Lavender

User Environment

Category	Applications
Window Manager	Hyprland
Terminal	Alacritty
Shell	Zsh + Oh My Zsh
Launcher	Rofi
Status Bar	Waybar
File Manager	Nautilus
Icons	Papirus-Dark

🚀 Installation

Prerequisites

• NixOS installed
• Flakes enabled (add to /etc/nixos/configuration.nix):

  nix.settings.experimental-features = [ "nix-command" "flakes" ];

Option 1: Full Configuration Replacement

⚠️ Warning: This method will delete your current configuration!

# Remove existing configuration
sudo rm -rf /etc/nixos

# Clone the repository
sudo git clone https://github.com/win-hafus/nixos-config /etc/nixos

# Navigate to the directory
cd /etc/nixos
make install

# Apply the configuration
make switch

Option 2: Integration with Existing Configuration

# Clone to your home directory
git clone https://github.com/win-hafus/nixos-config ~/nixos-config

# Import desired modules into your configuration
# Add to your flake.nix:
inputs.my-config.url = "github:win-hafus/nixos-config";

# Then use the modules:
imports = [ inputs.my-config.nixosModules.default ];

⚙️ Configuration

Changing Username and Hostname

Edit flake.nix:

...
let
      username = "hfv5";
      hostname = "nixos";
    in {
...

🔄 Updating

# Update flake inputs
make update-flake

# Apply updates
make switch

# Clean old generations (optional)
make gc-old

📚 Useful Resources

• NixOS Manual — official documentation
• Home Manager Manual — Home Manager documentation
• Nix Pills — deep dive into Nix
• MyNixOS — search NixOS options
• Hyprland Wiki — Hyprland documentation
• Catppuccin — theme documentation

🤝 Contributing

Found a bug or have a suggestion? Feel free to open an issue or pull request!

📜 License

This project is licensed under the MIT License.

🙏 Acknowledgments

• NixOS — for the amazing operating system
• Hyprland — for the modern compositor
• Catppuccin — for the beautiful color scheme
• The NixOS community for continuous support and inspiration

---

Made with ❤️ and NixOS