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!

• Lua-first Neovim config
• Native LSP powered by Neovim, Mason, Conform, and Blink
• Lazy-managed plugins with modular config under lua/config/ and lua/plugins/
• Ayu-based theme with automatic light/dark switching, custom floats, and a custom statusline
• Modern Snacks-based picker and scrolling workflow
• Noice-powered command line and notifications
• Simple, intuitive shortcuts

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.

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

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

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

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

Most language servers and formatters are installed automatically through Mason.

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 are managed by lazy.nvim, with language servers and formatters handled by Mason.

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

ctrl + hjkl navigation also supports tmux panes.

This config is organized as a small Lua codebase rather than a single init file. Core editor behavior lives under lua/config/, while plugin declarations and plugin-specific setup live under lua/plugins/. That makes it easier to change one part of the setup without digging through unrelated settings.

If you want to customize behavior, the most useful places to look are:

• lua/config/options.lua for editor options

• lua/config/keymaps.lua for global mappings

• lua/config/autocmds.lua for editor automation

• lua/config/theme.lua and lua/config/statusline.lua for appearance

• lua/plugins/*.lua for plugin choices and plugin-specific behavior

• Disabling Plugins: remove or edit the relevant spec under lua/plugins/ and adjust any matching config under lua/config/

• Managing LSP tools: use :Mason, :MasonToolsInstall, and :MasonToolsUpdate

• Formatting: use :Format to format the current buffer with Conform

• Adding Bookmarks: to add bookmarks to the start page, find the Alpha start screen config in lua/plugins/alpha.lua

• Reloading config: a full Neovim restart is still the most reliable way to apply changes across this Lua config, especially plugin spec edits

For deeper customization, read through the relevant Lua module and then check the upstream plugin documentation for any extra options you want to enable.

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.