Nixy

Nixy simplifies and unifies the Hyprland ecosystem with a minimalist, modular & easily customizable setup, heavily focused on TUIs. It provides a structured way to manage your system configuration and dotfiles with minimal effort. It includes home-manager, secrets, and custom theming all in one place.

Features:

• 💻 Hyprland & TUIs: Preconfigured Hyprland ecosystem with a lot of cool TUIs
• 🎨 Consistent Theming: Base16 & Stylix-powered themes
• ⌨️ Vim-like Everywhere: Unified keybindings (Hyprland, nvim, vimium, etc.)
• 🔒 Hardened by Default: LUKS encryption, sops-nix secrets, impermanence and more

Table of Content

• Screenshots
• Architecture
  • 🏠 /home (User-level configuration)
  • 🐧 /nixos
  • 🎨 /themes
  • 💻 /hosts
  • 🖥️ /server-modules
• Installation
• Documentation

Screenshots

Architecture

🏠 /home (User-level configuration)

Contains dotfiles and settings that apply to your user environment.

Subfolders:

• programs is a collection of apps configured with home-manager
• system is some "desktop environment" configuration

🐧 /nixos

Those are the system-level configurations. (audio, bluetooth, gpu, bootloader, ...)

🎨 /themes

This folder contains all system themes. Mainly stylix configurations. Check out the available themes and learn how to create your own in THEMES.md

💻 /hosts

This directory contains host-specific configurations. Each host includes:

• configuration.nix for system-wide settings
• home.nix for user-level configuration
• variables.nix for global variables
• secrets/ for sensitive data

🖥️ /server-modules

This folder contains server-related nixos modules. (gitea, cloudflared, self-hosted apps, ...)

Installation

1. Fork this repo and clone it to your system:

git clone https://github.com/anotherhadi/nixy ~/.config/nixos

2. Copy the modules/hosts/laptop folder to modules/hosts/<hostname>, rename the nixosConfigurations entry in its default.nix and update _variables.nix with your machine’s settings.
3. Copy your hardware-configuration.nix into your new host's folder as _hardware-configuration.nix to ensure proper hardware support. (Files starting with _ are plain NixOS modules, ignored by import-tree.)

[!IMPORTANT] # CHANGEME comments are placed throughout the config to indicate necessary modifications. Use the following command to quickly locate them:

rg "CHANGEME" ~/.config/nixos

[!TIP] When you add new files, don't forget to run git add . to add them to the git repository

5. Build the system

sudo nixos-rebuild switch --flake ~/.config/nixos#yourhostname

Documentation

• SERVER: Check out the server documentation

• THEMES: How themes work and how to create your own

• WALLPAPERS: An awesome collection of wallpapers

• NEOVIM: How to use the Neovim config in your own flake

• CONTRIBUTING: How to contribute

• LICENSE: MIT License

---