Hyprland Dotfiles

Dotfiles for a Hyprland/Wayland desktop on Fedora (with Arch support), managed with chezmoi. Work/personal machine split via template conditionals, Material You theming via lmtt, and a declarative package registry audited by Claude.

🚀 Quick Start

Fresh Installation

One command on a virgin machine (installs git/jq/rbw/chezmoi via the package manager, walks through Bitwarden login so identity prompts are pre-seeded, then runs chezmoi init --apply):

sh -c "$(curl -fsLS https://raw.githubusercontent.com/MasonRhodesDev/dotfiles/main/bootstrap.sh)"

All machine-varying private data is fetched once per machine from a single Bitwarden secure note (chezmoi-data) at init, then persisted in ~/.config/chezmoi/chezmoi.toml — never stored in this public repo. Fields:

Field	Purpose
name, email_work, email_personal	git author identity
git_overrides	JSON array of {condition, identity} git includeIf rules (dir- or org-based); drives ~/.gitconfig
work_claude_md	work-only design/brand block injected into ~/.claude/CLAUDE.md
work_overlay_repo	git URL of the private overlay repo (work files, e.g. Claude templates)

Only name/emails have a prompt fallback; the rest degrade to safe defaults if absent. If any value changes in Bitwarden later, run chezmoi-refresh-identity. rbw uses pinentry-curses so unlock works over a plain TTY/SSH during init.

Existing Machine

# Pull latest changes
chezmoi update

# Check for differences
chezmoi diff

# Apply changes
chezmoi apply

📁 Repository Structure

.
├── dot_config/              # ~/.config applications
│   ├── hypr/               # Hyprland compositor config
│   ├── hypr/profiles/      # Monitor profiles consumed by hyprstate
│   ├── nvim/               # Neovim configuration
│   ├── waybar/             # Status bar configuration
│   ├── matugen/            # Theme generation templates
│   └── ...
├── dot_local/bin/          # Local executables
├── scripts/                # Utility scripts (deployed to ~/scripts)
├── software_installers/    # packages.toml registry (repo-only, see docs)
├── .chezmoiscripts/        # run_once / run_onchange lifecycle scripts
└── docs/                   # Detailed documentation (repo-only)

🎨 Theme System

Theming is handled by lmtt (Linux Multi-Theme Toggle), a standalone tool that generates Material You colors with matugen and injects them into application configs:

lmtt switch light|dark|toggle   # Switch themes
lmtt status                     # Current theme
lmtt list                       # Installed modules

Generated files are prefixed lmtt-* and excluded from chezmoi via .chezmoiignore.

💻 Key Applications

Category	Application	Config Location
Compositor	Hyprland	~/.config/hypr/
Terminal	Wezterm	~/.config/wezterm/
Editor	Neovim / Zed	~/.config/nvim/, ~/.config/zed/
Shell	Fish + Oh My Posh	~/.config/fish/
Status Bar	Waybar	~/.config/waybar/
Launcher	Fuzzel	~/.config/fuzzel/
Notifications	SwayNC	~/.config/swaync/
System Monitor	Btop	~/.config/btop/

🔧 Common Tasks

Adding New Files

# Add a config file to chezmoi
chezmoi add ~/.config/newapp/config.conf

# Add a script
chezmoi add ~/scripts/my-script.sh

Managing Templates

# Test template rendering
chezmoi execute-template < ~/.local/share/chezmoi/dot_config/example.tmpl

# Edit templates
chezmoi edit ~/.gitconfig

Monitoring Changes

# Check chezmoi status
chezmoi status

# See what would be applied
chezmoi diff

📚 Documentation

• Software Package Registry
• Theme System
• Hyprland Configuration
• Neovim Setup
• Chezmoi Workflow

greetd Login Manager

The greetd configuration has been extracted to its own standalone repo:

MasonRhodesDev/greetd-config — cloned to /opt/greetd-config

# First install
sudo /opt/greetd-config/install.sh

# Update (uses saved options)
sudo /opt/greetd-config/install.sh --update

Static config files are symlinked from the repo into /etc/greetd/, so edits in /opt/greetd-config/ take effect immediately without re-running the installer.

⚠️ Important Notes

• Never use chezmoi apply --force - This can overwrite local changes
• Use chezmoi add to save changes - Don't edit deployed-file copies in .local/share/chezmoi directly
• Work/personal split - is_work (hostname-based) excludes gaming/Steam configs from work machines via .chezmoiignore. Work-only files (Claude templates) live in a private overlay repo (work_overlay_repo), cloned into ~/.claude/templates on work machines by run_onchange_after_35-sync-work-overlay — they are never committed to this public repo.

📄 License

MIT License.