Lean mean Neovim machine, 30-45ms startup time. Works best with Neovim ≥0.10

⚙️ See "Extending" for customizing configuration and adding plugins.

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 remote and stay in-touch with upstream for reference or cherry-picking.

• Fast startup time — plugins are almost entirely lazy-loaded!
• Robust, yet light-weight
• Plugin management with folke/lazy.nvim. Use with :Lazy or Space+l
• Install LSP, DAP, linters, and formatters. Use with :Mason or Space+mm
• LSP configuration with nvim-lspconfig
• telescope.nvim centric work-flow with lists (try ;+f…)
• Custom context-menu (try it! ;+c)
• Auto-complete extensive setup with nvim-cmp (try Tab or Ctrl+Space in insert-mode)
• Structure view with [hedyhli/outline.nvim]
• Git features using lewis6991/gitsigns.nvim, sindrets/diffview.nvim, and more
• Session management with folke/persistence.nvim
• Unobtrusive, yet informative status & tab lines
• Premium color-schemes
• Remembers last-used colorscheme

• git ≥ 2.19.0 (brew install git)
• Neovim ≥ v0.10.0 (brew install neovim)

Optional, but highly recommended:

• bat (brew install bat)
• fd (brew install fd)
• fzf (brew install fzf)
• ripgrep (brew install ripgrep)
• zoxide (brew install zoxide)

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

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

2. Run nvim (will install all plugins the first time).

   It's highly recommended running :checkhealth to ensure your system is healthy and meet the requirements.

3. Inside Neovim, run :LazyExtras and use x to install extras.

Enjoy! 😄

Use :Mason (or Space+mm) to install and manage LSP servers, DAP servers, linters and formatters. See :h mason.nvim and williamboman/mason.nvim for more information.

You can install LSP servers using :Mason UI, or :MasonInstall <name>, or :LspInstall <name> (use Tab to list available servers). See Mason's PACKAGES.md for the official list, and the Language server mapping list. You can also view at :h mason-lspconfig-server-map

You'll need utilities like npm and curl to install some extensions, see requirements (or :h mason-requirements) for more information.

See lua/rafi/plugins/lsp/init.lua for custom key-mappings and configuration for some language-servers.

:MasonInstall ansible-language-server bash-language-server css-lsp
:MasonInstall dockerfile-language-server gopls html-lsp json-lsp
:MasonInstall lua-language-server marksman pyright sqlls
:MasonInstall svelte-language-server typescript-language-server
:MasonInstall tailwindcss-language-server
:MasonInstall vim-language-server yaml-language-server

and more…

:MasonInstall vint shellcheck editorconfig-checker flake8 gitlint hadolint
:MasonInstall markdownlint mypy selene shellharden write-good yamllint

:MasonInstall black fixjson gofumpt golines isort
:MasonInstall shfmt sql-formatter stylua

• 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

To upgrade packages and plugins:

• Neovim plugins: :Lazy update
• Mason packages: :Mason and press U

To update Neovim configuration from my repo:

git pull --ff --ff-only

• after/ — Language specific custom settings and plugins.
• lua/ — Lua configurations
  • config/ — Custom user configuration
  • plugins/ — Custom user plugins (or lua/plugins.lua)
  • rafi/
    • config/ — Neovim configurations
      • autocmd.lua — Auto-commands
      • init.lua — Initialization
      • keymaps.lua — Key-mappings
      • lazy.lua — Entry-point initialization
      • options.lua — Editor settings
    • plugins/ — Plugins and configurations
    • util/ — Utility library
• snippets/ — Personal code snippets

Fork this repository and create a directory lua/config with one or more of these files: (Optional)

• lua/config/autocmds.lua — Custom auto-commands
• lua/config/options.lua — Custom options
• lua/config/keymaps.lua — Custom key-mappings
• lua/config/setup.lua — Override config, see extend defaults.

Adding plugins or override existing options:

• lua/plugins/*.lua or lua/plugins.lua — Plugins (See lazy.nvim specs for syntax)

Install "extras" plugins using :LazyExtras and installing with x. This saves choices in lazyvim.json which you can also edit manually, here's a recommended starting point:

{
  "extras": [
    "lazyvim.plugins.extras.ai.copilot",
    "lazyvim.plugins.extras.dap.core",
    "lazyvim.plugins.extras.dap.nlua",
    "lazyvim.plugins.extras.lang.docker",
    "lazyvim.plugins.extras.lang.json",
    "lazyvim.plugins.extras.lang.typescript",
    "lazyvim.plugins.extras.lang.yaml",
    "lazyvim.plugins.extras.test.core",
    "rafi.plugins.extras.coding.align",
    "rafi.plugins.extras.editor.harpoon2",
    "rafi.plugins.extras.git.cmp-git",
    "rafi.plugins.extras.lang.ansible",
    "rafi.plugins.extras.lang.go",
    "rafi.plugins.extras.lang.helm",
    "rafi.plugins.extras.lang.markdown",
    "rafi.plugins.extras.lang.python",
    "rafi.plugins.extras.lang.tmux",
    "rafi.plugins.extras.ui.deadcolumn"
  ],
  "news": [],
  "version": 2
}

For installing/overriding/disabling plugins, create a lua/plugins/foo.lua file (or lua/plugins/foo/bar.lua or simply lua/plugins.lua) and manage your own plugin collection. You can add or override existing plugins' options, or just disable them all-together. Here's an example:

return {

  -- Disable default tabline
  { 'akinsho/bufferline.nvim', enabled = false },

  -- And choose a different one!
  -- { 'itchyny/lightline.vim' },
  -- { 'vim-airline/vim-airline' },
  -- { 'glepnir/galaxyline.nvim' },
  -- { 'glepnir/spaceline.vim' },
  -- { 'liuchengxu/eleline.vim' },

  -- Enable GitHub's Copilot
  { import = 'lazyvim.plugins.extras.ai.copilot' },

  -- Enable incline, displaying filenames on each window
  { import = 'rafi.plugins.extras.ui.incline' },

  -- Disable built-in plugins
  { 'shadmansaleh/lualine.nvim', enabled = false },
  { 'folke/persistence.nvim', enabled = false },

  -- Change built-in plugins' options
  {
    'nvim-treesitter/nvim-treesitter',
    opts = {
      ensure_installed = {
        'bash', 'comment', 'css', 'diff', 'dockerfile', 'fennel', 'fish',
        'gitcommit', 'gitignore', 'gitattributes', 'git_rebase', 'go', 'gomod',
        'gosum', 'gowork', 'graphql', 'hcl', 'html', 'javascript', 'jsdoc',
        'json', 'json5', 'jsonc', 'jsonnet', 'lua', 'make', 'markdown',
        'markdown_inline', 'nix', 'perl', 'php', 'pug', 'python', 'regex',
        'rst', 'ruby', 'rust', 'scss', 'sql', 'svelte', 'terraform', 'toml',
        'tsx', 'typescript', 'vim', 'vimdoc', 'vue', 'yaml', 'zig',
      },
    },
  },

}

1. Create lua/config/options.lua and set any Neovim/RafiVim/LazyVim features: (Default values are shown)

   -- Elite-mode (hjkl mode. arrow-keys resize window)
   vim.g.elite_mode = false
   
   -- External file diff program
   vim.g.diffprg = 'bcompare'
   
   -- Auto format on-save
   vim.g.autoformat = false
   
   -- Snacks animations
   vim.g.snacks_animate = false

2. You can override LazyVim options. For example in lua/plugins/lazyvim.lua:

   return {
     {
       'LazyVim/LazyVim',
       opts = {
         icons = {
           diagnostics = {
             Error = '',
             Warn  = '',
             Info  = '',
           },
           status = {
             diagnostics = {
               error = 'E',
               warn  = 'W',
               info  = 'I',
               hint  = 'H',
             },
           },
         },
       },
     },
   }

3. You can override lazy.nvim (package-manager) global options. Create lua/config/setup.lua and return this function:

   • lazy_opts() — override LazyVim setup options

   For example:

   local M = {}
   
   ---@return table
   function M.lazy_opts()
     return {
       -- See https://github.com/folke/lazy.nvim/#%EF%B8%8F-configuration
       concurrency = jit.os:find('Windows') and (vim.uv.available_parallelism() * 2) or nil,
     }
   end
   
   return M

4. You can completely override lazy.nvim setup by creating lua/config/lazy.lua to replace lua/rafi/config/lazy.lua with your own procedure.

Override server options with nvim-lspconfig plugin, for example:

{
  'neovim/nvim-lspconfig',
  opts = {
    servers = {
      yamlls = {
        filetypes = { 'yaml', 'yaml.ansible', 'yaml.docker-compose' },
      },
      lua_ls = {
        settings = {
          Lua = {
            workspace = { checkThirdParty = false },
            completion = { callSnippet = 'Replace' },
          },
        },
      },
    },
  }
}

• Plugin management with cache and lazy loading for speed
• Auto-completion with Language-Server Protocol (LSP)
• Project-aware tabline
• Extensive syntax highlighting with nvim-treesitter.

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

Note that,

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