dotfiles

The dotfiles for macOS.

♥ the Vim.

Commands

The main tasks are Makefile targets. To see the available commands provided by the install, uninstall, update and help scripts run:

make help

New Machine

1. Setup iCloud
2. Download App store applications
3. Run xcode-select --install
4. Install homebrew
5. Run /opt/homebrew/bin/brew install git
6. Run git clone https://github.com/mkitt/dotfiles.git && cd dotfiles
7. Add the gitconfig.local file to the dotfiles directory
8. Run make install
9. Follow post install instructions (Vim plugins)
10. Map caps lock to the control key
11. Install SF Mono Nerd Font from the fonts directory - build if necessary
12. Set other reasonable macOS defaults
13. Restart to pick up reasonable defaults
14. Create new SSH & update GPG keys
15. Run gh auth login
16. Switch the dotfiles repo from https to ssh
17. Pull down key repositories
18. Setup all Application settings
19. Wipe old computer

Tips

Git Credentials

To setup your git credentials you'll need to add a gitconfig.local file to your the root directory and add the following:

[user]
  name = YOUR_GIT_AUTHOR_NAME
  email = YOUR_GIT_AUTHOR_EMAIL
  # signingKey = YOUR_GIT_GPG_SIGNING_KEY
[github]
  user = YOUR_GITHUB_USERNAME

• The installscript symlinks this file to $HOME/.gitconfig.local
• The global .gitignore is set to omit any *.local files

GPG

Install GPG Keychain for GPG signing to happen automatically. See GPG Tools for more information. To get your GPG signing key you can either open up GPG Keychain, or run gpg --list-keys and add this to in your .gitconfig.local file. If you are transferring a key to a new computer see the knowledge base article

Build SF Mono Nerd Font

• Run brew install fontforge
• Download the latest release of Apple's SF Mono Font
• Download the latest release of Nerd Fonts
• Run make fonts ~/PATH/TO/nerd-fonts/font-patcher
• In the ./fonts directory, select all and double click to install/update

---

mkitt.net | github/mkitt