ROADMAP.md

Hyprland Configuration Roadmap

Research and Planning

• Research most popular Hyprland configurations (#42)
• Analyze project color references (13 schemes) (#43)
• Research best practices for NVIDIA RTX 4060/Wayland (#44)
• Create roadmap.md (#45)

Base Structure

• Create project directory structure (#46)
  • hypr/ - Main Hyprland configuration
  • waybar/ - Status bar
  • rofi/ - App launcher
  • kitty/ - Terminal (integrated via external script)
  • dunst/ - Notifications
  • themes/ - Color schemes
  • wallpapers/ - Wallpapers
  • scripts/ - Helper scripts

Hyprland Configuration

• Create main hypr/hyprland.conf (#47)
• Configure monitors and resolution (#48)
• Configure keybindings (#49)
• Configure animations and visual effects (#50)
• Configure window decorations (#51)
• Configure workspaces (#52)
• Configure window rules (#53)
• Configure gestures (touchpad/touchscreen) (#54)
• Configure NVIDIA environment variables (#55)
• Configure autostart applications (#56)

Additional Components

• Configure Waybar (status bar) (#57)
  • Modules: workspaces, clock, battery, network, audio, etc.
  • CSS styles with project colors
• Configure Rofi (app launcher) (#58)
• Configure Kitty (via integrated script) (#59)
• Configure Dunst (notifications) (#60)
• Configure swww/hyprpaper (wallpapers) (#61)
• Configure wlogout (logout screen) (#62)
• Configure hyprlock (lock screen) (#63)
• Configure hypridle (idle management) (#64)
• Configure awww/hyprpaper (wallpapers) (#104)

Color Schemes

• Create dynamic theme system (#65)
• Implement 13 color schemes: (#66)
  • X (main theme)
  • Madrid
  • Lahabana
  • Seul
  • Miami
  • Paris
  • Tokio
  • Oslo
  • Helsinki
  • Berlin
  • London
  • Praha
  • Bogota
• Script to switch between themes (#67)

Installation Script

• Create install.sh with: (#68)
  • Distribution detection (Arch, Fedora, Debian, openSUSE)
  • Base dependencies installation
  • Hyprland and components installation
  • NVIDIA driver configuration:
    • Automatic GPU detection
    • RTX 4060 (and 40xx series)
    • RTX 3060/3070/3080/3090 (30xx series)
    • RTX 2060/2070/2080 (20xx series)
    • GTX 1660/1070/1080 (10xx/16xx series)
    • Support for AMD and Intel
  • Kernel parameters configuration
  • Initramfs configuration
  • Backup of existing configuration
  • Dotfiles installation
  • Systemd services configuration
  • Post-installation verification

Documentation

• Create complete README.md with: (#69)
  • Project description
  • System requirements
  • Installation guide
  • Configuration guide
  • Keybindings
  • Available color schemes
  • Common troubleshooting
  • Credits and license

Verification and Testing

• Verify file structure (37 files created) (#70)
• Test installation on real system (#71)

Multi-Monitor & GPU Performance

• Create workspaces.conf (workspace rules, smart gaps, scratchpads) (#72)
• Add multi-monitor workspace binding templates (#73)
• Add multi-monitor keybinds (SUPER+ALT combos) (#74)
• Create gpu-mode.sh (silent/normal/turbo, auto-detect GPU limits) (#75)
• Add GPU mode Waybar module with JSON output (#76)
• Add GPU mode Rofi/Wofi menu selector (#77)
• Add GPU keybinds (SUPER+F9) (#78)
• Update README.md with full documentation (#79)
• Update hyprland.conf with multi-monitor examples (#80)
• Test on RTX 5060 laptop (#81)
• Test on RTX 4060 laptop (#82)

Installer Robustness

• Add full Fedora package list (currently missing many packages vs Arch and X) (#83)
• Add openSUSE support to install.sh (#84)
• Complete distribution detection for Debian-based (build from source flow) (#85)
• Sync uninstall.sh with all installed components (missing rofi, wlogout, hyprlock, hypridle) (#86)
• Create update.sh to pull latest dotfiles without full reinstall (#87)
• Remove root fix scripts from project root (fix_hypr.py, force_fix.py, restore_hypr.py, fix_migration_errors.py) (#88)
• Add --dry-run flag to install.sh (preview changes without applying) (#89)
• Add version pinning/tagging for releases (#90)

CI & Quality

• Add ShellCheck linting for all .sh scripts (#91)
• Add Python linting for helper scripts (#92)
• Add CI workflow to validate install.sh --dry-run on Arch container (#93)
• Add CI workflow to validate theme JSON/config syntax (#94)
• Add CHANGELOG.md auto-generation from commits (#95)

UX & Desktop Polish

• Migrate Wofi to Rofi fully (Wofi is unmaintained) (#96)
• Add clipboard manager integration (cliphist + Rofi picker) (#97)
• Add media player widget to Waybar (playerctl) (#98)
• Add power profile integration (power-profiles-daemon or TLP) (#99)
• Verify XDG portals configuration (file picker, screen sharing) (#100)
• Add OSD notifications for brightness/volume changes (#101)
• Leave just few wallpapers and add the possibility to add more through the release XWall package (#102)