Dotfiles

Personalized dotfiles for Unix and macOS systems, providing a tailored environment setup for efficient and comfortable usage.

Requirements

• Git
• Stow
• Make

Installation

1. Install required software

xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install stow make

2. Clone Repository

git clone [email protected]:boostvolt/.dotfiles.git
cd .dotfiles

3. Apply macOS configuration

make macos

4. Install Homebrew packages

make brew

5. Apply or update setup configuration

make install
# ... or incremental update via:
make update

6. Verify installation

make verify

Make Targets

Target	Description
install	Symlink dotfiles and setup Claude settings
update	Adopt local changes back into dotfiles repo
macos	Apply macOS system preferences
brew	Install Homebrew packages and enable autoupdate
verify	Validate symlinks and required tools are present

Local Overrides

For machine-specific configuration that shouldn't be tracked in git:

• ~/.zprofile.local - Environment variables, PATH additions
• ~/.zshrc.local - Shell aliases, functions, local settings

These files are sourced automatically if they exist.

Troubleshooting

Symlinks not created

# Check if stow is working
stow --version

# Re-run install with verbose output
stow -v --restow --target="$HOME" --dir="$HOME/.dotfiles" .

Conflicting files

If stow fails due to existing files:

# Backup and remove conflicting file
mv ~/.zshrc ~/.zshrc.backup

# Re-run install
make install

Verification fails

# Run verify to see which checks fail
make verify

# Common fixes:
# - Re-run `make install` if symlinks are missing
# - Run `brew bundle --file=extra/homebrew/Brewfile` if tools are missing