Rafael Bodill's Neo/vim Config

Lean mean Neo/vim machine, 30-45ms startup time.

Best with Neovim or Vim 8 with +python3 extensions enabled.

Features

• Fast startup time
• Robust, yet light-weight
• Lazy-load 95% of plugins with Shougo/dein.vim
• Custom side-menu (try it out! Leader+l)
• Modular configuration
• Denite (Unite's successor) centric work-flow
• Extensive Deoplete setup (auto-completion)
• Lightweight simple status/tabline
• Easy customizable theme
• Premium color-schemes
• Central location for tags

Screenshot

Pre-requisites

• Python 3 (brew install python)
• Python 2 (brew install python@2)
• Neovim (Optional, brew install neovim)
• virtualenv for both python3 and python2:

  pip2 install virtualenv
  pip3 install virtualenv
  

  On Ubuntu you can use:

  apt-get install -y python3-venv
  pip install virtualenv
  

Install

1. Let's clone this repo! Clone to ~/.config/nvim, we'll also symlink it for Vim:

mkdir ~/.config
git clone git://github.com/rafi/vim-config.git ~/.config/nvim
ln -s ~/.config/nvim ~/.vim

• Note: If your system sets $XDG_CONFIG_HOME, use that instead of ~/.config in the code above. Nvim follows the XDG base-directories convention.

2. If you are a first-time Neovim user, you need the pynvim packages. Don't worry, run the script provided:

cd ~/.config/nvim
./venv.sh

3. Run make test to test your nvim/vim version and compatibility.

4. Run make to install all plugins.

Enjoy!

Recommended Linters

• Node.js based linters:

npm -g install jshint jsxhint jsonlint stylelint sass-lint
npm -g install raml-cop markdownlint-cli write-good

• Python based linters:

pip install --user pycodestyle pyflakes flake8 vim-vint proselint yamllint

• Shell lint: shellcheck.net
• HTML Tidy: html-tidy.org

Recommended Tools

• ag (The Silver Searcher): ggreer/the_silver_searcher
• z (jump around): rupa/z
• Universal ctags: ctags.io
• Fuzzy file finders: fzf, fzy, or peco
• Tern: npm -g install tern

Upgrade

Run make update

User Custom Config

If you want to add your own configuration, create the config/local.vim file and add your personal settings there. This file is ignored by .gitignore.

If you'd like to install plugins by yourself, create a config/local.plugins.yaml file and manage your own plugin collection.

Structure

• config/ - Configuration
  • plugins/ - Plugin configurations
  • plugins.yaml - Plugins!
  • local.plugins.yaml - Custom user plugins
  • vimrc - Initialization
  • init.vim - runtimepath initialization
  • general.vim - General configuration
  • local.vim - Custom user settings
  • neovim.vim - Neovim specific setup
  • mappings.vim - Key-mappings
  • theme.vim - Color-scheme and theme setup
  • filetype.vim - Language behavior
  • terminal.vim - Terminal configuration
• ftplugin/ - Language specific custom settings
• plugin/ - Customized small plugins
• snippets/ - Personal code snippets
• themes/ - Themes! Combination of styles and color-scheme
• filetype.vim - Custom filetype detection

Plugin Highlights

• Package management with caching enabled and lazy loading
• Project-aware tabs and label
• NERDTree as file-manager + Git status icons
• Go completion via vim-go and gocode
• Javascript completion via Tern
• Python Jedi completion, PEP8 convention
• Languages: PHP, Ansible, css3, csv, json, less, markdown, mustache
• Helpers: Undo tree, bookmarks, git, tmux navigation, hex editor, sessions, and much more.

Note that 95% of the plugins are lazy-loaded.

Non Lazy-Loaded Plugins

Name	Description
Shougo/dein.vim	Dark powered Vim/Neovim plugin manager
rafi/awesome-colorschemes	Awesome color-schemes
rafi/vim-badge	Bite-size badges for the tab & status lines
thinca/vim-localrc	Enable configuration file of each directory
christoomey/tmux-navigator	Seamless navigation between tmux panes and vim splits
junegunn/vim-peekaboo	See the contents of registers
tpope/vim-sleuth	Heuristically set buffer indent options
sgur/vim-editorconfig	EditorConfig plugin written entirely in Vimscript
itchyny/vim-gitbranch	Lightweight git branch detection
itchyny/vim-parenmatch	Efficient alternative to the standard matchparen plugin
itchyny/cursorword	Underlines word under cursor
roxma/nvim-yarp	Remote Plugin Framework for Neovim (Loads in Vim8 only)
roxma/vim-hug-neovim-rpc	Vim8 compatibility layer for neovim rpc client

Lazy-Loaded Plugins

Language

Name	Description
othree/html5.vim	HTML5 omnicomplete and syntax
mustache/vim-mustache-handlebars	Mustache and handlebars syntax
pearofducks/ansible-vim	Improved YAML support for Ansible
groenewege/vim-less	Syntax for LESS
hail2u/vim-css3-syntax	CSS3 syntax support to vim's built-in syntax/css.vim
othree/csscomplete.vim	Updated built-in CSS complete with latest standards
cakebaker/scss-syntax.vim	Syntax file for scss (Sassy CSS)
ap/vim-css-color	Preview colors in source-code while editing
plasticboy/vim-markdown	Markdown syntax highlighting
rhysd/vim-gfm-syntax	GitHub Flavored Markdown syntax highlight extension
pangloss/vim-javascript	Enhanced Javascript syntax
othree/jspc.vim	JavaScript Parameter Complete
posva/vim-vue	Syntax Highlight for Vue.js components
heavenshell/vim-jsdoc	Generate JSDoc to your JavaScript code
jparise/vim-graphql	GraphQL file detection, syntax highlighting, and indentation
moll/vim-node	Superb development with Node.js
elzr/vim-json	Better JSON support
MaxMEllon/vim-jsx-pretty	React JSX syntax pretty highlighting
fatih/vim-go	Go development
vim-python/python-syntax	Enhanced version of the original Python syntax
Vimjas/vim-python-pep8-indent	A nicer Python indentation style
vim-scripts/python_match.vim	Extend the % motion for Python files
tmhedberg/SimpylFold	No-BS Python code folding
raimon49/requirements.txt.vim	Python requirements file format
StanAngeloff/php.vim	Up-to-date PHP syntax file (5.3 – 7.1 support)
shawncplus/phpcomplete.vim	PHP completion
osyo-manga/vim-monster	Ruby code completion
tbastos/vim-lua	Improved Lua 5.3 syntax and indentation support
toyamarinyon/vim-swift	Swift support
vim-jp/syntax-vim-ex	Improved Vim syntax highlighting
chrisbra/csv.vim	Handling column separated data
tpope/vim-git	Git runtime files
ekalinin/Dockerfile.vim	syntax and snippets for Dockerfile
tmux-plugins/vim-tmux	vim plugin for tmux.conf
andreshazard/vim-logreview	Bueatify log viewing
hashivim/vim-terraform	Base Terraform integration
cespare/vim-toml	Syntax for TOML
mboughaba/i3config.vim	i3 window manager config syntax
dag/vim-fish	Fish shell edit support
jstrater/mpvim	Macports portfile configuration files
robbles/logstash.vim	Highlights logstash configuration files
exu/pgsql.vim	PostgreSQL syntax
othree/nginx-contrib-vim	Fork official vim nginx
IN3D/vim-raml	Syntax and language settings for RAML

Commands

Name	Description
Shougo/defx.nvim	Dark powered file explorer implementation
kristijanhusak/defx-git	Git status implementation for Defx
kristijanhusak/defx-icons	Filetype icons for Defx
scrooloose/nerdtree	Tree explorer plugin
Xuyuanp/nerdtree-git-plugin	NERDTree plugin for showing git status
t9md/vim-choosewin	Choose window to use, like tmux's 'display-pane'
kana/vim-niceblock	Make blockwise Visual mode more useful
guns/xterm-color-table.vim	Display 256 xterm colors with their RGB equivalents
mbbill/undotree	Ultimate undo history visualizer
metakirby5/codi.vim	The interactive scratchpad for hackers
Shougo/vimproc.vim	Interactive command execution
reedes/vim-wordy	Uncover usage problems in your writing
brooth/far.vim	Fast find and replace plugin
jreybert/vimagit	Ease your git work-flow within Vim
tweekmonster/helpful.vim	Display vim version numbers in docs
lambdalisue/gina.vim	Asynchronously control git repositories
cocopon/colorswatch.vim	Generate a beautiful color swatch for the current buffer
kana/vim-altr	Switch to the alternate file without interaction
lambdalisue/suda.vim	An alternative sudo.vim for Vim and Neovim
tyru/open-browser.vim	Open URI with your favorite browser
tyru/open-browser-unicode.vim	Open info page about character on current cursor
tyru/open-browser-github.vim	Open GitHub URL of current file
tyru/caw.vim	Robust comment plugin with operator support
Shougo/vinarise.vim	Hex editor
mzlogin/vim-markdown-toc	Generate table of contents for Markdown files
easymotion/vim-easymotion	Vim motions on speed
chemzqm/vim-easygit	Git wrapper focus on simplity and usability
majutsushi/tagbar	Displays tags in a window, ordered by scope
beloglazov/vim-online-thesaurus	Look up words in an online thesaurus

Interface

Name	Description
haya14busa/vim-asterisk	Improved * motions
rhysd/accelerated-jk	Up/down movement acceleration
haya14busa/vim-edgemotion	Jump to the edge of block
t9md/vim-quickhl	Quickly highlight words
rafi/vim-sidemenu	Small side-menu useful for terminal users
airblade/vim-gitgutter	Show git changes at Vim gutter and un/stages hunks
nathanaelkane/vim-indent-guides	Visually display indent levels in code
MattesGroeger/vim-bookmarks	Bookmarks, works independently from vim marks
hotwatermorning/auto-git-diff	Display Git diff for interactive rebase
rhysd/committia.vim	Pleasant editing on Git commit messages
benekastah/neomake	Asynchronous linting and make framework
lambdalisue/vim-improve-diff	Improve diff experience
junegunn/goyo	Distraction-free writing
junegunn/limelight	Hyperfocus-writing
itchyny/calendar.vim	Calendar application
vimwiki/vimwiki	Personal Wiki for Vim

Completion

Name	Description
Shougo/deoplete.nvim	Neovim: Dark powered asynchronous completion framework
Shougo/neosnippet.vim	Snippets with integration to Deoplete
ludovicchabant/vim-gutentags	Manages your tag files
mattn/emmet-vim	Provides support for expanding abbreviations alá emmet
Shougo/echodoc.vim	Print objects' documentation in echo area
Raimondi/delimitMate	Auto-completion for quotes, parens, brackets
Shougo/neosnippet-snippets	Standard snippets repository for neosnippet
Shougo/context_filetype.vim	Context filetype library for Vim script
Shougo/neco-vim	Deoplete source for Vimscript
Shougo/neoinclude.vim	Include completion framework for Deoplete
Shougo/neco-syntax	Syntax source for Deoplete
davidhalter/jedi-vim	Python jedi autocompletion library
zchee/deoplete-go	deoplete.nvim source for Go
zchee/deoplete-jedi	deoplete.nvim source for Python
carlitux/deoplete-ternjs	deoplete.nvim source for javascript
wellle/tmux-complete.vim	Completion of words in adjacent tmux panes
fszymanski/deoplete-emoji	Deoplete source for emoji codes
juliosueiras/vim-terraform-completion	Autocompletion and linter for Terraform
ternjs/tern_for_vim	Provides Tern-based JavaScript editing support

Denite

Name	Description
Shougo/denite.nvim	Dark powered asynchronous unite all interfaces
nixprime/cpsm	File matcher, specialized for paths
Shougo/neoyank.vim	Denite plugin for yank history
Shougo/junkfile.vim	Denite plugin for temporary files
chemzqm/unite-location	Denite location & quickfix lists
chemzqm/denite-git	gitlog, gitstatus and gitchanged sources
rafi/vim-denite-z	Filter and browse Z (jump around) data file
rafi/vim-denite-session	Browse and open sessions
rafi/vim-denite-mpc	Denite source for browsing your MPD music library

Operators & Text Objects

Name	Description
kana/vim-operator-user	Define your own custom operators
kana/vim-operator-replace	Operator to replace text with register content
rhysd/vim-operator-surround	Operator to enclose text objects
haya14busa/vim-operator-flashy	Highlight yanked area
kana/vim-textobj-user	Create your own text objects
terryma/vim-expand-region	Visually select increasingly larger regions of text
AndrewRadev/sideways.vim	Match function arguments
AndrewRadev/splitjoin.vim	Transition code between multi-line and single-line
AndrewRadev/linediff.vim	Perform diffs on blocks of code
AndrewRadev/dsf.vim	Delete surrounding function call
osyo-manga/vim-textobj-multiblock	Handle bracket objects
kana/vim-textobj-function	Text objects for functions

Custom Key-mappings

Note that,

• Leader key is set as Space
• Local-leader is set as ; and used for Denite & NERDTree

Key	Mode	Action
Space	All	Leader
;	All	Local Leader
Arrows	Normal	Resize splits (* Enable g:elite_mode in .vault.vim)
Backspace	Normal	Match bracket (%)
K	Normal	Open Zeal or Dash on some file types (except Python+Vim script)
Y	Normal	Yank to the end of line (y$)
<Return>	Normal	Toggle fold (za)
S+<Return>	Normal	Focus the current fold by closing all others (zMza)
S+<Return>	Insert	Start new line from any cursor position (<C-o>o)
hjkl	Normal	Smart cursor movements (g/hjkl)
Ctrl+f	Normal	Smart page forward (C-f/C-d)
Ctrl+b	Normal	Smart page backwards (C-b/C-u)
Ctrl+e	Normal	Smart scroll down (3C-e/j)
Ctrl+y	Normal	Smart scroll up (3C-y/k)
Ctrl+q	Normal	Remap to Ctrl+w
Ctrl+x	Normal	Rotate window placement
!	Normal	Shortcut for :!
}	Normal	After paragraph motion go to first non-blank char (}^)
<	Visual/Normal	Indent to left and re-select
>	Visual/Normal	Indent to right and re-select
Tab	Visual	Indent to right and re-select
Shift+Tab	Visual	Indent to left and re-select
>+>	Normal	Indent to right and re-select
<+<	Normal	Indent to left and re-select
gh	Normal	Show highlight group that matches current cursor
gp	Normal	Select last paste
Q	Normal	Start/stop macro recording
gQ	Normal	Play macro 'q'
mj/mk	Normal/Visual	Move lines down/up
<leader>+cp	Normal	Duplicate paragraph
<leader>+cn/cN	Normal/Visual	Change current word in a repeatable manner
s	Visual	Replace within selected area
Ctrl+a	Command	Navigation in command line
Ctrl+b	Command	Move cursor backward in command line
Ctrl+f	Command	Move cursor forward in command line
Ctrl+r	Visual	Replace selection with step-by-step confirmation
,+Space	Normal	Remove all spaces at EOL
<leader>+<leader>	Normal	Enter visual line-mode
<leader>+a	Normal	Align paragraph
<leader>+os	Normal	Load last session
<leader>+se	Normal	Save current workspace as last session
<leader>+d	Normal/Visual	Duplicate line or selection
<leader>+S	Normal/Visual	Source selection
<leader>+ml	Normal	Append modeline

File Operations

Key	Mode	Action
<leader>+cd	Normal	Switch to the directory of opened buffer (:lcd %:p:h)
<leader>+w	Normal/visual	Write (:w)
<leader>+y / <leader>+Y	Normal	Copy (relative / absolute) file-path to clipboard
Ctrl+s	All	Write (:w)
W!!	Command	Write as root

Editor UI

Key	Mode	Action
<leader>+ti	Normal	Toggle indentation lines
<leader>+ts	Normal	Toggle spell-checker (:setlocal spell!)
<leader>+tn	Normal	Toggle line numbers (:setlocal nonumber!)
<leader>+tl	Normal	Toggle hidden characters (:setlocal nolist!)
<leader>+th	Normal	Toggle highlighted search (:set hlsearch!)
<leader>+tw	Normal	Toggle wrap (:setlocal wrap! breakindent!)
g0	Normal	Go to first tab (:tabfirst)
g$	Normal	Go to last tab (:tablast)
gr	Normal	Go to previous tab (:tabprevious)
Ctrl+j	Normal	Move to split below (<C-w>j)
Ctrl+k	Normal	Move to upper split (<C-w>k)
Ctrl+h	Normal	Move to left split (<C-w>h)
Ctrl+l	Normal	Move to right split (<C-w>l)
*	Visual	Search selection forwards
#	Visual	Search selection backwards
<leader>+j	Normal	Next on location list
<leader>+k	Normal	Previous on location list
<leader>+b	Normal	Toggle colorscheme background dark/light
s+-	Normal	Lower colorscheme contrast (Support solarized8)
s+=	Normal	Raise colorscheme contrast (Support solarized8)

Window Management

Key	Mode	Action
q	Normal	Quit window (and Vim, if last window)
Ctrl+Tab	Normal	Next tab
Ctrl+Shift+Tab	Normal	Previous tab
\+\	Normal	Jump to last tab
s+v	Normal	Horizontal split (:split)
s+g	Normal	Vertical split (:vsplit)
s+t	Normal	Open new tab (:tabnew)
s+o	Normal	Close other windows (:only)
s+x	Normal	Remove buffer, leave blank window
s+q	Normal	Closes current buffer (:close)
s+Q	Normal	Removes current buffer (:bdelete)
<leader>+sv	Normal	Split with previous buffer
<leader>+sg	Normal	Vertical split with previous buffer

Plugin: Denite

Key	Mode	Action
;+r	Normal	Resumes last Denite window
;+f	Normal	File search
;+b	Normal	Buffers and MRU
;+d	Normal	Directories
;+v	Normal/Visual	Yank history
;+l	Normal	Location list
;+q	Normal	Quick fix
;+n	Normal	Dein plugin list
;+g	Normal	Grep search
;+j	Normal	Jump points
;+u	Normal	Junk files
;+o	Normal	Outline tags
;+s	Normal	Sessions
;+t	Normal	Tag list
;+p	Normal	Jump to previous position
;+h	Normal	Help
;+m	Normal	Memo list
;+z	Normal	Z (jump around)
;+/	Normal	Buffer lines
;+*	Normal	Match word under cursor with lines
;+;	Normal	Command history
<leader>+gl	Normal	Git log (all)
<leader>+gs	Normal	Git status
<leader>+gc	Normal	Git branches
<leader>+gt	Normal	Find tags matching word under cursor
<leader>+gf	Normal	Find file matching word under cursor
<leader>+gg	Normal/Visual	Grep word under cursor
Within Denite mode
Escape	Normal/Insert	Toggle modes
jj	Insert	Leave Insert mode
Ctrl+y	Insert	Redraw
r	Normal	Redraw
st	Normal	Open in a new tab
sg	Normal	Open in a vertical split
sv	Normal	Open in a split
'	Normal	Toggle mark current candidate

Plugin: NERDTree

Key	Mode	Action
;+e	Normal	Toggle file explorer
;+a	Normal	Toggle file explorer on current file
Within NERDTree buffers
h/j/k/l	Normal	Movement + collapse/expand + file open
w	Normal	Toggle window size
N	Normal	Create new file or directory
yy	Normal	Yank selected item to clipboard
st	Normal	Open file in new tab
sv	Normal	Open file in a horizontal split
sg	Normal	Open file in a vertical split
&	Normal	Jump to project root
gh	Normal	Jump to user's home directory
gd	Normal	Open split diff on selected file
gf	Normal	Search in selected directory for files
gr	Normal	Grep in selected directory

Plugin: Deoplete / Emmet

Key	Mode	Action
Enter	Insert	Select completion or expand snippet
Tab	Insert/select	Smart tab movement or completion
Ctrl+j/k/f/b/d/u	Insert	Movement in completion pop-up
Ctrl+<Return>	Insert	Expand Emmet sequence
Ctrl+o	Insert	Expand snippet
Ctrl+g	Insert	Refresh candidates
Ctrl+l	Insert	Complete common string
Ctrl+e	Insert	Cancel selection and close pop-up
Ctrl+y	Insert	Close pop-up

Plugin: Caw (comments)

Key	Mode	Action
gc	Normal/visual	Prefix
gcc	Normal/visual	Toggle comments
<leader>+v	Normal/visual	Toggle single-line comments
<leader>+V	Normal/visual	Toggle comment block

Plugin: Edge Motion

Key	Mode	Action
g+j	Normal/Visual	Jump to edge downwards
g+k	Normal/Visual	Jump to edge upwards

Plugin: QuickHL

Key	Mode	Action
<leader>+,	Normal/Visual	Toggle highlighted word

Plugin: Expand-Region

Key	Mode	Action
v	Visual/select	Expand selection
V	Visual/select	Reduce selection

Plugin: Easymotion

Key	Mode	Action
s+s	Normal	Jump to two characters from input
s+d	Normal	Jump to a character from input
s+f	Normal	Jump over-windows
s+h	Normal	Jump backwards in-line
s+l	Normal	Jump forwards in-line
s+j	Normal	Jump downwards
s+k	Normal	Jump upwards
s+/	Normal/operator	Jump to free-search
s+n	Normal	Smart next occurrence
s+p	Normal	Smart previous occurrence

Plugin: ChooseWin

Key	Mode	Action
-	Normal	Choose a window to edit
<leader>+-	Normal	Switch editing window with selected

Plugin: Bookmarks

Key	Mode	Action
m+a	Normal	Show list of all bookmarks
m+m	Normal	Toggle bookmark in current line
m+n	Normal	Jump to next bookmark
m+p	Normal	Jump to previous bookmark
m+i	Normal	Annotate bookmark

Plugin: Easygit

Key	Mode	Action
<leader>+ga	Normal	Git add current file
<leader>+gS	Normal	Git status
<leader>+gd	Normal	Git diff
<leader>+gD	Normal	Close diff
<leader>+gc	Normal	Git commit
<leader>+gb	Normal	Git blame
<leader>+gB	Normal	Open in browser
<leader>+gp	Normal	Git push

Plugin: GitGutter

Key	Mode	Action
<leader>+hj	Normal	Jump to next hunk
<leader>+hk	Normal	Jump to previous hunk
<leader>+hs	Normal	Stage hunk
<leader>+hr	Normal	Revert hunk
<leader>+hp	Normal	Preview hunk

Plugin: Linediff

Key	Mode	Action
,+df	Visual	Mark lines and open diff if 2nd region
,+da	Visual	Mark lines for diff
,+ds	Normal	Shows the diff between all the marked areas
,+dr	Normal	Removes the signs denoting the diff'ed regions

Misc Plugins

Key	Mode	Action
m+g	Normal	Open Magit
<leader>+l	Normal	Open sidemenu
<leader>+o	Normal	Open tag-bar
<leader>+G	Normal	Toggle distraction-free writing
<leader>+gu	Normal	Open undo tree
<leader>+W	Normal	Wiki
<leader>+K	Normal	Thesaurus

Credits & Contribution

Big thanks to the dark knight Shougo.