@tnez/dotfiles

This is my collection of personal dotfiles.

Setting up on a new machine

1. Clone this repo: git clone https://github.com/tnez/dotfiles.git
2. Hop into directory: cd dotfiles
3. Run the bootstrap script: ./bootstrap.sh

Managing Homebrew dependencies

Dependencies are tracked in /Users/tnez/Code/tnez/dotfiles/brew/Brewfile and managed via brew bundle.

Adding a new package

./scripts/brew-add.sh <package>          # For formulas
./scripts/brew-add.sh <package> --cask   # For casks

Then manually:

1. Edit /Users/tnez/Code/tnez/dotfiles/brew/Brewfile to add description comment
2. Place entry alphabetically within its section
3. Commit: git add brew/Brewfile && git commit -m 'chore(brew): add <package>'

Upgrading packages

Weekly or as needed:

./scripts/brew-upgrade.sh

This upgrades all installed packages. The Brewfile.lock.json tracks the "last known good" state but only updates when running a full brew bundle install --global (which installs ALL packages in the Brewfile).

Understanding the lockfile

• Brewfile: Desired packages (manually curated, commented, alphabetized)
• Brewfile.lock.json: Auto-generated snapshot of package versions from last successful brew bundle install
• The lockfile enables rollback: git revert <commit> then brew bundle install --global

To update the lockfile (optional):

cd ~/Code/tnez/dotfiles
brew bundle install --global  # Installs any missing packages and updates lockfile
git add brew/Brewfile.lock.json
git commit -m 'chore(brew): update lockfile'

Managing stow packages

All packages use the --dotfiles flag to convert dot- prefixes:

stow --target=$HOME --dotfiles fish    # Links fish/dot-config/fish → ~/.config/fish
stow --target=$HOME --dotfiles nvim    # Links nvim/dot-config/nvim → ~/.config/nvim
stow --target=$HOME --dotfiles vim     # Links vim/dot-vimrc → ~/.vimrc
stow --target=$HOME --dotfiles git     # Links git/dot-gitconfig → ~/.gitconfig

To unstow a package:

stow --target=$HOME -D --dotfiles fish # Removes fish symlinks