init.nvim

Why?

Modern Vim distributions are really huge and bloated with way too many fancy features that you won't ever use or need, for example directory trees like Nerd tree, you don't need a tree, you can view a project structure with fzf which is faster and has search. Another example is ThinkVim has a separate extension for formatting while also having ALE which can do that as well, this double functionality is very common, thats one of the things this distro avoids, KISS!

Features

• Lua-first Neovim config
• Native LSP powered by Neovim, Mason, Conform, and Blink
• Lazy-managed plugins with modular config under lua/config/ and

• Ayu-based theme with automatic light/dark switching, custom floats, and a

• Modern Snacks-based picker and scrolling workflow
• Noice-powered command line and notifications
• Simple, intuitive shortcuts

Supported Languages

Built-in LSP and formatter setup is included for Bash, C/C++, CSS, HTML, JSON, Lua, Python, TypeScript, XML, and YAML. Mason installs the configured language servers and formatters automatically on startup.

Requirements

• Linux (not tested on other platforms)
• Neovim 0.11+
• Properly set up environment

Setup

To check if your current environment is correctly set up run :CheckHealth.

Environment

• python3: pip3 install --user pynvim
• npm install -g neovim

Tools

• Any patched nerd font
• tmux (not required but recommended)
• git
• ripgrep
• a C toolchain for clangd / clang-format

Installation

After installing the requirements:

• git clone https://github.com/Blacksuan19/init.nvim ~/.config/nvim
• Start nvim and it will do the rest
• press enter if there are any errors (don't worry its fine)

Plugins

Plugins are managed by lazy.nvim, with language servers and formatters handled by Mason.

| Plugin | Functionality | | --------------------------------------------------------------------------------------------- | -------------------------------------------- | | lazy.nvim | plugin management | | blink.cmp | completion UI | | conform.nvim | formatting | | gitsigns.nvim | git signs in the gutter | | mason.nvim | external tool management | | mason-lspconfig.nvim | LSP server installation bridge | | mason-tool-installer.nvim | auto-installs tools on startup | | mini.nvim | icons, comments, move, surround | | nvim-lspconfig | LSP server configs | | alpha-nvim | start screen | | neovim-ayu | colorscheme | | noice.nvim | command line and message UI | | nvim-notify | notifications | | rainbow-delimiters.nvim | rainbow bracket highlighting | | friendly-snippets | VS Code-style snippet collection for Blink | | blink-cmp-conventional-commits | conventional commit suggestions for Blink | | blink-cmp-tmux | tmux pane text as a Blink completion source | | blink-cmp-words | English words and synonyms for Blink | | snacks.nvim | indent guides, picker, smooth scrolling | | auto-dark-mode.nvim | automatic theme switching | | MatchTag | matching HTML/XML tags | | vim-fugitive | best git integration around | | tmux-navigator | seamless movement between Vim and tmux panes | | vim-eunuch | some common Linux commands |

Keyboard shortcuts

To learn the default Vim shortcuts run Tutor and or checkout this vim adventures.

Essentials

| Mapping | functionality | | ------------ | ------------------------------- | | ; | commands key | | , | leader key | | leader + w | save changes | | leader + e | sync plugins with Lazy | | Enter | enter empty line in normal mode | | S-Enter | enter empty line above | | F2 | trim trailing whitespace | | F6 | open the start screen |

Visual Mode Essentials

| Mapping | functionality | | ---------- | ------------------------------- | | ctrl + j | move selected text to bottom | | ctrl + k | move selected text to top | | ctrl + h | move selected text to the left | | ctrl + l | move selected text to the right |

Navigation

ctrl + hjkl navigation also supports tmux panes.

| Mapping | functionality | | ------------ | -------------------------------------- | | leader + q | confirm and delete current buffer | | \ | alias for leader + q | | ctrl + q | confirm and quit Neovim | | ctrl + l | move to the split on the right | | ctrl + k | move the split above | | ctrl + j | move to the split on below | | ctrl + h | move the split to the left | | Tab | switch to the next buffer(normal mode) | | S-Tab | switch to the previous buffer |

IDE Features

| Mapping | functionality | | ------------- | ------------------------------------ | | OR | organize imports | | leader + a | run code action | | leader + s | format file with available formatter | | leader + rn | rename globally | | leader + jd | jump to definition | | leader + jy | jump to type definition | | leader + ji | jump to implementation | | leader + jr | jump to references | | K | show current symbol documentation | | ]g | next diagnostic | | g | Previous diagnostic |

[

Credits

All the Credit goes to the Neovim team for making most of the extensions possible and better (async), and to all the plugins developers, and the hackers who spend time Finding good shortcuts and tricks to make this an even more superb experience.