Repository files navigation

Laptop is a script to set up an OS X computer for web development.

It can be run multiple times on the same machine safely.It installs, upgrades, or skips packagesbased on what is already installed on the machine.

We support:

• OS X El Capitan (10.11)
• OS X Yosemite (10.10)

Older versions may work but aren't tested. Bug reports for olderversions are welcome.

Begin by opening the Terminal application on your Mac. The easiest way to openan application in OS X is to search for it via [Spotlight]. The defaultkeyboard shortcut for invoking Spotlight iscommand-Space. Once Spotlightis up, just start typing the first few letters of the app you are looking for,and once it appears, pressreturn to launch it.

In your Terminal window, copy and paste each of these two commands one at atime, then pressreturn after each one to download and execute thescript, respectively:

curl --remote-name https://raw.githubusercontent.com/istrategylabs/laptop/master/macbash mac2>&1| tee~/laptop.log

Thescript itself isavailable in this repo for you to review if you want to see what it doesand how it works.

Note that the script will ask you to enter your OS X password at variouspoints. This is the same password that you use to log in to your Mac.If you don't already have it installed, GitHub for Mac will launchautomatically at the end of the script so you can set up everything you'llneed to push code to GitHub.

Once the script is done, make sure to quit and relaunch Terminal.

Your last Laptop run will be saved to~/laptop.log. Read through it to see ifyou can debug the issue yourself. If not, copy the lines where the scriptfailed into anew GitHubIssue for us. Or, attach thewhole log file as an attachment.

• Flux for adjusting your Mac's display color so you can sleep better
• GitHub for Mac for setting up your SSH keys automatically
• Homebrew for managing operating system libraries
• Homebrew Cask for quickly installing Mac apps from the command line
• Homebrew Services so you can easily stop, start, and restart services
• hub for interacting with the GitHub API
• ImageMagick for cropping and resizing images
• MySQL for storing relational data
• Node.js andNPM, for running apps and installing JavaScript packages
• PhantomJS for headless website testing
• Postgres for storing relational data
• Python 3 for programming software and data analysis
• Redis for storing key-value data
• RVM for managing Ruby versions (includes [Bundler] and the latestRuby)
• Slack for communicating with your team
• Sublime Text 3 for coding all the things
• Virtualenv for creating isolated Python environments
• Virtualenvwrapper for extending Virtualenv
• Zsh as your shell

It should take less than 15 minutes to install (depends on your machine andinternet connection).

Your~/.laptop.local is run at the end of themac script.Put your customizations there. This repo already contains a.laptop.localyou can use to get started. It lets you install the following tools(commented out by default):

• Atom - GitHub's open source text editor
• Exuberant Ctags for indexing files for vim tab completion
• Firefox for testing your website on a browser other than Chrome
• iTerm2 - an awesome replacement for the OS X Terminal
• reattach-to-user-namespace to allow copy and paste from Tmux
• Tmux for saving project state and switching between projects
• Vim for those who prefer the command line

For example:

#!/bin/sh# brew_cask_install 'atom'# brew_cask_install 'firefox'brew_cask_install'iterm2'# brew_install_or_upgrade 'vim'# brew_install_or_upgrade 'ctags'# brew_install_or_upgrade 'tmux'# brew_install_or_upgrade 'reattach-to-user-namespace'

Write your customizations such that they can be run safely more than once.See themac script for examples.

Laptop functions such asfancy_echo,brew_install_or_upgrade,gem_install_or_update, andbrew_cask_install can be used in your~/.laptop.local.

# Go to your OS X user's root directorycd~# Download the sample file to your computercurl --remote-name https://raw.githubusercontent.com/istrategylabs/laptop/master/.laptop.local

ThisISL project is based on18F's laptop project, which was originally based onthoughtbot's laptop project.

thoughtbot's original work remains covered under anMIT License.

18F's work on this project is in the worldwidepublic domain, as are contributions to our project. As stated inCONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through theCC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.

ISL's original work is covered under a MIT License.