Works on *nix, optimized for macOS. Managed using Stow
Vim script Shell CSS CoffeeScript

My dotfiles.

Works on *nix, optimized for OS X.

Managed using Stow, so you can pick and choose which programs to install.


Initially I tried entirely automating the entire install process, but quickly found it wasn't worth the maintenance. Starting from scratch happens so rarely for me that each time I was fiddling with the bootstrap scripts to work around a random issue (often due to a new version of OSX).

Instead, it's simpler to install stuff by hand, and manage only the configuration files (dotfiles) in this repo.

Install steps on a clean OSX machine:

  1. Make hidden files/folder visible in Finder: defaults write -g AppleShowAllFiles -bool true

  2. git clone ~/.dotfiles

    • If cloning to a server without a Github-connected SSH key use 'https' instead: git clone ~/.dotfiles
  3. Install desired binaries using your favorite package manager:

    • If on OSX, use Homebrew:
      1. Install Homebrew.
      2. Install Homebrew Bundle: $ brew tap Homebrew/bundle
      3. $ brew bundle --file=~/.dotfiles/homebrew/.Brewfile After the .Brewfile is symlinked into `~/.Brewfile, just use $ brew bundle --global.
    • Make sure Stow gets installed, we'll use this later to symlink the dotfiles.
    • Ruby:
      1. Use rvm instead of Homebrew. Much easier to manage gemsets, ruby versions, etc.
    • Node:
      1. Use nvm instead of Homebrew for managing Node.
      2. Install/upgrade manually using git rather than nvm's script.
      3. Unfortunately, nvm drastically slows shell startup time due to, so after installing node (nvm install node), run nvm unalias default to disable the alias. Just remember to first run nvm use node whenever you want to run webpack, etc.
  4. Make ZSH the default shell:

    1. $ sudo vim /etc/shells
    2. Append the path to zsh - Homebrew sticks it in /usr/local/bin/zsh
    3. Save and exit
    4. $ chsh -s /usr/local/bin/zsh
  5. Install Prezto:

    • Install my fork because it includes a plugin for Atom.

    git clone --recursive "${ZDOTDIR:-$HOME}/.zprezto"

    • The default Prezto instructions say to symlink the default config files. Don't do this; instead use Stow to symlink your own config files (instructions below).
    • To update Prezto: git pull && git submodule update --init --recursive
  6. Now use stow to symlink the various config files:

  7. Other apps I commonly install:

List of config files

  • Atom - Settings are stowable, but packages purposefully excluded. Use $ apm stars --install to install all packages I've starred on
  • bash
  • git
  • Homebrew Brewfile - stowable, brew bundle --global will use $HOME/.Brewfile
  • nvim - Neovim. No need to stow as it respects $XDG_CONFIG_HOME
  • python - not stowable, use pip install -r ~/.dotfiles/python/requirements.txt
  • ruby
  • tmux - #TODO
  • vim - for when Neovim isn't available
  • vimify - .inputrc and .editrc make vim commands work in many interactive shells, for example the mysql and postgres shells
  • zsh - includes prezto config files

Misc Notes:

List of possible macOS customizations:

For themes, check out the Base16 template system. It includes templates for theming many different apps.

Colorschemes that I like:

  • monokai
  • solarized
  • railscasts

Fonts that I like:

  • Ubuntu Monospace including powerline fix
  • Adobe Source Code (look for powerline fix)




Copyright 2015 Jeff Widman Licensed under the MIT License