Droidnix is a modular, declarative NixOS + Home Manager configuration system. It allows users to choose between Hyprland and Mangowc as their window manager, with shared and WM-specific configurations managed via Emacs Org and Nix Flakes. The project is designed for reproducibility, maintainability, and cross-machine compatibility.

Installed components:

Core

Hyprland

Mangowv

Goals, project Structure, import hierarchy

This project uses a modular NixOS configuration with Hyprland and MangoWC support, designed for literate programming and cross-device reusability. The Droidnix repository is organized into two main parts:

.assets/: Static, non-generated files (e.g., configs, scripts, themes).
Generated folders (common, hyprland, mangowc): NixOS and Home Manager configurations, generated from Org files.

Root Level

flake.nix is the entry point and imports:
- generated/common/nixos/default.nix
- generated/hyprland/nixos/default.nix
- generated/mangowc/nixos/default.nix
- Machine-specific configurations from assets/machines/

Common Configuration (generated/common/)

nixos/default.nix aggregates all NixOS modules:
- hardware/hardware.nix
- packages/packages.nix
- security/security.nix
- services/services.nix
- users/users.nix
home-manager/default.nix aggregates Home Manager modules:
- programs/programs.nix
- shell/shell.nix
- starship/starship.nix
themes/default.nix aggregates theme modules:
- fonts/fonts.nix
- gtk/gtk.nix
- icons/icons.nix
- shells/shells.nix

Hyprland Configuration (generated/hyprland/)

nixos/default.nix imports:
- plugins/plugins.nix
- window-manager/window-manager.nix
home-manager/default.nix imports:
- programs/programs.nix
- scripts/scripts.nix
themes/default.nix imports:
- hypr/hypr.nix
- rofi/rofi.nix
- waybar/waybar.nix
overrides/default.nix imports:
- overrides/overrides.nix

MangoWC Configuration (generated/mangowc/)

nixos/default.nix imports:
- plugins/plugins.nix
- window-manager/window-manager.nix
home-manager/default.nix imports:
- programs/programs.nix
- scripts/scripts.nix
themes/default.nix imports:
- mangowc/mangowc.nix
- waybar/waybar.nix
- wofi/wofi.nix
overrides/default.nix imports:
- overrides/overrides.nix

File Structure and Imports

Every default.nix file imports all .nix files in its directory.
Machine-specific configurations are stored in assets/machines/.
Themes and overrides are modular and reusable across setups.

Design Principles

Modularity: Each component is self-contained and reusable.
Consistency: Every directory follows the same import pattern.
Scalability: Easy to add new machines or configurations.

tree --noreport -P "*.nix" -I "*.nix~" --dirsfirst

.
├── assets
│   ├── common
│   │   ├── conf
│   │   │   └── base.conf
│   │   ├── cursors
│   │   │   └── Bibata_Cursor-main
│   │   ├── emacs
│   │   │   └── setup_emacs.sh
│   │   ├── icons
│   │   │   └── papirus-icon-theme-master
│   │   ├── neovim
│   │   │   └── setup_nvim_literate_nixos.sh
│   │   ├── nixos_conf
│   │   │   └── wallpaperstuff
│   │   │       ├── pictures
│   │   │       └── videos
│   │   ├── scripts
│   │   │   ├── copy_stuff.sh
│   │   │   └── end_script.sh
│   │   └── themes
│   │       └── Catppuccin-Mocha-Standard-Blue-Dark
│   ├── copy_stuff
│   │   ├── Droidnix
│   │   │   ├── hypr
│   │   │   │   ├── conf.d
│   │   │   │   └── scripts
│   │   │   └── wallpaperstuff
│   │   │       ├── pictures
│   │   │       ├── videos
│   │   └── kitty
│   │       ├── kitty.conf
│   │       └── themes
│   │           └── Catppuccin-Mocha.conf
│   ├── hyprland
│   │   ├── conf
│   │   ├── scripts
│   │   └── themes
│   ├── machines
│   │   ├── maindroid
│   │   └── traveldroid
│   │       ├── configuration.nix
│   │       ├── hardware-configuration.nix
│   │       └── home.nix
│   └── mangowc
│       ├── conf
│       ├── scripts
│       └── themes
├── flake.nix
├── generated/
│   ├── common/               # Shared modules (e.g., firewall, starship, themes)
│   │   ├── firewall/         # Dendritic module: NixOS + Home Manager for firewall
│   │   │   ├── default.nix
│   │   │   └── README.md
│   │   ├── starship/         # Dendritic module: Starship prompt
│   │   │   ├── default.nix
│   │   │   └── README.md
│   │   ├── themes/           # Shared themes (fonts, icons, etc.)
│   │   │   ├── fonts/
│   │   │   │   └── default.nix
│   │   │   ├── gtk/
│   │   │   │   └── default.nix
│   │   │   └── icons/
│   │   │       └── default.nix
│   │   └── ...               # Other shared modules
│   ├── hyprland/             # Hyprland-specific modules
│   │   ├── hyprland/         # Dendritic module: Hyprland WM + plugins
│   │   │   ├── default.nix
│   │   │   └── README.md
│   │   ├── waybar/           # Dendritic module: Waybar config
│   │   │   ├── default.nix
│   │   │   └── README.md
│   │   ├── rofi/
│   │   │   ├── default.nix
│   │   │   └── README.md
│   │   └── ...               # Other Hyprland-related modules
│   └── mangowc/              # Mangowc-specific modules
│       ├── mangowc/          # Dendritic module: Mangowc WM + plugins
│       │   ├── default.nix
│       │   └── README.md
│       └── waybar/
│           ├── default.nix
│           └── README.md
├── README.org            # Literate documentation for all modules
└── flake.nix             # Main flake: imports modules from common/hyprland/mangowc

First Setup

Clone this repository.
Run the setup script: ./setup_droidnix.sh.
Edit .assets/common/conf/base.conf to choose your window manager (wm = "hyprland" or wm = "mangowc").
Tangle this Org file to generate Nix configurations: C-c C-v t in Emacs or use this: emacs README.org --batch -f org-babel-tangle && emacs --batch --eval "(setq org-html-htmlize-output-type nil)" README.org -f org-html-export-to-html
Build and switch: sudo nixos-rebuild switch --flake .#<hostname>.

—

The Assets Folder assets

The .assets/ folder contains all static files, such as configs, scripts, and themes. These files are not generated and can be edited directly.

`.assets/common/`

This folder contains files shared across both window managers, such as wallpapers, shell configs, and common scripts.

conf/base.conf: Defines the window manager choice and other global settings.
scripts/: System-wide scripts (e.g., utilities, helpers).

`.assets/hyprland/`

Hyprland-specific assets, including configs, themes, and scripts.

conf/: Hyprland configuration files (e.g., hyprland.conf).
themes/: Hyprland-specific theme scripts.
scripts/: Hyprland-specific scripts.

`.assets/mangowc/`

Mangowc-specific assets, including configs, themes, and scripts.

conf/: Mangowc configuration files.
themes/: Mangowc-specific theme scripts.
scripts/: Mangowc-specific scripts.

`.assets/machines/`

Machine-specific NixOS configurations (e.g., configuration.nix for maindroid and traveldroid).

—

The Actual Code code

This section contains the Org blocks for tangling Nix code into the generated folders.