CollieIsCute/dotfiles

This dotfiles repo feels like it was built from real daily use, not just assembled to look nice on GitHub. The best part is how clearly the README explains the maintainer’s workflow: it covers the chezmoi install path, the supported platforms, the Catppuccin theme choices, the Hyprland home/office monitor split, tmux behavior, Kitty-on-macOS reasoning, fish aliases, and the actual tools being managed. That context is valuable because dotfiles are usually hard to learn from unless the author explains why things are configured a certain way.

The repo also looks thoughtfully organized. Using chezmoi as the backbone makes sense for a setup that spans macOS, Arch/CachyOS, Ubuntu, Debian, and Mint. The separation between package data, external theme pulls, bootstrap scripts, and config files makes the project easier to inspect than a pile of unrelated dotfiles. I especially like the notes about run_onchange_* scripts and embedded hashes, because that is the kind of practical problem people only document after running into it themselves.

A few things would make the repo friendlier to outsiders. The install command is simple, but I’d add a safer first-time path using chezmoi diff before chezmoi apply, since applying someone else’s dotfiles can overwrite important local config. A license would also help clarify whether others can reuse pieces of the setup. Finally, screenshots of the Hyprland/Waybar/Rofi environment would make the project much easier to evaluate visually.

Overall, this is a strong personal dotfiles repo with unusually useful documentation. It is most valuable as a real-world reference for people managing a multi-machine chezmoi setup across Linux and macOS.