dotfiles

These are my dotfiles. They are forked from https://github.com/webpro/dotfiles and heavily customized.

Take anything you want, but at your own risk.

It mainly targets macOS systems (but it works on at least Ubuntu as well).

Highlights

• Minimal efforts to install everything, using a Makefile
• Mostly based around Homebrew, Caskroom and Node.js, latest Bash + GNU Utils
• Great Window management (using Hammerspoon)
• Fast and colored prompt
• Updated macOS defaults
• Well-organized and easy to customize
• Supports both Apple Silicon (M1) and Intel chips

Packages Overview

• Homebrew (packages: Brewfile)
• homebrew-cask (packages: Caskfile)
• Node.js + npm LTS (packages: npmfile)
• Latest Git, Bash, Python, GNU coreutils, curl, Ruby
• Hammerspoon (config: keybindings & window management)

Installation

On a sparkling fresh installation of macOS:

sudo softwareupdate -i -a
xcode-select --install

The Xcode Command Line Tools includes git and make (not available on stock macOS). Now there are two options:

1. Install this repo with curl available:

bash -c "`curl -fsSL https://raw.githubusercontent.com/rbsummers/dotfiles/master/remote-install.sh`"

This will clone or download this repo to ~/.dotfiles (depending on the availability of git, curl or wget).

1. Alternatively, clone manually into the desired location:

git clone https://github.com/rbsummers/dotfiles.git ~/.dotfiles

Use the Makefile to install the packages listed above, and symlink runcom and config files (using stow):

cd ~/.dotfiles
make

Post-Installation

• Make GitHub SSH key on new laptop (https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent):
  • ssh-keygen -t ed25519 -C "<[email protected]>" -f .ssh/github_personal_id_ed25519.
  • ssh-add ~/.ssh/github_personal_id_ed25519.
  • Log into Github and add the key there.
  • Change repo's remote origin so it now uses ssh git remote set-url origin ssh://[email protected]/rbsummers/dotfiles (if it wasn't done by the remote install script).
• touch ~/.dotfiles/system/.exports and populate this file with tokens (e.g. export GITHUB_TOKEN=abc)
• dot dock (set Dock items)
• dot macos (set macOS defaults)
• Start Hammerspoon once and set "Launch Hammerspoon at login"
• https://www.synaptics.com/products/displaylink-graphics/downloads/macos for portable screen.
• Log into Google Drive and sync folder.

The dotfiles command

$ dot help
Usage: dot <command>

Commands:
    clean            Clean up caches
    dock             Apply macOS Dock settings
    edit             Open dotfiles in IDE (code)
    help             This help message
    macos            Apply macOS system defaults
    update           Alias for topgrade

Customize

To customize the dotfiles to your likings, fork it and make sure to modify the locations above to your fork.

Credits

Many thanks to the dotfiles community.

TODO

• Oh my zsh + plugins (plugins=(aliases asdf docker docker-compose git thefuck you-should-use z)) + theme (ZSH_THEME="powerlevel10k/powerlevel10k")