Dotfiles

Personal macOS development environment.

Quick Start

Prerequisites

Install these before running bootstrap:

1. Xcode Command Line Tools

   xcode-select --install

2. Homebrew

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

3. Restart your terminal (only needed if you just installed Homebrew)

New Machine

curl -fsSL https://raw.githubusercontent.com/rafaelcruzazevedo/dotfiles/master/bootstrap | zsh

Existing Machine

cd ~/.dotfiles
./bootstrap

This shows an interactive menu:

> Install (fresh setup)
  Update (pull + re-apply)
  Uninstall (remove all)
  Dry Run (preview changes)

Command Line

./bootstrap install           # Fresh install
./bootstrap update            # Pull + re-apply
./bootstrap uninstall         # Remove all
./bootstrap install --dry-run # Preview changes
./bootstrap help              # Show help

Troubleshooting

Icons not displaying

brew install font-meslo-lg-nerd-font

Set font in iTerm2: Preferences > Profiles > Text

Starship prompt not showing

brew install starship

fzf key bindings not working

$(brew --prefix)/opt/fzf/install --key-bindings --completion --no-update-rc --no-bash --no-fish

zplug plugins not loading

zplug install && zplug load

---

Full documentation | MIT License