Laptop

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 packages based on what is already installed on the machine.

Requirements

• macOS Ventura (13.0.1)

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

Install

Download, review, then execute the script:

curl --remote-name https://raw.githubusercontent.com/xuncheng/laptop/master/mac
sh mac 2>&1 | tee ~/laptop.log

The script itself is available in this repo for you to review if you want to see what it does and how it works.

Note that the script will ask you to enter your OS X password at various points. This is the same password that you use to log in to your Mac.

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

Debugging

Your last Laptop run will be saved to ~/laptop.log. Read through it to see if you can debug the issue yourself. If not, copy and paste the entire log into a new GitHub Issue for us.

What it sets up

macOS tools:

• 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

Unix tools:

• Exuberant Ctags for indexing files for vim tab completion
• Git for version control
• OpenSSL for Transport Layer Security (TLS)
• Selecta A fuzzy text selector for files and anything else you need to select.
• The Silver Searcher for finding things in files
• Tmux for saving project state and switching between projects
• Zsh as your shell

Image tools:

• ImageMagick for cropping and resizing images

Testing tools:

• Qt for headless JavaScript testing via Capybara Webkit

Programming languages and configuration:

• Bundler for managing Ruby libraries
• NVM for managing Node.js versions if you do not have Node.js already installed (Includes latest Node.js and NPM, for running apps and installing JavaScript packages)
• RVM for managing Ruby versions (includes Bundler and the latest Ruby)
• Ruby stable for writing general-purpose code

Databases:

• Redis for storing key-value data

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

Customize in ~/.laptop.local

Your ~/.laptop.local is run at the end of the Laptop script. Put your customizations there. For example:

#!/bin/sh

brew bundle --file=- <<EOF
brew "Caskroom/cask/dockertoolbox"
brew "go"
brew "ngrok"
brew "watch"
EOF

default_docker_machine() {
  docker-machine ls | grep -Fq "default"
}

if ! default_docker_machine; then
  docker-machine create --driver virtualbox default
fi

default_docker_machine_running() {
  default_docker_machine | grep -Fq "Running"
}

if ! default_docker_machine_running; then
  docker-machine start default
fi

fancy_echo "Cleaning up old Homebrew formulae ..."
brew cleanup
brew cask cleanup

if [ -r "$HOME/.rcrc" ]; then
  fancy_echo "Updating dotfiles ..."
  rcup
fi

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

Laptop functions such as fancy_echo and gem_install_or_update can be used in your ~/.laptop.local.

Credits

This laptop script is originally based on thoughtbot's laptop script.