dotfiles

Collection of config files and scripts for my personal Mac setup.

New Mac Setup Instructions

Instructions for setting up your new Mac (as of Feb 2024).

Inspired by and heavily referencing (Both courtesy of this tweet https://twitter.com/karpathy/status/1762648404029759758):

• https://www.swyx.io/new-mac-setup
• https://sourabhbajaj.com/mac-setup

Install Homebrew

1. Run /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
2. Run echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
   1. To make the Homebrew-installed programs available in your shell, you need to add your Homebrew installation location to your $PATH

Browser

I'm using zen as my default browser for now.

1. Download Chrome https://www.google.com/chrome/
   1. Update your chrome://flags/ to have all websites dark-mode
2. Install FireFox
3. Install zen
4. Privacy focused:
   1. Download Brave
   2. Install LibreWolf, a security-focused fork of Firefox
      1. Run brew install --cask librewolf --no-quarantine

Terminal setup

1. Download iTerm2 brew install --cask iterm2
   1. Update the blue colour in iTerm -> Settings -> Profiles -> [ choose needed profile ] -> Colors for a better exp with agnoster's theme
2. Install oh-my-zsh sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
3. Set ~/.zprofile and ~/.zshrc to the files in this folder
4. Download nerd fonts and set iTerm2's font to it
   1. brew tap homebrew/cask-fonts && brew install --cask font-source-code-pro && brew install --cask font-jetbrains-mono
   2. If you want jetbrains mono nerd-font, install with curl -OL https://github.com/ryanoasis/nerd-fonts/releases/latest/download/JetBrainsMono.tar.xz
   3. iTerm2 settings -> Profile -> Text -> Font -> set to source code pro
5. Shortcuts -- get better default shortcuts by setting the preset keys to Natural Text Editing (e.g. CMD + Backspace & Option + Backspace)
   1. iTerm2 Settings -> Profile -> Keys -> Presets -> Natural Text Editing
6. Install github CLI brew install gh
   1. Run gh auth login
   2. add GitHub SSH key (NOT optional)
7. Add [dotenv](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/dotenv) into your list of zsh plugins in .zshrc
   1. This helps with loading .env env vars automatically when you cd into a given folder

Text editor setup

VSCode

1. Install vscode
   1. Run brew install --cask visual-studio-code
2. Nano should come pre-installed
   1. Nano text editor shortcuts
3. To ensure debugging works on vscode:
   1. System Preferences -> Desktop & Dock -> Keyboard & Mouse Shortcuts -> Show Desktop -> Keyboard Shortcut -> toggle off F11 key. (F11 should be reserved for step through debugging)
4. Run code . to open a new file/folder in vscode

Nano

Should already come pre-installed. Simply run nano in the terminal to open a new file.

Neovim

1. Based on kickstart.nvim and this guide
2. Follow the installation instructions in the kickstart.nvim repo
   1. Install these pre-requisites: brew install neovim ripgrep xclip luajit luarocks
   2. Run: git clone https://github.com/ianpaul10/kickstart.nvim.git "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim
3. You're off to the races! Run nvim . to open a new file/folder in neovim

Python setup

1. Install pyenv brew install pyenv
2. Run pyenv install 3 to get the latest python 3
3. Run pip install virtualenv to install virtualenv locally
4. Run git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv and pyenv global 3 to activate what you just installed.
5. When starting/loading a new python repo:
   1. Start a new python virtual environment virtualenv venv
   2. Activate the python virtual environment source venv/bin/activate
   3. When done work in that repo, run deactivate
   4. This will help keep dependencies for a given repo local to that /venv folder inside the root repo dir
   5. Be sure to include venv in your .gitignore file to not have the packages brought into source control

Ruby setup

1. Ruby install (for jekyll): brew install ruby

Node.js setup

1. Install node version manager
2. brew install nvm
3. Ensure you update your .zshrc with the appropriate info to load node properly.
4. Install node.js
5. nvm install node # install most recent Node stable version
6. Node.js and nvm config included in .zshrc

Local scripts setup

1. ask command to ask GPT-4 a question from the command line
   1. Run pip install -r requirements.txt to install the required packages
   2. Run cp .env.example .env to create a .env file
   3. Update the .env file with your OpenAI API key
2. If you want to add any new scripts, add them in the /scripts folder and include an alias in your .zshrc file to run them. Be sure to update the local scripts setup alias in .zshrc to point to the new script.
3. Heavily inspired from dnbt777

Misc

1. Finder settings change
   1. Settings > advanced > show filename extensions
   2. Enable showing dotfiles (Cmd + Shift + . (dot) in a Finder window)
   3. Show path bar in footer for easier navigation (View -> Show Path Bar)
2. System preferences
   1. Desktop & Dock
      1. Dock size nearly smallest & magnification to max
   2. Displays -> Night shift
      1. Enable Sunset to Sunrise
      2. Set color temperature to more warm
3. Install FlyCut from the app store (copy/paste clipboard)
   1. Preferences -> Move pasted items to top of stack -> Select check box
4. Install docker
   1. Run brew install --cask docker
5. Install spotify
   1. Run brew install --cask spotify
6. Install logitech mouse settings app
   1. Run brew install --cask logitech-options
7. Install protonVPN
   1. Run brew install --cask protonvpn
8. Desktop background
9. Private env vars that you want access to in your terminal can be put into .zshenv