Design Decisions

Key Features

GNU Stow Management

Stow creates symlinks from your home directory to the dotfiles repo:

# Install modules
stow zsh nvim git

# Result:
# ~/.zshrc -> ~/dotfiles/base/zsh/.zshrc
# ~/.config/nvim -> ~/dotfiles/base/nvim/.config/nvim
# ~/.gitconfig -> ~/dotfiles/base/git/.gitconfig

# Uninstall modules
stow -D zsh

Modular Design

Pick only what you need:

# Minimal (server)
stow zsh git

# Full desktop
stow zsh nvim git tmux ssh scripts hyprland

Cross-Platform

Separate modules for platform-specific config:

# Linux
cd ~/dotfiles/base && stow zsh nvim git
cd ~/dotfiles/linux && stow systemd hyprland

# macOS
cd ~/dotfiles/base && stow zsh nvim git
cd ~/dotfiles/macos && stow homebrew