A shell script to transform a macOS laptop into an incredible web and mobile development environment.
Updated branches and git log
Error on spelling check
Updated README

refs

master
browse log

clone

read-only
https://git.sr.ht/~jss/laptop
read/write
git@git.sr.ht:~jss/laptop

laptop 💻

🔧 A shell script to transform a macOS laptop into an incredible web and mobile development environment.

You can run this script in the same machine multiple times safely. It will install, upgrade and skips packages based on what you currently have installed.

Requirements

We support:

  • macOS Mavericks (10.9)
  • macOS Yosemite (10.10)
  • macOS El Capitan (10.11)
  • macOS Sierra (10.12)
  • macOS High Sierra (10.13)
  • macOS Mojave (10.14)

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

Install

Download the script:

curl --remote-name https://git.sr.ht/~jss/laptop/blob/master/mac

Review the script (avoid running scripts you haven't read!):

less mac

Execute the downloaded script:

sh mac 2>&1 | tee ~/laptop.log

Optionally, review the log:

less ~/laptop.log

Optionally, install jss/dotfiles.

Debugging

Your last laptop script run will be saved to ~/laptop.log. Read through it to see if you can debug the issue yourself. If not, copy the lines where the script failed into a new issue for me. Or, attach the whole log file as an attachment.

What it sets up

macOS tools:

  • Homebrew for managing operating system libraries.

Unix tools:

  • [wget] for retrieving content from web server
  • [htop] for viewing process and managing them
  • [iftop] for monitoring network connections
  • [thefuck] for correcting your previous console command
  • [tree] for producing depth-indented listing of files
  • [unrar] for uncompressing rar files
  • [dockutil] for managing dock items
  • openssl for Transport Layer Security (TLS)
  • thesilversearcher for finding things in files
  • git for version control
  • tmux for saving project state and switching between projects
  • watchman for watching for filesystem events
  • zsh as your shell
  • [vim] as your editor

GitHub tools:

  • hub for interacting with the GitHub API

Programming languages, package managers, and configuration:

  • ASDF for managing programming language versions
  • [bundlr] for managing Ruby libraries
  • Node.js and NPM, for running apps and installing JavaScript packages
  • Ruby stable for writing general-purpose code
  • [Python3] stable for writing general-purpose code
  • [Composer] package manager for PHP
  • Yarn for managing JavaScript packages

Databases:

  • Postgres for storing relational data
  • Redis for storing key-value data

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

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.

Contributing

Edit the mac file. Document in the README.md file. Follow shell style guidelines by using ShellCheck and Syntastic.

brew install shellcheck

Thank you, contributors!

License

It is free software, and may be redistributed under the terms specified in the LICENSE file.