Arch Linux + GNOME dotfiles, managed with GNU Stow.

All packages installed:

stow --no-folding fish zsh tmux git ghostty starship fastfetch zed fontconfig color gnome btop electron scripts

snapshots/ holds point-in-time exports that are not symlinked — they're inputs for restoring state on a fresh machine.

Regenerate snapshots: ./snapshot.sh. Run before committing dotfiles changes.

• pacman.conf — system file, copy manually to /etc/pacman.conf if needed.
• backup.sh — rsync-based external disk backup script. Edit DEST_BASE_DIR before use.

• ~/.config/gh/ — contains OAuth tokens. Use gh auth login after fresh install.
• ~/.ssh/, ~/.gnupg/ — secrets. Back up out-of-band.
• ~/.icons/, ~/.local/share/icons/ — icon themes (~40 MB). Reinstall via package manager.
• ~/.local/share/gnome-shell/extensions/ — tracked as list in snapshots/gnome-extensions.txt; reinstall, don't symlink.
• Browser profiles (~/.mozilla, ~/.config/google-chrome) — use backup.sh rsync target instead.

git clone <repo> ~/dotfiles
cd ~/dotfiles

# 1. Install packages
sudo pacman -S --needed - < snapshots/pkglist.txt
yay -S --needed - < snapshots/aurlist.txt   

# 2. Install stow + apply configs
sudo pacman -S stow
stow --no-folding fish zsh tmux git ghostty starship fastfetch zed fontconfig color gnome btop electron scripts

# 3. Restore GNOME settings
dconf load /org/gnome/ < snapshots/gnome-dconf.ini

# 4. Reinstall GNOME extensions listed in snapshots/gnome-extensions.txt (via Extensions app)

Stowed configs are symlinks — editing the live file (e.g. ~/.zshrc) edits the repo file directly. To capture changes:

cd ~/dotfiles

# 1. Refresh snapshots (dconf dump, extension list, pkglist, aurlist).
./snapshot.sh

# 2. Review what changed.
git status
git diff

# 3. Stage + commit + push.
git add -A
git commit -m "update configs"
git push

Run ./snapshot.sh whenever:

• You change a GNOME setting via Settings / Tweaks / an extension.
• You install or remove a package (pacman -S, paru -S, etc.).
• You install or remove a GNOME shell extension.

The script auto-filters known secret patterns (GitHub PATs, OpenAI keys, AWS keys, etc.) from the dconf dump and bails if a token-shaped value survives. If you add an extension that stores credentials under a new key name, extend SECRET_KEYS_REGEX in snapshot.sh.

1. Create a new top-level dir named after the app.
2. Mirror the target path relative to $HOME inside it. For ~/.config/foo/bar.conf → foo/.config/foo/bar.conf.
3. mv ~/.config/foo/bar.conf foo/.config/foo/bar.conf && stow --no-folding foo.