Master repo for a Hyprland desktop on Arch Linux. Dotfiles are organized as GNU Stow packages (one top-level dir per app, mirroring $HOME), and an interactive TypeScript CLI drives package installation, symlinking, updates, and removal.

Prerequisites

sudo pacman -S --needed stow nodejs npm

(yay is bootstrapped automatically by install if missing.)

Usage

npm install
npm start install   # interactive: choose packages, installs them, backs up
                     # conflicting files, symlinks dotfiles into $HOME
npm start update     # pacman -Syu + yay -Syu, then re-links any new files
npm start remove     # removes symlinks, restores the most recent backup
                      # (does NOT uninstall packages)

Backups of any pre-existing files that would have collided with a symlink are stored at ~/.dotfiles-backup/<timestamp>/. remove restores the most recent one automatically; to restore an older one manually:

cp -a ~/.dotfiles-backup/<timestamp>/. ~/

Which packages/dirs were chosen at install time is recorded in ~/.config/dotfiles/state.json, so update/remove know what to act on without re-prompting.

install also installs SDDM and enables its systemd service (so Hyprland actually starts at next boot), and auto-detects installed GPU(s) via lspci to propose NVIDIA/AMD/Intel driver packages (confirm/override before they're installed). If NVIDIA is kept, the required Wayland env vars are written to ~/.config/hypr/conf.d/nvidia.lua (machine-generated, not stowed) and sourced from hyprland.lua.

Wallpaper

Default wallpaper by rahremix (via github.com/PsychedelicPalimpsest/dotfiles).

Adding a new app

Add a directory under packages/ mirroring its $HOME layout (e.g. packages/foo/.config/foo/config), and add an entry to src/packages.ts with the matching package name (and dir if it differs, or a group if it's a mutually-exclusive alternative to another package).

Testing in a container

./docker/test.sh runs a disposable Arch container with stow/nodejs/npm preinstalled and the repo copied in, without touching the host:

./docker/test.sh                        # interactive shell, deps installed
./docker/test.sh "npx tsc --noEmit"     # run one command non-interactively