Dotfiles

This repo manages symlinked dotfiles with GNU Stow.

Repository layout

• stow/: stow packages (for example, stow/shared)
• install/: setup scripts (for example, install/bootstrap.sh)

Prerequisites

• git
• GNU Stow (stow)

Install Stow:

• macOS (Homebrew): brew install stow
• Debian/Ubuntu: sudo apt install stow
• Fedora: sudo dnf install stow

Configure dotfiles with bootstrap script

1. Clone the repo:

   git clone https://github.com/TheExeQ/dotfiles ~/dotfiles
   cd ~/dotfiles

2. Optional: preview changes without modifying files:

   ./install/bootstrap.sh --dry-run

3. Apply configuration:

   ./install/bootstrap.sh

What bootstrap.sh does

• Verifies stow is installed.
• Uses your home directory ($HOME) as the stow target.
• Uses stow/ as the stow package directory.
• Always stows the shared package.
• Also stows one OS-specific package:
  • mac on macOS (Darwin)
  • linux on Linux
• If a package directory is missing, it is skipped.
• Supports --dry-run, --undo and --help.

Re-running

You can safely re-run ./install/bootstrap.sh after updates to re-apply symlinks.