This repo is a collection of my Neovim, tmux, zsh, etc. configurations. This dotfile project is heavily inspired by Nick Nisi's dotfile project. See his talk vim + tmux - OMG! if you want to be inspired.
git clone https://github.com/nwaywood/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
bash install.sh
This install.sh
script will start by installing all symbolic links into your home directory. Every file with a .symlink
extension will be symlinked to the home directory with a .
in front of it. As an example, zshrc.symlink
will be symlinked in the home directory as ~/.zshrc
. Then, all files in the $DOTFILES/config
directory will be symlinked to the ~/.config/
directory for applications that follow the XDG base directory specification, such as Neovim.
Next, the script will check to see if the OS is MacOS. If so, it will install Homebrew (if its not already installed) and will install all the packages listed in install/brew.sh
. Then, install/osx.sh
will run and change some OSX configurations. Finally, zsh
is configured and oh-my-zsh
is installed.
In install/
folder there are other scripts for installing go
, atom
, and npm
packages which are not automatated. If you want to install any of these packages, manually run the file (e.g. bash install/atom.sh
).
Need to symlink files into VSCode folder. See readme in vscode folder for details
Neovim config is symlinked to ~/.config/nvim
directory by the install/link.sh
script. Inside of .zshrc
, the EDITOR
shell variable is set to nvim
, defaulting to Neovim for editor tasks, such as git commit messages. Additionally, I have aliased vim
to nvim
in aliases.zsh
You can remove this if you would rather not alias the vim
command to nvim
.
Neovim plugins are managed with vim-plug. To install plugins, run:
nvim +PlugInstall
ZSH is configured in the zshrc.symlink
file, which will be symlinked to the home directory. The following occurs in this file:
oh-my-zsh
and install pluginsnick-pure.zsh-theme
contains my custom terminal prompt. If you would like to use it, manually symlink it into ~/.oh-my-zsh/custom/themes
or change ZSH_THEME
in zshrc.symlink
from nick
to one of the built-in themes (e.g. robbyrussell
). My zshrc
config also relies on a custom plugin my-vi-mode
which should be copied into ~/.oh-my-zsh/custom/plugins
For example:
ln -s /Users/nick.waywood/.dotfiles/oh-my-zsh/custom/themes/nick_pure.zsh-theme /Users/nick.waywood/.oh-my-zsh/custom/themes/nick_pure.zsh-theme
ln -s /Users/nick.waywood/.dotfiles/oh-my-zsh/custom/plugins/my-vi-mode /Users/nick.waywood/.oh-my-zsh/custom/plugins/my-vi-mode
Tmux is a terminal multiplexor which lets you create windows and splits in the terminal that you can attach and detach from. I use it to keep multiple projects open in separate windows and sessions and to create an IDE-like environment to work in where I can have my code open in Neovim and a shell open to run tests/scripts. Tmux is configured in ~/.tmux.conf, and in tmux/theme.sh, which defines the colors used, the layout of the tmux bar, and what what will be displayed, including the time and date, open windows, tmux session name, computer name. If not running on macOS, this configuration should be removed.
Tmux plugins are managed with tpm. To install plugins, run:
<prefix> - I
from within tmux. This installs the tmux-resurrect
plugin which lets tmux sessions/windows/panes be persisted across OS reboots. prefix - ^s
to save the tmux environment and prefix - ^r
to restore the tmux environent.
My neovim and zsh setups both make use patched nerd fonts.
It is recommended to use one, otherwise some characters will look funky. I personally use Fira Mono Nerd Font
. It can be installed with:
brew tap homebrew/cask-fonts
brew install font-fira-mono-nerd-font