⚡ BARU's Neovim

A clean, minimal, and lightning-fast Neovim Config.

---

🎬 Preview

Complete Neovim Setup Showcase

A.Beginner_Pro.Neovim.config.SHOWCASE.mp4

---

🎯 Philosophy

Built on three core principles:

• Lightweight: Minimal overhead, instant startup times.
• Understandable: No frameworks, no abstraction layers—pure, readable Lua.
• Synchronized: Seamlessly integrated with your desktop theme and environment.

---

✨ Features

• ⚡ Zero-Framework Lua Engine: Fast startup with a lightweight custom plugin loader.
• 📁 Modern Navigation: File browsing via Oil.nvim and fuzzy search via FZF-Lua.
• 🎨 Multiple Themes & Easy Switching: Built-in curated themes with instant dynamic switching.
• 🪟 Built-in Transparency: Optional full background transparency support.
• 🔐 Git Integration: In-line changes with Gitsigns and full control via Fugitive.
• 📝 Markdown-Focused: Full rendering support, previewing, and TODO highlighting.
• 🌳 Syntax & Treesitter: Precision language parsing and smart code context.

---

🎨 Themes & Switching

This configuration comes pre-loaded with a rich collection of curated colorschemes designed for every mood and lighting condition.

Available Themes

Command / Theme Name	Aesthetic / Palette
:Eink (Default)	Low-contrast, high-readability monochrome inspired by e-ink screens
:Catppuccin	Soothing, warm pastel color palette
:Gruvbox	Retro, warm dark color scheme
:Kanagawa	Elegant theme inspired by classical Japanese art
:Nord	Cool, crisp arctic bluish tones
:Dracula	Dark theme with vibrant purple and neon accents
:RosePine	Soft, cozy dark theme with muted pastel hues
:Everforest	Earthy, comfortable natural green palette
:Moonfly	Deep charcoal dark theme with high-contrast highlights
:Github	Clean, iconic GitHub dark/light aesthetics

---

How to Switch Themes

Option 1: Quick Command (In-Session)

You can switch themes directly in command mode using custom shortcuts:

:Eink
:Catppuccin
:Gruvbox
:Kanagawa
:Nord
:Dracula
:RosePine
:Everforest
:Moonfly
:Github

---

⚡ Quick Start

1. Backup Existing Config (Optional)

mv ~/.config/nvim ~/.config/nvim.backup 2>/dev/null || true

2. Clone the Configuration

git clone https://github.com/6aru/neovim.git ~/.config/nvim

3. Launch Neovim

nvim

Plugins will automatically bootstrap and install on your first launch.

---

📋 Requirements

Type	Package / Utility	Installation (Debian/Ubuntu)
Required	Neovim (>= 0.10)	Build from source or use AppImage
Required	Git & Curl	sudo apt install git curl -y
Required	Nerd Font	Download any Nerd Font for UI icons
Recommended	Search Utilities	sudo apt install ripgrep fd-find fzf nodejs npm shellcheck -y

---

🧩 Key Plugins

Plugin	Purpose
Oil.nvim	Edit your file system like a Neovim buffer
FZF-Lua	Blazing fast fuzzy finder for files, text, and buffers
Alpha.nvim	Clean, minimalist startup dashboard
Bufferline	Sleek tab management
Lualine	Minimal statusline configured for focus
Treesitter	Modern syntax highlight parser
Gitsigns	Git diff indicators in the sign column

---

⌨ Keybindings

(Leader Key = Space)

Navigation & Search

Keybind	Action
Space + e	Toggle Oil File Explorer
Space + f f	Find Files
Space + f w	Live Grep Text
Space + f c	Search Config Files

Buffers & Tabs

Keybind	Action
Tab	Next Buffer
Shift + Tab	Previous Buffer
Space + t	New Tab
Space + x	Close Current Tab

Git & Utilities

Keybind	Action
Space + g g	Git Status (Fugitive)
Space + g b	Switch Git Branches
Space + p p	Toggle Markdown Preview

---

📁 Directory Structure

nvim/
├── init.lua                # Entry point
├── .theme                  # Stores persistent active theme
│
├── lua/
│   ├── core/               # Core options & behaviors
│   │   ├── options.lua     # Editor options
│   │   ├── keybinds.lua    # Key mappings
│   │   ├── transparency.lua# Background transparency logic
│   │   └── autocmds.lua    # Event autocommands
│   │
│   ├── plugins/            # Plugin setup modules
│   │   ├── ui.lua          # UI, Lualine, Alpha
│   │   ├── navigation.lua  # Oil, FZF
│   │   └── editing.lua     # Editing utilities
│   │
│   ├── plugin-list.lua     # List of plugins to load
│   └── plugin-manager.lua  # Custom bootstrap/loader
│
├── .gitignore
├── Screenshot.png
└── README.md

---

🙏 Credits

This project was built on ideas and inspiration from:

• tonybanters/nvim
• JustAGuy Linux

Their work provided the foundation for my nvim-config structure, plugin management ideas, and many design concepts that helped shape this configuration.

---

⭐ If you found this repository useful, please consider leaving a star.

Built with ❤️ using Neovim, Lua, Debian, and i3.