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

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

Gallery

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
• scripts is a folder full of bash scripts (see SCRIPTS.md)
• 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. (bitwarden, nextcloud, ...)

Installation

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

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

2. Copy the hosts/laptop folder, rename it to match your system’s hostname, and update variables.nix with your machine’s settings.
3. Copy your hardware-configuration.nix into your new host's folder to ensure proper hardware support.
4. Register your new host in flake.nix by adding it under nixosConfigurations.

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

• 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