Dotfiles

Personal dotfiles for Mac development environments. Manages vim, tmux, zsh, git, and various development tool configurations.

Quick Start

Mac

# Prerequisites
# - Latest Mac OS
# - Clone private `environment_configurations` repo in same parent directory

# Run main setup script
mac/make.sh

Directory Structure

• mac/ - Mac-specific configurations and scripts
• devpod/ - Devcontainer/devpod environment configurations and scripts
• shared/ - Cross-platform configurations (vim, zsh, tmux, git)

Setup Details

Mac

• Make sure you're on the latest Mac OS
• Clone the private environment_configurations repo in the same parent directory as this dotfiles repo
• Run mac/make.sh which executes:
  1. mac/scripts/dependencies.sh - Install Homebrew packages
  2. mac/scripts/symlink_to_dotfiles_repo.sh - Create symlinks to dotfiles
  3. mac/scripts/restore_settings.sh - Apply Mac system settings
• This repo assumes the home dir is jklein. If it's not, symlink it with:

  cd /Users
  sudo ln -s james jklein

• Show hidden files in Finder with defaults write com.apple.Finder AppleShowAllFiles true && killall Finder

Installing Fonts

• Open the font file and install it to the Mac Font Book
  • open mac/config/Fura\ Mono\ Regular\ Nerd\ Font\ Complete\ Mono\ Windows\ Compatible.otf
• In iTerm, set the font to that font for the current profile. Profiles > Text > Font
• Restart vim and you should see devicons

Syncing Settings

• To apply repo settings to the local machine: mac/scripts/restore_settings.sh (part of make script)

Sequel Pro

• Dark query scheme found in mac/config/sequel-pro/

Additional environment configurations

• Chrome theme - Dark Theme v3
• See $PRIVATE_CONFIGS_DIR/README.txt

Userscripts

Stored in bookmarks on my google chrome account.

NVM

I set the system ~/.nvmrc -> dotfiles/nvmrc and have that fetching node which is the latest node version. Any project without a .nvmrc will use the latest since it will traverse up the dirs to find my root one

TMUX & Tmuxinator

Default tmux config taken from oh-my-tmux

Tmuxinator project configurations are stored in shared/tmux/.tmuxinator/ and symlinked to ~/.tmuxinator/.

Usage

# Create new tmuxinator config
mac/scripts/new_tmuxinator_config.rb [project_name]

# Start a tmux session
tmuxinator start [project_name]
# or shorthand:
mux [project_name]

# Debug tmuxinator config
tmuxinator debug [project_name]

Alfred

• Settings are stored in the private env config path in Google Drive.
• This should already be stored in settings but if not, use this script to get Alfred <> iTerm2 integration

VIM

• Main config located in shared/.vimrc
• Uses vim-plug for plugin management
• Followed this guide to set up ctags using git hooks
• Uses vim-projectionist to define alternate files as explained here. Each project has a .projections.json defined and globally git ignored.
• Install pythonx dependencies with the following. Note that vim-pyenv takes care of using the pyenv, not system version of python:

pip install -r shared/vim/.vim/pythonx/requirements.txt

iTunes

• For Alfred iTunes miniplayer: In iTunes go to Preferences > Advanced > Share iTunes Library XML with other applications

SSH

To set up ssh and rsync without asking for a password. See this guide NOTE: the same id_rsa.pub is shared so this should not be necessary

ssh-copy-id -i ~/.ssh/id_rsa.pub jamesmkl@jamesmklein.com

• See $LOCAL_CONFIG (vim leader + lcl) for additional configurations

Neovim

I'm not using neovim currently but to get it set up I used the following

brew install neovim
created ~/.config/nvm/init.vim

# run :checkhealth

# https://github.com/zchee/deoplete-jedi/wiki/Setting-up-Python-for-Neovim
sudo pip2 install --user neovim
sudo pip3 install --user neovim

gem install neovim

Quiver

• Quiver settings are stored in mac/config/Quiver-settings.json

Security

Sensitive files are automatically excluded via .gitignore:

• mac/.claude/.credentials.json and related credential files
• *.key, *.pem, *.cert
• .env and .env.* files
• Private configurations should be stored in the separate environment_configurations repository

Troubleshooting

• If you're getting a message about __init_nvm not being defined, nvm likely added something to the .zshrc. Check the bottom of the file.