Skip to content

README.md

Latest commit

 

History

History
94 lines (62 loc) · 2.64 KB

README.md

File metadata and controls

94 lines (62 loc) · 2.64 KB

Neovim Setup

A fast, modern Neovim setup built for daily development. Opinionated where it matters, minimal where it counts. Designed to stay fast, readable, and maintainable as it evolves.

This setup reflects how I actually work: clean UI, deliberate ergonomics, and a modular Lua architecture that scales without becoming fragile.

✨ Feature Highlights

  • ⚡ Fast startup with lazy-loaded plugins
  • 🎨 Clean and modern UI with polished visuals
  • ⌨️ Thoughtful keymaps focused on editor ergonomics
  • 🧠 LSP, formatting, and tooling for real-world projects
  • 🔍 Telescope-powered navigation and search
  • 🌳 Tree-sitter based syntax highlighting
  • 🔔 Refined notifications and UI components
  • 🧩 Modular and easy-to-extend structure

🧩 Core Components

  • Plugin management powered by lazy.nvim
  • Language Server Protocol (LSP) with sane defaults
  • Formatting & diagnostics wired for consistency
  • Navigation & search centered around Telescope
  • UI layer focused on clarity, not distraction

Every component is configured explicitly. No hidden magic, no unnecessary abstractions.

⌨️ Keybinding Philosophy

Keymaps are designed to be:

  • Intentional — every mapping earns its place
  • Mnemonic — easy to remember, hard to forget
  • Consistent — predictable behavior across modes

Defaults are respected unless there is a strong reason to improve them. The goal is uninterrupted flow and reduced cognitive load.

📁 Directory Structure

~/.config/nvim
├── init.lua
├── lua/
│   ├── config/        # autocmds, keymaps, options
│   ├── lazy/          # lazy.nvim setup & plugin specs
│   ├── craftzdog/     # custom hacks (cowboy-style tweaks)
│   └── plugins/       # individual plugin configurations

Each directory has a single responsibility, making the setup easy to navigate, debug, and extend.

🚀 Installation

git clone https://github.com/ExploitEngineer/nvim ~/.config/nvim

Then launch Neovim:

nvim

Plugins will install automatically on first launch.

🛠 Customization Notes

  • Global options, keymaps, and autocmds live in lua/config/
  • Plugins are declared and managed under lua/lazy/
  • Individual plugin behavior is isolated in lua/plugins/
  • Experimental or unconventional tweaks belong in lua/craftzdog/

This structure is intentional—extend it without rewriting it.

🧭 Final Note

This Neovim setup is not static. It evolves alongside my workflow, tools, and ideas.

If you adopt it, treat it as a foundation—not a finished product.