Neovim Lua

My Neovim configuration with Lua (migration from VimL to Lua)

This setup is for neovim >= v0.5.0

Plugins

paq-nvim - Neovim package manager written in Lua

indentLine - Show indent lines

lualine.nvim - Statusline written in pure Lua

nvim-cmp - Auto completion plugin

nvim-lspconfig - A collection of common configurations for Neovim's built-in language server client.

nvim-tree.lua - A File Explorer written In Lua

nvim-web-devicons - A Lua fork of vim-devicons

vista.vim - View and search LSP symbols, tags in Vim/NeoVim

Directory tree of Lua files

~/.config/nvim
.
├── init.lua
└── lua
    ├── keymaps.lua
    ├── plugins
    │   ├── lualine.lua
    │   ├── nvim-cmp.lua
    │   ├── nvim-lspconfig.lua
    │   ├── nvim-tree.lua
    │   ├── paq-nvim.lua
    │   └── vista.lua
    └── settings.lua

Files and settings

init.lua: Main configuration file (call lua modules, load plugins etc.)
lua: Folder of lua modules, here reside all the Lua modules that needed. These modules are called from init.lua file (See below). For plugins settings I use the convention /lua/plugins/<plugin_name>.lua>. See: https://github.com/nanotee/nvim-lua-guide#where-to-put-lua-files
keymaps.lua: Keymaps configuration file, vim/neovim and plugins keymaps.
settings.lua: General Neovim settings and configuration
plugins/lualine.lua: Statusline configuration file (in this case I use this file for lualine.nvim configuration)
plugins/nvim-cmp.lua: Autocompletion settings, TAB completion also for LSP
plugins/nvim-lspconfig.lua: LSP configuration: in this file I insert the language servers for LSP
plugins/nvim-tree.lua: File manager settings
plugins/paq-nvim.lua: Plugin manager settings
plugins/vista.lua: Tag viewer settings

Screenshots

Bash

C

Python

Appearance

Colorscheme: molokai

Fonts: Cozette

Icons: nvim-web-devicons

Startup time

Installation

Install neovim >= v0.5.0
Install npm (for download the packages of LSP language servers)
Download this repository with git and copy the nvim folder

    git clone https://github.com/brainfucksec/neovim-lua.git
    cd neovim-lua/
    cp -Rv nvim ~/.config/nvim/

Install Paq
Open neovim and run the command :PaqInstall to install the plugins

LSP Configuration

Install LSP language servers with npm

    sudo npm install -g bash-language-server pyright vscode-langservers-extracted

Install clang for use LSP with clangd
Open a file with neovim and run command :LspInfo for testing the LSP support

Supported languages in my configuration:

Bash - bashls

Python - pyright

C, C++ - clangd

HTML, CSS, JavaScript - vscode-html

See: nvim-lspconfig #CONFIG.md

TODO

Add Go,Lua (and other languages) to LSP configuration
Improve LSP configuration
Continue the migration from VimL (Vimscript) to Lua :)
Add a start page when Neovim is opened without arguments

Guides and resources

Lua resources

Lua in Y minutes - https://learnxinyminutes.com/docs/lua/
Lua Quick Guide - https://github.com/medwatt/Notes/blob/main/Lua/Lua_Quick_Guide.ipynb
Lua 5.1 Reference Manual - https://www.lua.org/manual/5.1/

Disclaimer

This configuration is in development version. See: Version on init.lua file.
The configuration is being migrated from VimL (Vim Script) to Lua, for now many .vim files are still used.
As all my setups I try to follow the KISS principle, probably some concepts may not be valid for everyone, then feel free to take what you need but don't install anything without checking first!

strange/neovim-lua