Awesome Neovim Configuration

This repo it to make setting up of [neovim][nvim] >= 0.11 a breeze. The setup is powered and managed by [💤 lazy.nvim][lazy-nvim] plugin manager

>If you like helix, which I am drifting to gradually, check out my [helix config_][awesome-helix]

✨ Features Supported

• ⚡ zig, 󰙱 C ,  C++, 󰢱 lua and all other language compilers
• 📦 linters and static analysis through null-ls
• 🥂 lsp servers configured with nvim-lspconfig
• 🧹 autocompletion, formatters and all other features supported by neovim's builtin lsp
• 🦸 Any build system
• ✴️ Treesitter syntax highlighting
• 🔥 Transform your Neovim editor into a full-fledged IDE
• 💤 Easily customize and extend config
• 🚀 Blazingly fast using 💤 [lazy.nvim][lazy-nvim] and the new lua-loader that byte-compiles and caches lua files

😍 Screenshots

 C++

⚡ Zig

󰢱 Lua

🚀 Startup Time

⚡️ Requirement

• Neovim >= 0.11 (needs to be built with LuaJIT)
• git >= 2.52 (gitsigns ...)
• tree-sitter >= 0.25 (to enable automatically installing missing parsers when entering buffers)
• a Nerd Font (optional, for nvim-tree, lualine, bufferline)_

>NOTE the languages supported out of the box are

zig, c++, c, lua, bash/zsh, glsl, json

But support for other languages like(js, ts, html5+, css3+, vue, markdown, nix) can easily be add by using

its required lsp server configuration

📂 Directory structure

📂 ~/.config/nvim
    ├── 📂 ftplugin
    │  └── 📂 lua
    │  │   └──  mapping.lua
    │  ├──  gitcommit.lua
    │  ├──  help.lua
    │  └──  zsh.lua
    ├── 📂 lua
    │  └── 📂 config
    │  │   ├──  autocmds.lua
    │  │   ├──  defaults.lua
    │  │   ├──  init.lua
    │  │   ├──  keymaps.lua
    │  │   ├──  lazy.lua
    │  │   ├──  options.lua
    │  │   ├──  syntax.lua
    │  │   └──  utils.lua
    │  └── 📂 plugins
    │      ├──  cmp.lua
    │      ├──  colorscheme.lua
    │      ├──  editor.lua
    │      ├──  gitsigns.lua
    │      ├──  lsp.lua
    │      ├──  neorg.lua
    │      ├──  snip.lua
    │      ├──  telescope.lua
    │      ├──  tree.lua
    │      ├──  treesitter.lua
    │      └──  ui.lua
    ├──  init.lua
    ├──  lazy-lock.json
    ├──  LICENSE
    └──  README.md

ftplugin directory contains files for setting options or mappings specific to filetypes

lua/config directory contains editor autocmds, keymaps, options, defaults, syntax files, utils fn's and lazy.nvim configuration

lua/plugins directory contains all plugins configurations and their mappings

init initializing/start point for nvim editor

🚀 Getting Started

You can find awesome-neovim [here][awesome-nvim]

mv ~/.config/nvim ~/.config/nvim.bak
  mv ~/.local/share/nvim ~/.local/share/nvim.bak

git clone https://github.com/${YOUR-USERNAME}/awesome-neovim $XDGCONFIGHOME/nvim

nvim

⚙️ For information on how to use [lazy.nvim][lazy-nvim]

You can thoroughly go through awesome-neovim configuration and if more clarification is required read [lazy's][lazy-nvim] README

for help using the various plugins and extensions

:help local-addtions

To view the help pages and instruction manual on the various extensions

[awesome-nvim]: https://github.com/Ultra-Code/awesome-neovim [lazy-nvim]: https://github.com/folke/lazy.nvim [nvim]: https://github.com/neovim/neovim/ [awesome-helix]: https://github.com/Ultra-Code/awesome-helix

👏 Credit

• Huge credit to @folke, I learnt a lot from his lazy config repo
• Big Shout Out to the creators of the various plugins which make nvim terrific
• Another to all the creators of the various neovim extensions.