🚀 Personal Neovim Configuration

A modern, high-performance Neovim configuration bootstrapped from kickstart.nvim. Designed for speed, aesthetics, and a seamless developer experience with lazy-loaded plugins via lazy.nvim.

⚡ Features

• Blazing Fast: Optimized startup with aggressive lazy-loading.
• Modern UI: Clean statusline, tabline with icons, and floating windows.
• Git Integration: Integrated lazygit, inline blame, and hunk management via gitsigns.
• Search & Navigation: Powerful fuzzy finding with telescope and fast jumping with flash.nvim.
• File Management: neo-tree for sidebar exploration and oil.nvim for buffer-like FS editing.
• LSP & Autocomplete: Full LSP support (Mason-managed) with blink.cmp for superior completion.
• Productivity: mini.nvim modules for surround, pairs, commenting, and more.

📋 Requirements

• Neovim 0.12+ (Recommended for latest features)
• Git (For plugin management)
• Ripgrep (For fast searching)
• FD (For fast file finding)
• Nerd Font (Optional, but highly recommended for icons)

Optional Dependencies

• unzip, make, gcc/zig (For compiling certain telescope extensions)
• xclip/xsel (Linux) or win32yank (Windows) for system clipboard support.

📥 Installation

1. Clone the repository

Linux / macOS

git clone https://github.com/lubasinkal/nvim.git "${XDG_CONFIG_HOME:-$HOME/.config}/nvim"

Windows (PowerShell)

git clone https://github.com/lubasinkal/nvim.git "$env:LOCALAPPDATA\nvim"

2. Launch Neovim

Simply run nvim. All plugins will automatically download and install on the first launch.

🚀 Quick Setup (Windows/Scoop)

If you use Scoop, you can install all dependencies at once:

scoop bucket add extras
scoop install neovim git ripgrep fd unzip make zig nodejs win32yank lazygit

⌨️ Keybindings

This config uses <Space> as the Leader key.

Group	Key	Description
Explorer	<leader>e	Toggle Neo-tree
Search	<leader>sf	[F]ind Files
Search	<leader>sg	By [G]rep
Git	<leader>gg	Open Lazygit
Sessions	<leader>ws	[S]ave Session
Terminal	<leader>tt	[T]oggle Floating Terminal
UI	<leader>ub	Toggle Inline [B]lame

Pro Tip: Press <leader> and wait for a second; which-key will pop up and show you all available mappings!

🛠️ Customization

Most custom logic resides in lua/config/:

• options.lua: Vim settings.
• keymaps.lua: Global keybindings.
• plugins/: Individual plugin configurations.
• util/: Helper scripts for terminal, sessions, and tabs.

📚 Resources

• :help kickstart - Documentation for the base config.
• :help lua-guide - Neovim's official Lua guide.
• lazy.nvim - Plugin manager documentation.

---

Maintained by lubasinkal