How craftaholic/dotfiles works
Project type and purpose
• This is a dotfiles/configuration‐management framework (an open-source tool) whose goal is to centralize and declaratively manage all your workstation configuration files (hyprland, sway, nvim, Waybar, WezTerm, etc.) in one Git repository.
• It uses Taskfile as a task runner to bootstrap the environment and Devbox to install and pin required binaries.
File structure
• Top‐level:
• Taskfile.yml – orchestrates setup tasks (symlinks, installs)
• devbox.json – declarative list of required CLI tools (git, zsh, etc.)
• config/ – contains subdirectories for each application config (hypr, sway, nvim, swaylock, waybar, wezterm, libinput-gestures)
• Inside each config subfolder are the actual dotfiles and helper scripts (e.g., hypr/UserScripts, nvim lua modules).
• No “frontend” or “backend” here; it’s a local tool that integrates with the OS and installs software.
README for additional insights
• Setup flow: task setup [--force]
• Installs Devbox if missing
• Creates ~/.config directories and symlinks pointing to repo files
• Installs binaries via Devbox
• Emphasis on idempotency and declarative updates: updating the repo automatically updates real configs via symlinks.
Elements
• Clear labels: e.g., “Taskfile.yml”, “devbox.json”, “config/hypr”, etc.
• from Taskfile to Devbox (install binaries)
• from Taskfile to ~/.config (create symlinks)
• from applications back to ~/.config (read config)