Dotfiles
A portable macOS development environment built from version-controlled shell, Git, Homebrew, editor, and system configuration.
Project overview
Built with
- Shell
- Homebrew
- Zsh
- Git
Project story
The problem
A new Mac should not mean rebuilding a development environment from memory. Shell aliases, Git defaults, packages, editor settings, and system preferences are easy to lose and tedious to recreate by hand.
The solution
Dotfiles turns that setup into a version-controlled, repeatable system. Dotbot applies the symlink map from symlinks.yaml, while installation scripts configure XDG directories, shell tools, Homebrew packages, macOS applications, and system preferences.
Highlights
- Zsh configuration with custom aliases, functions, plugins, and environment variables
- Git configuration and global ignore rules
- Homebrew package definitions through a Brewfile
- VS Code, Neovim, Starship, bat, fzf, tmux, and other developer-tool configuration
- macOS application and preference setup scripts
- Backup and XDG migration utilities for keeping the environment portable
The result
Running the bootstrap flow brings a fresh Mac back to a familiar development workstation with less manual setup and fewer forgotten preferences. The process is safe to repeat, so the environment can keep evolving alongside the projects it supports.
