mac_setup.MD

Setting up a new Mac

1. Install Chrome

2. Install Firefox

3. Install Rectangle Pro

4. Install brew (https://brew.sh/)

   1. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

5. Install iterm2 brew install --cask iterm2

6. Install logseq brew install --cask logseq

   1. Create a new graph called "work"
   2. Change the following settings 2. Preferred Date Format to EEE do MMM yyyy 3. Preferred workflow to TODO/DOING
   3. Copy the contents of ./scripts_and_files/logseq/pages into the pages directory of the logseq graph you just created

7. Install git

   1. brew install git

8. Setup the global settings for git

   1. git config --global user.name "Luke McCarthy"
   2. git config --global rerere.enabled true This git setting tell git to remember how to resolve conflicts when you rebase so you don't have to resolve the same conflict again and again

9. Generate a new ssh key for each git user

   1. NB: NEVER reuse a password for any key generated not only is this more secure to use a different password, it also ensures you never commit to the wrong repo
   2. Run the command ssh-keygen -t ed25519 -C <EMAIL_ADDRESS>
   3. Name the files with for example github-thelukemccarthy
   4. Setup git to use the new keys
      While these setting can be added in the ~/.gitconfig file I found it didn't work for me. So I added them to separate files to get the different keys to work.
      1. create two files
         1. touch ~/.gitconfig-thelukemccarthy
         2. touch ~/.gitconfig-CLIENT_NAME
      2. Add the following to ~/.gitconfig-thelukemccarthy

           [user]
             Name="Luke McCarthy"
           [core]
             sshCommand="ssh -i ~/.ssh/github_thelukemccarthy"
         

      3. Add the following to ~/.gitconfig-<CLIENT_NAME>

           [user]
             name="Luke McCarthy"
             email="<CLIENT_EMAIL_ADDRESS>"
           [core]
             sshCommand="ssh -i ~/.ssh/<SSH_KEY_FOR_CLIENT_WORK>"
         

      4. Add the following to the ~/.gitconfig file

           [includeif "gitdir:~/scripts_and_files/"]  
             path = ~/.gitconfig-thelukemccarthy  
         
           [includeif "gitdir:~/Library/Application Support/JetBrains/IntelliJIdea2021.1/settingsRepository/"]
             path = ~/.gitconfig-thelukemccarthy  
             
           [includeif "gitdir:<PATH_TO_SRC_CODE_DIR>"]  
             path = ~/.gitconfig-<CLIENT_NAME>  
         

   5. NB an alternative is to use a .ssh/config file to force work to use a key for a domain. This really only works if you have sub-domains
      1. Run the following command to create a config file for ssh touch ~/.ssh/config
      2. Edit the config file to add the domain to use it for, for example

        Host bitbucket.org
        Hostname bitbucket.org
        User git
        IdentityFile ~/.ssh/bitbucket_mac
      

10. Download and install Kdiff3 from source forge http://kdiff3.sourceforge.net

    1. When opening Kdiff3, if you get the error message "Kdiff3 Cannot Be Opened Because the Developer Cannot be Verified"
       1. Open 'System Preferences' for the Mac
       2. Click on 'Security & Privacy'
       3. At the bottom of the 'General' tab you should be able to allow Kdiff3 to open
    2. Setup git to kdiff3 it
       git config --global merge.tool kdiff3
git config --global mergetool.kdiff3.cmd '/Applications/kdiff3.app/Contents/MacOS/kdiff3 $BASE $LOCAL $REMOTE -o $MERGED'
git config --global mergetool.kdiff3.trustExitCode false

    git config --global diff.guitool kdiff3
git config --global difftool.kdiff3.cmd '/Applications/kdiff3.app/Contents/MacOS/kdiff3 $BASE $LOCAL $REMOTE -o $MERGED'
git config --global difftool.kdiff3.trustExitCode false

11. Clone terminal scripts and files

    1. git clone https://github.com/thelukemccarthy/scripts_and_files.git
    2. Update ~/.zshrc to have source ~/scripts_and_files/alias

12. Install and setup ‘Informative git prompt for zsh’ (https://github.com/olivierverdier/zsh-git-prompt)

    1. git clone https://github.com/olivierverdier/zsh-git-prompt.git
    2. Update ~/.zshrc to have

         source ~/zsh-git-prompt/zshrc.sh
         PROMPT='%B%m%~%b$(git_super_status) %# '
       

13. Install NVM

    1. brew install nvm
    2. Add the following to ~/.zshrc after nvm to automatically change node versions if a .nvmrc file exists

         autoload -U add-zsh-hook
         load-nvmrc() {
           local node_version="$(nvm version)"
           local nvmrc_path="$(nvm_find_nvmrc)"
         
           if [ -n "$nvmrc_path" ]; then
             local nvmrc_node_version=$(nvm version "$(cat "${nvmrc_path}")")
         
             if [ "$nvmrc_node_version" = "N/A" ]; then
               nvm install
             elif [ "$nvmrc_node_version" != "$node_version" ]; then
               nvm use
             fi
           elif [ "$node_version" != "$(nvm version default)" ]; then
             echo "Reverting to nvm default version"
             nvm use default
           fi
         }
         add-zsh-hook chpwd load-nvmrc
         load-nvmrc

14. Install yarn brew install yarn

15. Download and Install VS Code https://code.visualstudio.com/docs/?dv=osx

16. Install the following plugin for VS Code

    1. Live Share
    2. Indent-rainbow
    3. IntelliJ IDEA Keybindings

17. In VS Code, change the following settings (Code > Preferences > Settings):

    1. liveshare.guestApprovalRequired > true
    2. @id:editor.bracketPairColorization.enabled @id:editor.guides.bracketPairs
       1. Editor › Bracket Pair Colorization > Enabled
       2. Editor › Guides: Bracket Pairs > true

18. Download and install IntelliJ

    1. Turn off conflicting Mac OSX keyboard shortcuts
       1. Open ‘System Preferences’
       2. Open ‘Keyboard’
       3. Go to ‘Shortcuts’
       4. Click on ‘Services’
       5. Find ‘Text’
       6. Disable ‘Search man Page Index in Terminal’
       7. Disable ‘Open man Page in Terminal’
    2. Install the following plugins
       1. File Watchers
       2. Indent Rainbow
       3. Night Owl Theme
       4. Prettier
       5. Rainbow Brackets
       6. Docker

19. Download and install Virtualbox

20. Download and setup Win10 for IE test https://developer.microsoft.com/en-us/microsoft-edge/tools/vms/

    1. The password for the VM is Passw0rd!

21. Podman (docker alternative) https://podman-desktop.io/downloads