step_three_engineering_core.md

Engineering Workstation Setup and Configuration : Step Three

Please note, if you have not installed Xcode, please review the first part of this guide and complete those steps before starting this phase.

1. Install homebrew.
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. Run brew doctor and make sure it reports Your system is ready to brew.
3. Update brew via brew update.
4. Install the latest version of git via brew install git.
5. Install Autojump via brew install autojump.
6. Install direnv to manage environment variables via brew install direnv.
7. Install itermocil to manage iterm windows via brew install TomAnthony/brews/itermocil.
8. Install htop via brew install htop.
9. Install wget via brew install wget
10. Install the Heroku CLI Tool via brew install heroku/brew/heroku.
11. Install NGROK via brew install --cask ngrok from this guide.
12. Install Git Large File Storage via brew install git-lfs.
13. Install puma-dev via brew install puma/puma/puma-dev && puma-dev -install -d localhost && sudo puma-dev -setup
14. Setup your .gitconfig file with your account information.

[user]
  name = Chris Hough
  email = {insert email address}
[mergetool]
  keepBackup = true
[core]
  editor = vi
[color]
  ui = auto
[push]
  default = simple
[github]
  user = chrishough
[credential]
  helper = osxkeychain
[filter "lfs"]
  process = git-lfs filter-process
  required = true
  clean = git-lfs clean -- %f
  smudge = git-lfs smudge -- %f
[pull]
  rebase = false
[init]
  defaultBranch = master

13. Clone this repo "[email protected]:chrishough/my-configurations.git" to our home directory. Please note, that if you are having cloning issues you may need to setup your new ssh keys then run git clone [email protected]:chrishough/my-configurations.git .myconfigurations.
14. Setup Alfred theme and workflows brought in from the .myconfigurations repo in the folder .myconfigurations/workstation/alfred/.
    • 
    • 
15. Install the Fira Code Fonts.
16. Install tmux via brew install tmux.
17. Install Zsh viabrew install zsh.
18. Install oh-my-zsh sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)".
19. Now need to set zsh as the default shell. If you run which zsh you will see this pointed to /bin/zsh. We need to change this. Running sudo dscl . -create /Users/$USER UserShell /usr/local/bin/zsh will properly adjust this for us. Now reopen the terminal window, and when you run which zsh it should be pointed to /usr/local/bin/zsh.
20. Setup zsh-syntax-highlighting via git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting.

Type cmd + space to launch iterm2 to perform the next block of installations in your home directory. Please verify you are in your home directory by typing cd $HOME. Also, if iterm prompts you for an update. Load it. Also, make sure to check load updates automatically during this process. Please feel free to close Terminal at this time.

21. Download the Base16 iTerm2 colors to your documents directory. My theme uses base16-railscasts.dark which can be loaded in the presets. You will need to set the contrast as shown to have a clearer definition of the font icons.
22. Under the terminal tab, make sure to change the report terminal type to xterm-256color and your character encoding to Unicode (UTF-8).
23. Set the scrollback lines to unlimited, and adjust settings as follows.
    • 
    • 
    • 
    • 
    • 
    • 

Now we have to sync our settings to the configuration repo! This will adjust the following files: .pryrc, .vimrc, .zprofile, .zshrc, .profile, .gemrc, .bashrc, and .bash_profile.

24. Backup existing dotfiles ruby $HOME/.myconfigurations/scripts/setup/dotfiles/backup.rb.
25. Setup symlinks to our configuration dotfiles ruby $HOME/.myconfigurations/scripts/setup/dotfiles/symlinks.rb.
26. Create the shell file for private includes via touch .myconfigurations/workstation/shell/global-private.

Potential Errors...

If you get the error zsh compinit: insecure directories, run compaudit for list. you will need to adjust zsh permissions as desribed in this stackoverflow post.

cd /usr/local/share/
sudo chmod -R 755 zsh
sudo chown -R root:staff zsh

If you see this error regarding NVM this will be installed during the next parts of this guide.

/Users/christopherhough/.zprofile:.:8: no such file or directory: /usr/local/opt/nvm/nvm.sh

At this point if you type cd $HOME && lsa your home directory should look something like this.