MBP setup

Just a heads up, this setup is obviously very tailored to me. Therefore, it's probably best to fork this repository so you can tweak it to suit your needs 🙂.

Do the following in order…

Table of contents

• Dotfiles and shell scripts
  • Updating
  • .path and .extra
•  → About This Mac
  • Overview
  • Storage → Manage
• macOS defaults
• System preferences
  • General
  • Dock
  • Mission Control
  • Language & Region
  • Security & Privacy
  • Spotlight
  • Notifications
  • Displays
  • Energy Saver
  • Keyboard
  • Trackpad
  • iCloud
  • Internet Accounts
  • App Store
  • Bluetooth
  • Sharing
  • Users & Groups
  • Date & Time
• Finder
  • Preferences (⌘,)
  • View options
• Safari
  • Preferences (⌘,)
• TextEdit
  • Preferences (⌘,)
• Xcode command line tools
• Homebrew and formulae
  • Install
  • Formulae
• Sync Dropbox
• Non-Homebrew applications
  • App Store
• Set default app for file types
  • Mappings
• GitHub SSH key
• NVM
  • Yarn
    • Global packages
• Multiple NPM tokens
• Visual Studio Code
• 1Password
• Symlinks
• Lifesavers
• Credits

Dotfiles and shell scripts

Run these commands to install but make sure to swap out the repository URL (in step 2) for your forked repository URL:

1. cd ~/Projects
2. git clone https://github.com/chris-pearce/MBP-setup.git
3. cd MBP-setup
4. source bootstrap.sh

Steps 1–3 simply clone the repository to where you specify in step 1 (can be anywhere you like). In step 4, the bootstrap.sh does the following:

1. Get's latest of the remote master branch.
2. Copies (not symlinks) the dotfiles and relevant shell script files to your home folder.
3. Runs source ~/.bash_profile to load .bash_profile which in turn loads the rest of the relevant dotfiles.

Each file is well commented to help understand what's going on.

Updating

Important! Don't update the files in your home folder. If you need to make any updates then make them to the files in the folder where you cloned the repository (step 1–3 above).

Everytime you make an update to a dotfile and shell script file (except for bootstrap.sh) you'll need to run source bootstrap.sh. Additionally, source bootstrap.sh will automatically run when you pull changes from your remote repository.

.path and .extra

• If ~/.path exists, it'll be sourced along with the other files before any feature testing takes place (such as detecting which version of ls is being used).
• If ~/.extra exists, it'll be sourced along with the other files. Use this to add commands you don’t want to commit to a public repository (it's added to .gitignore).

 → About This Mac

Overview

• Select: Software Update….

Storage → Manage

• Recommendations:
  • Turn on: Empty Trash Automatically.
• Applications:
  • Remove:
    • iMovie.
    • GarageBand.

macOS defaults

$ cd ~
$ source macos.sh

System preferences

General

• Select: Ask to keep changes when closing documents.

Dock

• Remove all unwanted apps (right mouse clock → Remove from dock).
• Select: Magnification.
• Minimize windows using: Scale effect.
• Prefer tabs when opening documents: Always.
• Select: Automatically hide and show the Dock.

Mission Control

• Dashboard: As Space.
• Hot Corners:
  • TL: Mission Control.
  • TR: Launchpad.
  • BL: Put Display to Sleep.
  • BR: Dashboard.

Language & Region

• Time format: 24-Hour Time.

Security & Privacy

• General:
  • Require password: immediately after sleep or screen saver begins.
  • Allow apps downloaded from: App Store.
• FileVault:
  • Turn on.
• Firewall:
  • Turn on.
• Privacy:
  • Location Services:
  • Select: Weather.
  • Analytics:
    • Deselect everything.

Spotlight

• Deselect: Allow Spotlight Suggestions in Look up.

Notifications

• Do Not Disturb:
  • Select: When the display is sleeping.
• Mail and Messages:
  • Deselect: Show message preview.
• All Applications:
  • Use Banners.
  • Deselect: Show notifications on lock screen.

Displays

• Night Shift:
  • Schedule: Custom.
  • From: 18:00–05.30.

Energy Saver

• Battery:
  • Select: Enable Power Nap while on Battery Power.

Keyboard

• Keyboard:
  • Touch Bar shows: App Controls with Control Strip.
  • Customize Control Strip: Add Screen Lock.
• Shortcuts:
  • Full Keyboard Access: In windows and dialogs, press Tab to move keyboard focus between: All controls.

Trackpad

• Point & Click:
  • Look up & data selectors: Force Click with one finger.
  • Secondary click: Click or tap with two fingers.
  • Click: Light.
• Scroll & Zoom:
  • Deselect: Scroll direction: Natural.

iCloud

Deselect the following items:

• Photos
• Mail

Internet Accounts

• iCloud
• Google
• Facebook
• Twitter
• LinkedIn

App Store

• Automatically check for updates:
  • Select: Install macOS updates.
• Select: Automatically download apps purchased on other Mac computers.
• Password Settings:
  • Free Downloads: Save Password.

Bluetooth

• Select: Show Bluetooth in menu bar.

Sharing

• Computer's Name: [your-name].

Users & Groups

• Make sure you're an Admin.
• Login Items:
  • Remove iTunes.

Date & Time

• Clock:
  • Date options:
    • Select: Show date.

Finder

Preferences (⌘,)

• General:
  • Deselect all: Show these items on the desktop.
  • New Finder windows show: home directory.
• Tags:
  • Deselect all.
• Sidebar:
  • Select all except for:
    • iCloud Drive.
    • Movies.
    • Music.
    • Pictures.
    • Tags: Recent Tags.
• Advanced:
  • Select: Show all filename extensions.
  • Select: Keep folders on top when sorting by name.
  • When performing a search: Search the Current Folder.

View options

• Select: Devices → [your-MBP-name] in the sidebar.
• ⌘J:
  • Select: Always open in list view.
  • Select: Calculate all sizes.
  • Select: Show Library Folder.
  • Select: Use as defaults.

Safari

Preferences (⌘,)

• General:
  • Deselect: Open “safe” files after downloading.
• Advanced:
  • Smart Search Field:
    • Select: Show full website address.
  • Select: Show Developer menu in menu bar.

TextEdit

Preferences (⌘,)

• New Document:
  • Format: Plain Text.
  • Options: deselect all.
• Open and Save:
  • Plain Text File Rendering:
  • Opening files: Unicode (UTF-8).
  • Saving files: Unicode (UTF-8).

Xcode command line tools

$ xcode-select --install
$ sudo xcode-select --switch /Library/Developer/CommandLineTools # enable command line tools

For the second command, see here.

Homebrew and formulae

Install

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Formulae

$ cd
$ source brew.sh

Sync Dropbox

…and go shopping or something 🙂.

Non-Homebrew applications

• Apple Watch Screen Savers.

App Store

• Monosnap.

Set default app for file types

1. In Finder, right click on a file that uses the type you'd like to change the default for.
2. Select: Get Info from the context menu.
3. Navigate to the Open with section and select the app from the menu.
4. Select: Change All….
5. Select: Continue when/if Finder asks if you're sure.

Mappings

• Dotfiles: Visual Studio Code.
• Markdown files (.md): MacDown.
• Shell scripts (.sh): Visual Studio Code.

GitHub SSH key

1. Generating a new SSH key and adding it to the ssh-agent (make sure to do step 2 in the Adding your SSH key to the ssh-agent section).
2. Adding a new SSH key to your GitHub account.
3. Run this command: $ ssh-keyscan github.com >> ~/.ssh/known_hosts.

NVM

1. curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash
2. Run: source bootstrap.sh (see: Install Dotfiles and Shell Scripts → Updating). This'll override the .bashrc file in the home folder that the script in step 1 modified.
3. Run: command -v nvm to confirm it installed, the output should be: nvm.
4. Run: cd ~ then nvm install x where x is whatever version is in the .nvmrc file, e.g.: nvm install 9.11.1.

Yarn

brew install yarn --ignore-dependencies

Global packages

• yarn global add git-open
• yarn global add np

Multiple NPM tokens

If you need to manage multiple NPM tokens then add this to ~/.npmrc (creating the file if it doesn't exist: touch ~/.npmrc):

//registry.npmjs.org/:_authToken=${NPM_TOKEN}
update=false

You can then set your tokens in: .extra, e.g.:

# Store NPM tokens and set them to aliases so we can easily switch between them
alias npmme="export NPM_TOKEN=xxxx"
alias npmwork="export NPM_TOKEN=xxxx"
# Set the default
npmme

Run this command to see which account is in use:

npm whoami

Visual Studio Code

• Sync settings:
  1. Install the Settings Sync extension.
  2. ⌘ + SHIFT + P → Sync: Download Settings → Enter GitHub Token and Gist ID (get from 1Password).
  3. ⌘ + SHIFT + P → Sync: Advanced Options → Sync: Toggle Auto-Upload On Settings Change (requires window reload).
  4. ⌘ + SHIFT + P → Sync: Advanced Options → Sync: Toggle Show Summary Page on Upload / Download (requires window reload).
• ⌘ + SHIFT + P → Shell Command: Install 'code' command in PATH.

1Password

1. Choose Sync using Dropbox option then select the 1Password.oppvault file from Dropbox.

Symlinks

• .extra: ln -s ~/.extra ~/Dropbox/FED/Dotfiles

Lifesavers

• https://code.visualstudio.com/docs/editor/integrated-terminal#_why-is-nvm-complaining-about-a-prefix-option-when-the-integrated-terminal-is-launched

Credits

I couldn't put together my dotfiles and shell scripts without the awesome work of:

• Donne Martin and his dev-setup repository.
• Mathias Bynens and his dotfiles repository.
• Nicolas Gallagher and his dotfiles repository.
• Paul Irish and his dotfiles repository.
• Sourabh Bajaj and his macOS Setup Guide.

And anyone else who's been so kind to share their work out in the open.

❤️ open source.