Dotfiles

Installation Instructions

macOS Big Sur 11.4 using iTerm2 and Zsh

cd $HOME

###############################################################################
# Pull in dotfiles from this repository

git config --global init.defaultBranch main
git config --global pull.ff only
git config --global user.name "<insert name here>"     
git config --global user.email "<insert-email-here>""
git config --global core.editor nvim  # might want to run this after installing neovim
git init
git remote add origin git@github.com:cs-cordero/dotfiles.git
git pull origin master
git submodule update --init --recursive


###############################################################################
# Install brew and associated brew casks

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
brew install cmake
brew install coreutils
brew install grip
brew install less  # See note in $HOME/.lesskey
brew install neovim
brew install reattach-to-user-namespace
brew install ripgrep
brew install tmux
brew install tmuxp
brew install vim


###############################################################################
# Install oh-my-zsh

sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
cp .zshrc.pre-oh-my-zsh .zshrc
rm .zshrc.oh-my-zsh  # this file might not exist


###############################################################################
# Python setup

brew install pyenv

# The following file should already be included, but if not, create it
echo 'export PYENV_ROOT="${HOME}/.pyenv"' > ${HOME}/.zsh-custom/pyenv.zsh
echo 'export PATH="${PYENV_ROOT}/bin:${PATH}"' >> ${HOME}/.zsh-custom/pyenv.zsh
echo 'eval "$(pyenv init --path)"' >> ${HOME}/.zsh-custom/pyenv.zsh

source ~/.zsh-custom/pyenv.zsh  # or just restart terminal
pyenv install --list  # find the latest version
pyenv install x.y.z
pyenv global x.y.z
pip install --user black


###############################################################################
# Node setup

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.38.0/install.sh | bash

# the above appends the NVM_DIR configuration to your zshrc, we don't need it
git checkout .zshrc  

# The following file should already be included, but if not, create it
echo 'export NVM_DIR="$HOME/.nvm"' > ${HOME}/.zsh-custom/nvm.zsh
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm' >> ${HOME}/.zsh-custom/nvm.zsh
echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion' >> ${HOME}/.zsh-custom/nvm.zsh

source ~/.zsh-custom/nvm.zsh  # or just restart terminal

# Update nvm to the latest version
pushd $NVM_DIR
    git fetch --tags origin
    git checkout `git describe --abbrev=0 --tags --match "v[0-9]*" $(git rev-list --tags --max-count=1)`
    . "$NVM_DIR/nvm.sh"
popd
nvm install node
nvm use node


###############################################################################
# Configure Vim and Neovim

# Install vim-plug
sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'
vim  # The included alias should already point `vim` to `nvim`

# From within Neovim
:PlugInstall
:CocInstall coc-rust-analyzer
:CocInstall coc-json
:CocInstall coc-toml

# Note:  Neovim should be >= 0.5.0
# Note:  Node should be >= 12


###############################################################################
# Setup Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
cargo install mdbook  # I use this for taking notes


###############################################################################
# Configure iTerm2

Go to:  iTerm2 > Preferences > Keys > Presets... > Import... > keys.itermkeymap
Go to:  iTerm2 > Preferences > General > Selection > Applications in terinal may access clipboard
Go to:  iTerm2 > Preferences > Profiles > Text > Set Font

Other Installation steps

Preferred font is Hack
In order to get the pane-switching and pane-resizing functionality with Cmd+I,J,K,L and Cmd+↑,← ,↓,→ shortcuts, we need to use iTerm2. After installing and using iTerm2, go to Preferences > Keys and set the following mappings:
- You should just import this from the keys.itermkeymap file
- Cmd+i --> Send Hex Codes: 0x11
- Cmd+j --> Send Hex Codes: 0x0e
- Cmd+k --> Send Hex Codes: 0x17
- Cmd+l --> Send Hex Codes: 0x13
- Cmd+↑ --> Send Hex Codes: 0x1b 0x1b 0x5b 0x41
- Cmd+← --> Send Hex Codes: 0x1b 0x1b 0x5b 0x44
- Cmd+↓ --> Send Hex Codes: 0x1b 0x1b 0x5b 0x42
- Cmd+→ --> Send Hex Codes: 0x1b 0x1b 0x5b 0x43
On Mac, if you are using third party peripherals, your keys could be all messed up and you need to fix it.
- For your extra side mouse buttons, a tool called SensibleSideButtons helps to make it just work.
- For resizing and snapping windows, use Rectangle.app
- For your keyboard's Home and End keys, create a file at ~/Library/KeyBindings/DefaultKeybinding.dict (make the folder if necessary) and append the following text to it:

{
    /* Remap Home / End to be correct */
    "\UF729"  = moveToBeginningOfLine:;    // home
    "\UF72B"  = moveToEndOfLine:;          // end
    "$\UF729" = moveToBeginningOfLineAndModifySelection:; // shift-home
    "$\UF72B" = moveToEndOfLineAndModifySelection:;       // shift-end
}

Usage Notes

Try to keep the .zshrc file completely clean and environment agnostic, i.e., don't add any directory aliases.
Create and use a .zsh-custom/aliases.zsh file (not included in this repo and gitignored) for environment-specific bash settings.
The included .zshrc already sources any .zsh-custom/aliases.zsh file if it exists.

IntelliJ IDEA Exported Settings

The following settings are exported using the IntelliJ IDEA UI:

Code Style (schemes)
CodeInsight, Code Folding, DefaultFont, JavaCodeFoldingSettings
Editor Colors
File types
Find
General
Key maps
Key maps (schemes)
MarkdownApplicationSettings
VimKeySettings, VimEditorSettings, VimSettings

Author

Christopher Sabater Cordero: Github | LinkedIn