Neovim IDE configuration

A configuration for neovim editor including plug-ins to enable IDE-like features like intellisense, bracket pairing, status lines, etc.

First you need to install neovim, using your package manager preferably:

sudo apt install neovim

Clone this configuration in ~/.config:

cd ~/.config
git clone https://github.com/cod3g3nki/nvim.git
# or clone a specific tag (vx.x.x), e.g.
git clone -b v0.2.0 --depth 1 https://github.com/cod3g3nki/nvim.git

Install vim-plug in the directory you cloned the repo:

curl -fLo ~/.config/nvim/autoload/plug.vim --create-dirs https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

Start nvim and run command :PlugInstall, restart nvim for configuration and plug-ins to take effect or run :source $MYVIMRC. You may also skip installing vim-plug and run :PlugInstall command on the first run.

For dependencies, you'll need:

• xsel
• Python package pynvim
• npm package neovim

To install these dependencies:

sudo apt install xsel

pynvim can be installed with pip:

pip install pynvim

Node package neovim can be installed using npm:

npm install -g neovim

This configuration uses some terminal utilities for file management, searching, resource monitoring, etc. You must install these or disable/delete respective configuration.

• ranger: file search & management.
• fzf: general-purpose command-line fuzzy finder.
• ripgrep: recursively searches directories for a regex pattern.
• universal-ctags: build tag file indexes of source code definitions (Exuberant Ctags).
• silver-searcher: very fast grep-like searching program.
• fd: fast and user-friendly alternative to find.
• ncdu: NCurses based du, a directory size utility.
• nnn: A terminal based file explorer.

Install ranger file search to use the key mapping:

sudo apt install ranger

# clone ranger devicons
git clone https://github.com/alexanderjeurissen/ranger_devicons ~/.config/ranger/plugins/ranger_devicons

# install extension to enable image preview.
pip install ueberzug

add following configuration to ~/.config/ranger/rc.conf:

set preview_images_method ueberzug

default_linemode devicons

set show_hidden true

you may need to run this in nvim:

:RnvimrSync

For searchers & tagging install:

sudo apt install fzf ripgrep universal-ctags
sudo apt install silversearcher-ag fd-find

Plug FZF &vim-rooter into nvim (init.vim):

Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
Plug 'junegunn/fzf.vim'
Plug 'airblade/vim-rooter'

• Vim Colorizer: color highlighter for Neovim written in luajit. It sets color code's background to help understand visually. You can increment and decrement numbers in vim with c-a and c-x.
• Rainbow parentheses: different colored parentheses for different nested scopes.

Install luarocks if you want to use with coc-lua extension.

sudo apt install luarocks

Plug-ins that are pre-configured in this repo are:

• sheerun/vim-polyglot: Syntax Highlighting

• jiangmiao/auto-pairs: Bracket pairing

• neoclide/coc.nvim: Conquerer of Completion prediction & intellisense

• joshdick/onedark.vim: Theme

• vim-airline/vim-airline: Status/Tabline

• vim-airline/vim-airline-themes: Airline theme

• kevinhwang91/rnvimr: ranger file explorer integration

• junegunn/fzf.vim: fzf fuzzy search

• airblade/vim-rooter: Adjust file explorer path to VCS project root

• tpope/vim-commentary: Toggle comments

• norcalli/nvim-colorizer.lua: Shows color codes in same colored background

• junegunn/rainbow_parentheses.vim: Different color brackets in each nested scope.

• mhinz/vim-startify: Better project management with a fancy start screen

• mhinz/vim-signify: Show git hunks in vim gutter

• tpope/vim-fugitive: Git command wrapper for vim

• tpope/vim-rhubarb: Browse repo, insert issue # & urls

• junegunn/gv.vim: Git commit browser

• mattn/vim-gist: Easily create gists

• liuchengxu/vim-which-key: Displays available keybindings in popup (leader key)

• voldikss/vim-floaterm: A floating terminal for Neovim

• honza/vim-snippets: A repo of snipMate & UltiSnip snippets used with coc-snippets

• mattn/emmet-vim: Expand abbreviations for (x)HTML/CSS

• AndrewRadev/tagalong.vim: Rename closing HTML/XML tags when editing opening ones (vice versa)

• junegunn/goyo.vim: Distraction-free writing, zend mode

In addition to these, following coc extensions can be installed for intellisense:

• vimlsp
• sh
• markdown
• json
• html
• css
• tsserver
• eslint
• python
• yaml
• explorer
• snippets
• fzf-preview

For detail check coc GitHub wiki.

There are multiple light & dark themes, with respective config under themes/, included in this setup. You can switch to the theme of your choice from init.vim. Default theme is set to onedark with config in themes/onedark.vim sourced from init.vim. To add more themes, add github path (dev/repo) in vim-plug/plugins.vim file like:

Plug 'lifepillar/vim-solarized8'

restart nvim and run :PlugInstall. To activate an installed theme, create a config file in themes directory

touch ~/.config/nvim/themes/vim-solarize8.vim

and source this file in init.vim.

source $HOME/.config/nvim/themes/vim-solarize8.vim

Visit this theme collection repo to select different theme, if you want.

You can install coc extensions of your choice by running command :CocInstall coc-extension [ref#4]. For example:

:CocInstall coc-html coc-css coc-json coc-tsserver coc-explorer

Don't forget to add language servers, along with other configurations, in coc-settings.json file [ref#5,6]. Default configuration includes following servers:

{
	"coc.preferences.formatOnSaveFiletypes":
	[
		"css",
		"markdown",
		"javascript",
		"graphql",
		"html",
		"yaml",
		"json",
		"python"
	],
	// python config
    "python.linting.enabled": true,
    "python.linting.pylintEnabled": true,
    "snippets.ultisnips.directories":
    [
        "UltiSnips",
        "~/.config/nvim/utils/snips"
    ]	
}

key mappings for > v 0.2.0: configuration has some major changes in key mappings after introduction of which-key plug-in.

The leader key is set to space. Frequently used key bindings are listed in the table below:

Completion and key binding files for fzf are located in autoload/plugged/fzf/shell/:

completion.bash
completion.zsh
key-bindings.bash
key-bindings.fish
key-bindings.zsh

If you want to use fzf commands and features in terminal, source the relevant files as:

source $HOME/.config/nvim/autoload/plugged/fzf/shell/completion.zsh
source $HOME/.config/nvim/autoload/plugged/fzf/shell/key-bindings.zsh

source $HOME/.config/nvim/autoload/plugged/fzf/shell/completion.bash
source $HOME/.config/nvim/autoload/plugged/fzf/shell/key-bindings.bash

Fast Wrap

input: |[foo, bar()] (press (<M-e> at |)
output: ([foo, bar()])

Quick move char to closed pair

input: (|){["foo"]} (press <M-}> at |)
output: ({["foo"]}|)

input: |[foo, bar()] (press (<M-]> at |)
output: ([foo, bar()]|)

1. For further details check ChrisAtMachine blog.
2. YouTube playlist by ChrisAtMachine.
3. Nerd Fonts on GitHub.
4. Conquer of Completion (CoC) GitHub page.
5. CoC GitHub wiki: Using the configuration file
6. CoC GitHub wiki: Using coc extensions
7. FZF GitHub page.
8. Better project management with a fancy start screen: startify
9. Sane-defaults for startify
10. vim-fugitive GitHub page.
11. vim-gist GitHub page.
12. vim-snippets: GitHub page.
13. coc-snippets GitHub page.
14. Which-Key GitHub page.
15. Emmet-vim GitHub page.