MacRustle 💻💨

Setup instructions "rustled up" for coding on a Mac.

---

Note: this documentation has not been updated for the new M1 Chip. It will be updates soon (06.01.21).

It can take time to setup a new mac for development.
MacRustle provides super basic instructions to help with this process.

---

Quick Setup | General | Standard Installations | Iterm | ZSH | XCode | Package Managers | Homebrew | Node | NVM | Git | Cask | Mas

---

General Utility Notes

• Generally written
• Read before following/using instructions
• File an issue if you have a problem or idea

---

Note: This document has repetitive links and content to ensure
that steps are not missed and are considered appropriately.

---

Standard development package installation instructions

Common development installations.
Listed below are key steps for the setup process.

---

Note: Each step should be step you've done before. Not regularly, but before.
If these steps feel very uncomfortable to you, this list of instruction might not be yours to follow.

---

1. Download and install your preferred commandline tool.
   • For this document, Iterm with zsh are used.
2. Install Homebrew
3. Install Xcode
4. Using Homebrew:
   1. Install Node
   2. Install Git

---

Download a Commandline app

Download and setup your preferred commandline app.
For this document, Iterm with ZSH is recommended.

• Iterm Downloads

---

Iterm

Download Iterm, a replacement commandline tool for Mac.

ZSH

A Terminal Shell with useful features and a powerful plugin ecosystem.

Note: If you are running on MacOS Catalina (10.15.x), this step is done for you. zsh comes default with MacOS Catalina.

sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"

---

Power tips ⚡️

Setup natural typing

• Go to preferences > profiles > keys
• Click presets
• Select natural typing

You can now move your cursor like in all other apps! 💪

Setup autocomplete

• git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
• add zsh-autocompletion to plugins within your .zshrc config

Install Xcode

Xcode is a tool for development on Mac OS.

xcode-select --install

Install Version Managers and Package Managers

Install package managers. First Homebrew.

Homebrew

Install Homebrew.

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

Node

Use Homebrew to install Node.

brew install Node

NVM

Use NVM to manage Node version used within each environment.

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash

Setup Git

Git can be setup in multiple ways.
One way to setup Git is via Homebrew.

brew install git

Setup Git Globals

Setup standard git defaults

# all push/pull
git config --global push.default current
git config --global pull.default current
git config --global user.name <user_name>
git config --global user.email <user_email>
git config --global core.editor <code_editor>

When working with a git client, like Github, a SSH Key and associated email are needed.

Setup a personal SSH Key

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

Other Brews to optionally install

Listed below are highly recommended Homebrew installs.

Cask

Cask installs Mac Apps via commandline.

brew install cask

Mas

Mas installs Mac Store Apps via commandline.

brew install mas

Quick Setup

1. Open ITerm (or another Shell).
2. Copy and paste the following to your desired folder path git clone git@github.com:yowainwright/macrustle.git
3. Navigate to the macrustle folder, in example, cd macrustle. Type ./bin/macrustle.sh. Press return.
4. Follow the prompts.💨
5. Quick setup ends at installing git. To config git and an SSH Key, start here.