Personal checklist for setting up a new Mac's dev environment.
Clone or download
Pull request Compare This branch is 6 commits ahead, 37 commits behind mdo:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Config is a basic checklist I follow to set up a new Mac's development environment. It gets me up to speed with Git, Ruby, GitHub, Jekyll, and more so I can more quickly get back to coding.


File Description
.bash-profile Customizes the prompt and echos the currently checked out Git branch.
.gitconfig Global Git configuration to specify my name and email, shortcuts, colors, and more.
.gitignore The ignore file from twbs/bootstrap that I use everywhere.
Preferences.sublime-settings My Sublime Text 2 user preferences.


1. Prep OS X

  • Download and install latest version of Xcode from the Mac App Store
  • Download and install Xcode command line tools

2. Download dependencies

  • Install common gems: $ gem install sass jekyll rouge
  • Download and run the Node.js Mac installer
  • Install Grunt command line tools: $ npm install -g grunt-cli

3. Secure Git(Hub) access

4. Prep

5. Setup Xcode + dependencies

6. Tweak Sublime Text 2 just right

I use Sublime Text 2 as ST3 had quite a few problems the first day I used it with Yosemite. You'll need to modify your approach below if you're using ST3.

import urllib2,os,hashlib; h = '7183a2d3e96f11eeadd761d777e62404' + 'e330c659d4bb41d3bdf022e94cab3cd0'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); os.makedirs( ipp ) if not os.path.exists(ipp) else None; urllib2.install_opener( urllib2.build_opener( urllib2.ProxyHandler()) ); by = urllib2.urlopen( '' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); open( os.path.join( ipp, pf), 'wb' ).write(by) if dh == h else None; print('Error validating download (got %s instead of %s), please try manual install' % (dh, h) if dh != h else 'Please restart Sublime Text to finish installation')

7. Download Atom

  • Install Atom itself
  • Add Spacegray UI theme and Ocean Dark color scheme
  • Enable atom Terminal commands: from, open the Atom menu and select Install Shell Commands

8. Install more tools

Use it yourself

Fork this repo, or just copy-paste things you need, and make it your own. Please be sure to change your .gitconfig name and email address though!

Works on my machine

Yup, it does. Hopefully it does on yours as well, but please don't hate me if it doesn't.