Rafael Bodill's Neovim Config

Lean mean Neovim machine, 30-45ms startup time.

Works best with Neovim 0.5.x ⚠️ For Vim 8.x, use thevim git tag.

I encourage you to fork this repo and create your own experience.Learn how to tweak and change Neovim to the way YOU like it.This is my cultivation of years of tweaking, use it as a git remoteand stay in-touch with upstream for reference or cherry-picking.

Features

• Fast startup time
• Robust, yet light-weight
• Lazy-load 95% of plugins with Shougo/dein.vim
• LSP installers (:LspInstall <server>)
• Custom side-menu (try it! Space+l)
• Custom context-menu (try it! ;+c)
• Auto-complete extensive setup with nvim-lspconfig and nvim-cmp(try Tab in insert-mode)
• telescope.nvim centric work-flow with lists (try ;+f…)
• Structure view with simrat39/symbols-outline.nvim
• Git features using lambdalisue/gina.vim and lewis6991/gitsigns.nvim
• Auto-save and restore sessions with rmagatti/auto-session.
• Light-weight but informative status & tab lines
• Easy customizable theme
• Premium color-schemes

Screenshot

Prerequisites

• Neovim(brew install neovim) ≥ v0.5.0
• Plugins are parsed from YAML and cached.Ensure one of these tools is installed:
  • yj (brew install yj)
  • yq (brew install yq)
  • yaml2json
  • Ruby
  • Python with PyYAML (pip install PyYAML)

Install

1. Let's clone this repo! Clone to ~/.config/nvim

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

2. Run make test to test your nvim version and capabilities.

3. Run make to install all plugins.

4. If you are experiencing problems, run and read nvim -c checkhealth

Enjoy! ��

Language-Server Protocol (LSP)

To leverage LSP auto-completions and other functionalities, once you open afile in Neovim, run :LspInstall <server> to usewilliamboman/nvim-lsp-installer installation feature.Use Tab to list available servers.

Here are some useful LSP server installations:

• :LspInstall html cssls jsonls yamlls
• :LspInstall gopls
• :LspInstall pylsp
• :LspInstall bashls vimls sumneko_lua
• :LspInstall diagnosticls
• and more…

See lua/plugins/lspconfig.lua and lua/lsp/* for built-inmapping and configuration for several language-servers. You'll need utilitieslike npm and curl to install some extensions. For more information, see:

• Plugin used for installation: williamboman/nvim-lsp-installer andsupported language-servers.
• Plugin used for configuration: neovim/nvim-lspconfig

Upgrade

cd ~/.config/nvim
make update

This will run git pull --ff --ff-only and update all plugins usingShougo/dein.vim package-manager (:call dein#update()).

Recommended Fonts

• Pragmata Pro (€19 – €1,990): My preferred font
• Any of the Nerd Fonts

On macOS with Homebrew, choose one of the Nerd Fonts,for example, here are some popular fonts:

brew tap homebrew/cask-fonts
brew search nerd-font
brew install --cask font-victor-mono-nerd-font
brew install --cask font-iosevka-nerd-font-mono
brew install --cask font-hack-nerd-font
brew install --cask font-fira-code

Recommended Linters

• macOS with Homebrew:

brew install vint shellcheck jsonlint yamllint
brew install tflint ansible-lint tidy-html5 proselint write-good

• Node.js based linters:

yarn global add markdownlint-cli eslint jshint stylelint sass-lint

• Python based linters:

pip3 install --user pycodestyle pyflakes flake8

Recommended Tools

• ripgrep: BurntSushi/ripgrep(macOS: brew install rg)
• Jump around with zoxide: ajeetdsouza/zoxide(macOS: brew install zoxide)
• Fuzzy file finders:fzf, orfzy,(macOS: brew install fzf)

User Custom Config

For custom configuration, create the config/local.vim fileand add your personal vimscript there.

For installing plugins, create a config/plugins.local.yaml file andmanage your own plugin collection. If you want to disable some of the pluginsI use, you can overwrite them, e.g.:

- { repo: shadmansaleh/lualine.nvim, if: 0 }

Using config/plugins.local.yaml you can install any plugin you want, e.g.:

# Choose only ONE of these statuslines ;)
- repo: itchyny/lightline.vim
- repo: vim-airline/vim-airline
- repo: glepnir/galaxyline.nvim
- repo: glepnir/spaceline.vim
- repo: liuchengxu/eleline.vim

You can set global specific features by defining in your localconfig/local.vim:

let g:elite_mode = 1                     " Set arrow-keys to window resize
let g:global_symbol_padding = '  '       " Padding after nerd symbols
let g:tabline_plugin_enable = 0          " Disable built-in tabline
let g:enable_universal_quit_mapping = 0  " Disable normal 'q' mapping
let g:disable_mappings = 0               " Disable config/mappings.vim

To override LSP configurations, create a lua/lsp-local/<server_name>.luafile. Must return a table with config function. For example, createlua/lsp-local/go.lua:

local config = {
  settings = {
    gopls = {
      staticcheck = true
    }
  }
}

return {
  config = function(_) return config end,
}

⚠️ This will completely overwrite built-in lua/lsp/go.lua.

Structure

• after/ - Language specific custom settings
• autoload/ - Action-menu and badge functions
• config/ - Configuration
  • plugins/ - Plugin configurations
    • all.vim - Plugin mappings
    • …
  • general.vim - General configuration
  • init.vim - Package-manager initialization
  • plugins.local.yaml - Custom user plugins
  • local.vim - Custom user settings
  • mappings.vim - Key-mappings
  • plugins.yaml - My favorite Plugins!
  • vimrc - Initialization
• lua/ - Lua plugin configurations
  • lsp/ - LSP configurations
  • lsp-local - Custom user LSP configurations
  • plugins/ - Plugins configurations
  • badge.lua - Badges for status lines
  • user.lua - Custom functions
• plugin/ - Custom written plugins
• snippets/ - Personal code snippets
• themes/ - Colorscheme overrides
• filetype.vim - Custom filetype detection

Plugin Highlights

• Plugin management with cache and lazy loading for speed
• Auto-completion with Language-Server Protocol (LSP)
• Project-aware tabline
• Fern as file-manager + Git status icons
• Extensive syntax highlighting with nvim-treesitter.

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

Plugins Included

Custom Key-mappings

Note that,

• Leader key set as Space
• Local-Leader key set as ; and used for navigation and search(Telescope and Fern)
• Disable ← ↑ → ↓ in normal mode by enabling g:elite_mode in .vault.vim