neovim-config/README.md

🌙 Rootiest Neovim

A modern, modular, and high-performance Neovim configuration built from scratch with a focus on simplicity, speed, and standard Neovim primitives.

✨ Highlights

• Built-in Package Management: Exclusively uses vim.pack for lightweight, native plugin management.
• Phased Loading: Async, non-blocking startup using a phased VimEnter queue for a snappy experience.
• Unified Registry: Configuration is managed via a global _G.Config registry, ensuring cross-plugin consistency.
• High Performance: Featuring blink.cmp (Rust-based completion) and optimized Snacks.nvim components.
• AI-Powered: Native integration with the GitHub Copilot Language Server.
• User-Centric QoL: Hybrid line numbers, autosave-on-edit, and seamless system clipboard integration.

📁 Architecture

The configuration is strictly modular:

• init.lua: Entry point and global state initialization.
• lua/lazyload.lua: Logic for async and phased plugin loading.
• lua/options.lua: Global Vim settings and non-plugin autocommands.
• lua/plugins.lua: Plugin declarations and detailed registry-based configurations.
• lua/keymaps.lua: Centralized user-facing keybindings.
• lua/const.lua: Stores constant values for reference in the configuration.

🚀 Getting Started

Prerequisites

• Neovim 0.10+
• Nerd Font (Mono variant recommended for optimal UI alignment)
• Cargo (Required for building blink.cmp fuzzy matching library)
• Node.js (Required for various LSPs and Copilot)

Installation

git clone https://github.com/your-username/nvim-config ~/.config/nvim
nvim

Post-Install

1. Build Blink: If completion isn't working, run cargo build --release inside ~/.local/share/nvim/site/pack/core/opt/blink.cmp.
2. LSP Servers: Run :Mason to monitor the installation of Language Servers (Lua, C, Rust, Python, etc.).
3. Copilot: Run :LspCopilotSignIn to authenticate with GitHub.

⌨️ Key Features & Mappings

Key	Description
<leader><space>	Smart Find Files (Snacks)
<leader>e	File Explorer
<leader>ff	Find Files
<leader>sg	Project-wide Grep
gd / gr	Go to Definition / References
K	Hover Documentation
s / S	Leap Motion (Normal/Window)
ys / ds	Mini.surround (Add/Delete)
:Q	Forced Write-All and Quit

📜 License

Distributed under the GPLv3 or later License. See LICENSE for more information.