setup

Things you do when you get a new computer.

1: Setup Chrome

• Download and run installer.
• Create a profile with your company email address.

2: Setup VSCode

• Download and run the installer.
• CMD+Shift+P -> Shell Command: Install 'code' command in PATH
• Enable Auto Save (File -> Auto Save)
• Install extensions:
  • Git Lens
  • Markdown All in One
  • Conventional Commits
  • ESLint
  • Better Comments
  • AWS CLI Configure
  • Expo Tools
  • glTF Tools
  • glsl-canvas
  • Remote - Containers

3: Setup SSH access to Github

Follow instructions, making sure to:

• generate the key files in the ~/.ssh folder, using the -f github_{username} flag.
• use a passphrase when generating the key files.
  • you will need to type this again in a moment
• setup keychain options in code ~/.ssh/config
• save your passphrase in the keychain per the instructions.
• get invited to your employer's github org.

4: Setup oh-my-zsh

• Follow install instructions
• Pick a theme that shows your current git branch
  • default works ZSH_THEME="robbyrussell"

5: Setup Nodejs

• Download and install nvm
• Comment out code added to the bottom of .zshrc

  # commented to allow zsh plugins to manage
  # export NVM_DIR="$HOME/.nvm"
  # [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
  # [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

• add nvm to oh-my-zsh plugins
  • plugins=(git nvm)
• make sure to enable lazy load for better shell startup time (near top of ~/.zshrc).
  • zstyle ':omz:plugins:nvm' lazy true
• install a Nodejs version
  • nvm install --lts
• upgrade npm version (if desired)
  • npm install -g npm@latest

6: Setup brew

• Download and run Brew installer.
• follow prompts

  ==> Next steps:
  - Run these two commands in your terminal to add Homebrew to your PATH:
      echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/johngrant/.zprofile
      eval "$(/opt/homebrew/bin/brew shellenv)"

7: Setup git

• make sure Mac Command Line Tools are installed by running git --version
  • if CLT not installed, install them.
• make sure git is listed as one of the plugins in .zshrc
  • plugins=(git ...)
• use brew to update git

  git --version
  which git
  brew install git
  which git
  git --version
  

• configure global default profile

  git config --global user.name "Your Name"
  git config --global user.email "Your@email"
  

• configure repo-specific profile (if desired)

  git config --local user.name "Your Name"
  git config --local user.email "Your@email"
  

• setup VSCode as the default git tool
  • execute git config --global -e
  • paste the following into the editor and save

    [core]
        editor = code --wait
    [diff]
        tool = vscode
    [difftool "vscode"]
        cmd = code --wait --diff $LOCAL $REMOTE
    [merge]
        tool = vscode
    [mergetool "vscode"]
        cmd = code --wait $MERGED
  

8: Setup AWS CLI

• Download and run installer for AWS CLI

  # all system users
  curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
  sudo installer -pkg AWSCLIV2.pkg -target /
  

• add aws to oh-my-zsh plugins
  • plugins=(git nvm aws)
• Download and run installers for SAM CLI, or simply:

  brew tap aws/tap
  brew install aws-sam-cli
  sam --version
  

• Obtain your employer's AWS SSO URL.
• Follow instructions to configure profile credentials.
  • aws configure sso

9: Setup jq

• brew install jq

10: Setup Hashicorp's tools

• run install command

  brew tap hashicorp/tap
  brew install hashicorp/tap/terraform
  npm install --global cdktf-cli@latest

11: Setup Docker

• Download and run installer.

12: Setup Android Development Tools

• Download and install Android Studio
• Follow insane procedure to setup ARM image for emulators
• select a device that supports the play store

13: Setup Act (Github Action emulator)

• brew install act
• echo "--container-architecture linux/amd64" >> ~/.actrc