4.4 KiB
Nixy
Nixy simplifies and unifies the Hyprland ecosystem with a modular, easily customizable setup. 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-centric: Preconfigured Hyprland ecosystem (Hyprlock, Hyprpanel, etc.)
- 🎨 Consistent Theming: Base16 & Stylix-powered themes
- ⌨️ Vim-like Everywhere: Unified keybindings (Hyprland, nvim, vimium, etc.)
Table of Content
Gallery
Architecture
🏠 /home (User-level configuration)
Contains dotfiles and settings that apply to your user environment.
Subfolders:
programsis a collection of apps configured with home-managerscriptsis a folder full of bash scripts (see SCRIPTS.md)systemis 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.nixfor system-wide settingshome.nixfor user-level configurationvariables.nixfor global variablessecrets/for sensitive data
Installation
- Fork this repo and clone it to your system:
git clone https://github.com/anotherhadi/nixy ~/.config/nixos
- Copy the
hosts/laptopfolder, rename it to match your system’s hostname, and updatevariables.nixwith your machine’s settings. - Copy your
hardware-configuration.nixinto your new host's folder to ensure proper hardware support. - Register your new host in
flake.nixby adding it under nixosConfigurations.
Important
# CHANGEMEcomments 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
- 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
-
SCRIPTS: A list of available scripts and their usage
-
KEYBINDINGS-HYPRLAND: Keybindings available in Hyprland
-
WALLPAPERS: An awesome collection of wallpapers
-
CONTRIBUTING: How to contribute
-
LICENSE: MIT License




