<div align="center"> <img alt="nixy logo" src="https://raw.githubusercontent.com/anotherhadi/nixy/main/.github/assets/logo.png" width="120px" /> </div> <br>

Nixy

<br> <div align="center"> <a href="https://github.com/anotherhadi/nixy/stargazers"> <img src="https://img.shields.io/github/stars/anotherhadi/nixy?color=A89AD1&labelColor=0b0b0b&style=for-the-badge&logo=starship&logoColor=A89AD1"> </a> <a href="https://github.com/anotherhadi/nixy/"> <img src="https://img.shields.io/github/repo-size/anotherhadi/nixy?color=A89AD1&labelColor=0b0b0b&style=for-the-badge&logo=github&logoColor=A89AD1"> </a> <a href="https://nixos.org"> <img src="https://img.shields.io/badge/NixOS-unstable-blue.svg?style=for-the-badge&labelColor=0b0b0b&logo=NixOS&logoColor=A89AD1&color=A89AD1"> </a> <a href="https://github.com/anotherhadi/nixy/blob/main/LICENSE"> <img src="https://img.shields.io/static/v1.svg?style=for-the-badge&label=License&message=MIT&colorA=0b0b0b&colorB=A89AD1&logo=unlicense&logoColor=A89AD1"/> </a> </div> <br>

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 & Caelestia: Preconfigured Hyprland ecosystem with Caelestia-shell (Ty to both projects!)
• 🎨 Consistent Theming: Base16 & Stylix-powered themes
• ⌨️ Vim-like Everywhere: Unified keybindings (Hyprland, nvim, vimium, etc.)

Table of Content

• 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. (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

• WALLPAPERS: An awesome collection of wallpapers

• CONTRIBUTING: How to contribute

• LICENSE: MIT License