🌟 Modern, modular NixOS configuration with automated CI/CD and intelligent bot assistance

• 🏗️ Modular Architecture - Clean system/user separation
• 🤖 Automated CI/CD - Testing, formatting, security checks
• 🔄 Auto-Updates - Weekly dependency updates via PRs
• 🛡️ Security First - Secret scanning & vulnerability checks
• 📦 Bot Commands - Interactive PR management (/bot help)
• 🎯 Multi-Desktop - GNOME, KDE, XFCE support

Component	Status
🧪 Flake Check
🏗️ Build Test
🔒 Security
🔄 Dependencies

├── flake.nix                    # Main flake configuration
├── hosts/default/               # Host-specific configs
└── modules/
    ├── nixos/                   # System modules
    └── home-manager/            # User modules

1. Setup hardware config:

   sudo nixos-generate-config
   sudo cp /etc/nixos/hardware-configuration.nix hosts/default/

2. Update personal info in flake.nix and modules/home-manager/git.nix

3. Deploy:

   sudo nixos-rebuild switch --flake .#nixos

# System rebuild
sudo nixos-rebuild switch --flake .#nixos

# Update dependencies
nix flake update

# Validate configuration
nix flake check

# Development environment
nix develop

# Run tests
./test.sh

# Cleanup
sudo nix-collect-garbage -d

• System packages: Edit modules/nixos/system.nix
• User packages: Edit modules/home-manager/packages.nix
• Desktop environment: Change desktop option in configuration.nix

Build fails: Run nix flake check --show-trace
CI issues: Test locally with ./test-ci.sh or act -j check-flake
Rollback: sudo nixos-rebuild switch --rollback
Disk space in CI: Large packages (TeXLive) auto-excluded via NIXOS_CI_BUILD=true
Kernel module errors: CI environment automatically excludes hardware-dependent packages

Package Collision: If you get "collision between packages", check for duplicates:

• Don't install packages via both packages.nix and programs.* configuration
• Example: Remove neovim from packages if using programs.neovim.enable = true

Hardware Config: Update hosts/default/hardware-configuration.nix with real values:

sudo nixos-generate-config --root /mnt
# Copy generated hardware-configuration.nix to hosts/default/

Path not in Nix store: Usually caused by placeholder UUIDs in hardware config

• NixOS Manual
• Package Search
• Options Search
• CI/CD Docs

Contributions are welcome! Please read our Contributing Guidelines and Code of Conduct before submitting pull requests.

Happy NixOS-ing! 🎉