This repository contains the configuration and dotfiles for my continuously evolving multi-PC setup (using Nix). All the devices I own, controlled by code. It also builds and deploys my website to maydayv7.site. You can follow along with my NixOS Desktop Series

Pictures

Note: These may be outdated

Hyprland

GNOME Desktop

Pantheon Desktop

Theming

• Starship Prompt Theme: Minimal, blazing-fast, and infinitely customizable prompt for any shell

• Bibata Cursor: Compact and material designed cursor set

• Papirus Icon Theme: Pixel perfect icon theme for Linux

• Catppuccin Theme: A community-driven Pastel Theme consisting of 4 soothing warm Flavors with 26 eye-candy Colors each

• Adwaita GTK3: Theme from libadwaita ported to GTK3

• KvLibadwaita Kvantum Theme: Integrates QT Apps with GNOME Desktop

• Firefox GNOME Theme: GNOME Theme for the Mozilla Firefox Browser, used for better desktop integration

• VS Code Adwaita Theme: Integrates Visual Studio Code with GNOME Desktop

• Discord GNOME Theme: A GNOME theme for Discord, following the Adwaita style & GNOME HIG

• Firefox Elementary Theme: Elementary OS Theme for the Mozilla Firefox Browser, used for better desktop integration

• VS Code Elementary Theme: Integrates Visual Studio Code with Pantheon Desktop

• Logseq Bonofix Theme: A clean Logseq theme with focus on long-time writing experience

Older...

XFCE Desktop

GNOME 45

GNOME 44

GNOME 41

• Device-Agnostic
• Convenient and Automated
• Hermetically Reproducible
• Declarative and Derivational
• Atomic, Generational and Immutable

• Supports multiple users and devices
• Configuration for multiple DEs and Compositors
• Incorporates PipeWire, Wayland, ...!
• Automatically builds and deploys my Website
• Credentials management using the sops-nix module and gnupg keys
• Comprehensive User Configuration using the home-manager module, with support for setting global conditionals and shared/user-specific configuration
• Ephemeral, Opt-In filesystem state using the impermanence module and ZFS
• Support for Secure Boot using lanzaboote
• Support for multiple development shells integrated with direnv and lorri
• Automatic packages updates using update.sh
• Syntax formatting using treefmt
• Support for source filters with nix-filter
• Support for Base16 color theming using stylix
• Support for declaratively installing Flatpak applications using nix-flatpak
• Wrapped wine Applications using Emmanuel's Wrapper
• Support for Android Virtualisation using Waydroid
• Support for VFIO PCI Device Passthrough along with Looking Glass for high-performance VMs

Overview of File Hierarchy

$ nix flake show
github:maydayv7/dotfiles
├───apps
│   └───x86_64-linux
│       ├───sysutils: app
│       ├───hyprutils: app
│       ├───install: app
│       └───nixos: app
├───checks
│   └───x86_64-linux
│       ├───Device-iso: derivation 'nixos-rebuild'
│       └───treefmt: derivation 'treefmt-check'
├───devShells
│   └───x86_64-linux
│       ├───cc: development environment 'C'
│       ├───default: development environment 'devShell'
│       ├───format: development environment 'nix-shell'
│       ├───java: development environment 'Java'
│       ├───lua: development environment 'Lua'
│       ├───python: development environment 'Python'
│       ├───rust: development environment 'Rust'
│       ├───sql: development environment 'SQL'
│       ├───video: development environment 'Video'
│       └───website: development environment 'Website'
├───files: 'dotfiles' and program configuration
├───formatter
│   └───x86_64-linux: package 'treefmt'
├───legacyPackages
│   └───x86_64-linux (Default package channel)
├───lib: utility library functions
├───nixosConfigurations
│   ├───futura: NixOS configuration
│   ├───valkyrie: NixOS configuration
│   └───vortex: NixOS configuration
├───overlays
├───packages
│   └───x86_64-linux
│       ├───install: package 'os-install'
│       ├───nixos: package 'nixos'
│       └───website: package 'website-stable'
├───patchedPkgs: patched package source
├───systems: supported architectures
└───templates
    └───default: template: My NixOS Configuration

┌── flake.nix
├── flake.lock
├── files
├── site
├── devices
├── users
│   └── passwords
├── secrets
├── shells
├── checks
├── lib
│   ├── build.nix
│   ├── map.nix
│   └── pack.nix
├── scripts
│   ├── install.nix
│   └── nixos.nix
├── packages
│   └── overlays
└── modules
    ├── configuration.nix
    ├── apps
    ├── base
    ├── gui
    ├── hardware
    ├── nix
    ├── shell
    └── user

• flake.nix: toplevel configuration file and repository version control
  flake-parts is used for modularization

• files: dotfiles and program configuration

• site: personal website generated using zola

• devices: system configuration for various devices

• users: individual user-specific configuration

• secrets: authentication credentials management using sops-nix

• shells: sand-boxed shells for development purposes

• checks: configuration checks and continuous integration

• lib: custom functions designed for conveniently defining configuration

• scripts: useful system management scripts

• packages: locally built custom packages

• overlays: overrides for pre-built packages

• modules: custom configuration modules for additional functionality

• configuration.nix: builds system configuration

{
  description = "Minimal NixOS Configuration";

  ## System Repositories ##
  inputs = {
    ## Package Repositories ##
    # NixOS Package Repository
    nixpkgs.follows = "dotfiles/nixpkgs";

    ## Configuration Modules ##
    # My PC Dotfiles
    dotfiles.url = "github:maydayv7/dotfiles";
  };

  ## System Configuration ##
  outputs = inputs: let
    lib = with inputs; nixpkgs.lib // dotfiles.lib;
  in {
    nixosConfigurations.host = lib.build.device {
      name = "HOST_NAME";
      system = "x86_64-linux";

      imports = [
        # Generate using 'nixos-generate-config'
        ./hardware-configuration.nix

        # Passwords
        {
          users.extraUsers = {
            root.hashedPassword = "HASHED_PASSWORD";
            recovery.initialHashedPassword = "HASHED_PASSWORD";
          };
        }
      ];

      timezone = "Continent/City";
      locale = "US";

      kernel = "lts";
      kernelModules = ["nvme"];

      gui = {};
      hardware = {
        boot = "efi";
        cores = 4;
        fs.scheme = "simple";
        modules = [ /* Imported from 'nixos-hardware' */];
      };

      # Default User
      user = {
        name = "nixos";
        description = "Default User";
        minimal = true;
        password = "HASHED_PASSWORD"; # Generate using 'mkpasswd -m sha-512'
      };
    };
  };
}

nix build github:maydayv7/dotfiles#nixosConfigurations.install.config.system.build.images.iso

nix build github:maydayv7/dotfiles#install
sudo ./result/bin/os-install

nix build github:maydayv7/dotfiles#nixosConfigurations.DEVICE.config.system.build.images.iso

This repository contains my personal configuration, and may cause undesirable effects on other systems. It may also be subject to rapid undocumented changes, and uses Nix Flakes, an experimental feature

It is not recommended to use NixOS if you are a beginner just starting out, without acquaintance with either the command-line or functional programming languages, since the learning curve is steep, debugging issues is difficult, documentation is shallow, and the effort required/time spent isn't worth the hassle for a novice/casual user

May change according to available hardware

This configuration works well with an Intel CPU + iGPU, and is currently being improved to support an AMD APU + Nvidia GPU. Any other setup is untested
The hardware.modules option can be used to load relevant configuration from nixos-hardware

See this for additional information

The system build cache is publicly hosted using Cachix at maydayv7-dotfiles, and can be used while building the system to prevent rebuilding from scratch

This repository makes use of GitHub Actions in order to automatically check the configuration syntax on every commit and format it (using treefmt-nix), update the inputs and build the Install Media .iso every month, and upload the build cache to Cachix (You can also find GitLab CI/CD configuration in .gitlab). A git hook is used to check the commit message to adhere to the Conventional Commits specification

• ACCESS_TOKEN: Personal Access Token (To create one - GitHub, GitLab)
• CACHIX_TOKEN: Cachix Authentication Token

The home-manager module is used in tandem with the system configuration in order to define user-specific configuration. The config.user.homeConfig option, from which the final user configuration is built, has been declared in modules/user/default.nix in order to effortlessly configure shared configuration for all users of the system. The system config can be accessed using the sys parameter in home-manager modules

See: A Curated List of the Best Resources in the Nix Community
Also: This website for beginners starting out with NixOS and Flakes

• Official Documentation
• NixOS Manual
• Nix Pills
• NixOS Discourse
• NixOS Package Search
• nixpkgs Package Repository
• NUR Nix User Repository
• NixOS Hardware Modules
• Home Manager Options

• Tweag Article introducing Flakes
• Serokell's Blog on Flakes
• Jordan Isaac's Blog for porting configuration to Flakes
• Jon Ringer's Videos on General NixOS Tooling and Hackery
• Justin's Notes on using Nix
• Lan Tian's Series of Blog Posts on NixOS
• Christine's Blog Posts addressing NixOS Security
• Graham's and Elis' Blog Posts on Ephemeral Partition Schemes

Here are some repositories that I may have shamelessly rummaged through for building my dotfiles:
Thanks a lot! ;)

• 4JX
• balsoft
• bbigras
• cole-h
• colemickens
• davidtwco
• fufexan
• gvolpe
• hlissner
• jordanisaacs
• kclejeune
• lovesegfault
• lucasew
• nobbz
• rasendubi
• sioodmy
• tejing1
• vlaci
• wiltaylor
• wimpysworld

Last Updated: October 2025

If you like this project, consider leaving a star

V 7
maydayv7@gmail.com