tomdot

TL;DR: For web dev things on a clean macOS install: curl -ssL https://git.io/tomdot | sh

Disclaimer: Dotfiles are personal things, and as such I advise against rolling these ones unmodified — they are specific to my setup and will need to be tweaked for yours.

What is tomdot?

I am Tom and these are my dotfiles so tomdot is how they shall be known!

On a fresh macOS system, tomdot will handle the following:

1. Generate SSH auth keys for GitHub.
2. Download repos from GitHub to your local machine.
3. Install Node.js.
4. Install N version manager.
5. Install global npm packages.
6. Enable Corepack (for Yarn and pnpm).
7. Install Bun.
8. Install Homebrew & packages.
9. Install apps from the App Store.
10. Change the Bat colour theme.
11. Symlink config files from ~/.dotfiles to system equivalents.

Preparation

There is some preparation to be done before performing a clean install of macOS to ensure smooth sailing.

• Backup fonts to iCloud: mv ~/Library/Fonts ~/Library/Mobile\ Documents/com~apple~CloudDocs/Fonts.
• Backup any desired app preference files to iCloud.
• Ensure all repos that you want to be cloned from GitHub are included in the repos array in ~/.dotfiles/git/get_repos.sh.
• Ensure local ~/.dotfiles and repos are up-to-date & pushed to GitHub.
• Ensure VS Code is signed into and synced.
• Ensure Chrome is signed into and synced.
• Ensure Bitwarden (or equivalent) is signed into and synced.
• Login to icloud with a browser and ensure all backed-up fonts and preferences have actually been uploaded.
• Update the NVM install script in install.sh (line 42) to the latest version.
• Update MacOS to the latest version.

Installation

1. Perform a clean install of macOS. See Apple Support articles here and here for instructions.
2. Ensure you are logged into the App Store (mas signin has been broken for years).
3. Install Bitwarden manually, enable the extension in Safari and login to GitHub.
4. Install Xcode CLT manually, since xcode-select --install doesn't work on M2 + fresh install of Sonama, for me at least.
5. Run curl -ssL https://git.io/tomdot | sh in the terminal and buckle up!

Post-Installation

• Enable Desktop & Documents Folders in Apple menu  > System Settings > iCloud > iCloud Drive.
• Install fonts backed-up to iCloud.
• Run cw in Kitty to setup AWS CodeWhisperer.
• Launch Raycast & setup.
• Install apps unavailable via Homebrew / App Store (IdeaShare).
• Login to Chrome & enable sync.
• Add SSH public key to Azure DevOps.
• Install Android studio Emulator.
• Restart computer.

Notes

AWS CodeWhisperer (acquired from Fig) seems to fulfil all previous zsh plugin needs.

If additional plugins are required, use Antidote.

Credit

The tomdot repo was assembled with many thanks to these smart folks:

• Dries Vints
• Kent C Dodds
• Mathias Bynens
• Paul Irish
• Paul Miller
• Zach Holman

TODO

Consider GNU Stow or Ansible over manual symlinks.