Dotfiles

Managed with GNU Stow for easy symlink management.

Prerequisites

# macOS
brew install stow

# Linux
sudo apt install stow      # Debian/Ubuntu

Quick Start

cd ~/dotfiles
stow -t ~ <package>  # e.g., stow -t ~ zsh

Managing Packages

From the dotfiles directory:

Install (symlink) a package

stow -t ~ <package>

Remove (unlink) a package

stow -D -t ~ <package>

Re-symlink (after updates)

stow -R -t ~ <package>

Install all packages

stow -t ~ */

Adding New Configurations

1. Create package directory: mkdir -p <package>/.config/<app>
2. Add config files following the home directory structure
3. Symlink with stow -t ~ <package>

How it works: Stow creates symlinks by mirroring the directory structure from the package to the target directory (~). Files inside each package are structured as if the package directory itself is your home directory.

Example structure:

dotfiles/
├── zsh/
│   └── .zshrc              → symlinks to ~/.zshrc
└── btop/
    └── .config/
        └── btop/
            └── btop.conf   → symlinks to ~/.config/btop/btop.conf

Setup

• Setup ssh key ⇒ ssh-keygen -t rsa

---