Transform your desktop into a productivity powerhouse with this beautiful, keyboard-driven Linux environment. Built on the lightning-fast Hyprland compositor, this setup delivers a modern, animated workspace that's both stunning and efficient. Whether you're a complete Linux newcomer or a seasoned power user, everything is configured out-of-the-box with automatic theming, easily accessible command palette, and declarative configuration that makes customization effortless.
Universal Features:
- 🔎 Command palette - perform many actions under one key! See home/scripts/command-palette/default.nix
- 🎨 Consistent Theming - base16 & stylix-powered themes across all applications
- ⌨️ Keyboard-focused navigation - vim-like keybindings everywhere (Hyprland, nvim, browser, etc.)
- 📦 Easy package management - add/remove programs effortlessly, browse available packages at search.nixos.org
- 🌆 Animated wallpaper support - easily select an animated or static wallpaper
For Developers:
- 💻 Hyprland-centric - Preconfigured ecosystem (Hyprlock, Hyprpanel, etc.)
- 🔧 Pure Lua Neovim setup (easily modifiable)
- 🖥️ Multi-machine support - easily extend config across different systems
- ⚙️ Variable-based setup - customize everything through simple configuration variables
- 🏠 Home-manager integration - declarative user environment management
For Creatives:
- 🎨 GIMP with Photoshop-like interface - familiar workflow for designers
- 🎬 Video editing with Kdenlive - professional video editing capabilities
For Gamers:
- 🎮 Lutris - unified launcher for games and emulators (Steam, Epic, retro consoles, etc.)
- 🎯 Steam integration - seamless gaming experience with Proton
- 🕹️ Retro gaming - PS2, PS3, and other console emulators through Lutris
- ⚡ Performance optimizations - gaming-focused kernel and driver configurations
and much more!
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
Those are the system-level configurations. (audio, bluetooth, gpu, bootloader, ...)
This folder contains all system themes. Mainly stylix configurations. Check out the available themes and learn how to create your own in THEMES.md
This directory contains host-specific configurations. Each host includes:
configuration.nixfor system-wide settingshome.nixfor user-level configurationvariables.nixfor global variablessecrets/for sensitive data
- Fork this repo and clone it to your system:
git clone https://github.com/romek-codes/nexusystem ~/.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
# CHANGEME comments are placed throughout the config to indicate necessary modifications.
Use the following command to quickly locate them:
rg "CHANGEME" ~/.config/nixosTip
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-
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
-
CONTRIBUTING: How to contribute
-
LICENSE: MIT License
Special thanks to the amazing people who made this configuration possible:
-
gvolpe - For helping me dive into the Nix ecosystem. His configuration was the first I used and modified to create my own, serving as my gateway into the world of declarative system management.
-
anotherhadi - For the beautiful foundation that became this configuration. His config provided the elegant base that I've built upon and customized.
This project stands on the shoulders of these contributors and the broader NixOS community. 🙏
