Lite Neovim Distro: A Blazing Fast, Lightweight Neovim Setup

#beginners #vim #linux #bash

Introduction
Motivation
Features
Usage
Conclusions
Social Links

Introduction

Welcome to Lite Neovim Distro, a project tailored for those eager to dive into Neovim without any prior configuration knowledge, including my future self! 😄 This minimalist Neovim distribution offers a lightning-fast and lightweight setup right out of the gate.

What sets this project apart is its comprehensive guide. Whether you're interested in configuring Neovim yourself or simply want to jump right in, our guide covers all the prerequisites and installation steps to get you up and running with my customized Neovim configuration. Don't hesitate to explore it!

Motivation

As a Vim aficionado, I've always admired its efficiency. While it's perfect for basic tasks, I often resorted to VSCode for more complex projects. Seeking to streamline my workflow, I experimented with various setups, ultimately embracing Neovim with Lua scripting for its speed and flexibility.

Existing distributions like NVChad were bogged down with plugins, slowing performance. Hence, I crafted a custom configuration focused solely on essential plugins. With Packer and Lua, I optimized my setup for efficiency and speed.

Managing this setup across different systems posed challenges. To simplify, I meticulously documented prerequisites and streamlined installation to a single step. Now, setting up my Neovim environment is quick and consistent across systems.

Picture yourself on a server needing quick edits. With Lite Neovim Distro, you can swiftly establish a lightweight Neovim environment, boosting efficiency and productivity.

Features

Key Notes:

The <leader> is the space key.

This distro comes with only the NodeJs Debugger. I'm not a Debugger guy :)

I have configured only for the following; Find Tweak the config from the Adapter's section

Javascript/Typescript: Tested

Testing with Jest (Assumes you have Jest installed on your local project): Tested

React Vite: Tested

React NextJs: Not-Tested

So if you need a debugger for any other programming language you will need to configure it yourself

PACKER:
- An easy-to-use plugin manager. (Optional Read more about this plugin)
TELESCOPE:
- Fuzzy finding (<leader>ff), live grep (<leader>fg), etc. (Optional Read more about this plugin)
GITHUB-THEME:
- A beautiful GitHub theme pack (:colorscheme github_dark). (Optional Read more about this plugin)
NVIM-TREE:
- A modern File tree (<leader>n), etc. (Optional Read more about this plugin)
WEB-DEVICONS:
- Displays icons. (Optional Read more about this plugin)
LUALINE:
- A beautiful status line. (Optional Read more about this plugin)
TREESITTER:
- Syntax highlighting, etc. (Optional Read more about this plugin)
GITSIGNS:
- Signs for added, removed, and changed lines, etc. (Optional Read more about this plugin)
BARBAR:
- A beautiful tabs manager (<leader>bq -> quit the current tab). (Optional Read more about this plugin)
MININTRO:
- A beautiful "NEOVIM" intro when you type just nvim from the OS's terminal. (Optional Read more about this plugin)
TELESCOPE-UNDO:
- A telescope extension for undo history (<leader>fu). (Optional Read more about this plugin)
OIL:
- A beautiful and fast file explorer (- -> Opens current/previous directory). (Optional Read more about this plugin)
NVTERM:
- A beautiful terminal emulator (<leader>tv -> Toggle vertical terminal). (Optional Read more about this plugin)
GITHUB-COPILOT:
- AI-powered code completion (<TAB> -> autocomplete the suggestion). (Optional Read more about this plugin)
WHICH-KEY:
- A keybindings helper. (Optional Read more about this plugin)
ZEN-MODE:
- A distraction-free writing (focus) mode. (Optional Read more about this plugin)
TELESCOPE-TODO-COMMENTS:
- A telescope extension to manage all todo comments (<leader>fc -> list all todo comments). (Optional Read more about this plugin)
AUTO-SESSION:
- Let Neovim remember your opened files (<leader>fs -> switch to previously saved sessions). (Optional Read more about this plugin)
COMMENT:
- Toggle comments with ease (gcc). (Optional Read more about this plugin)
SURROUND:
- Surround text with ease (ysiw} -> surrounds word with {}). (Optional Read more about this plugin)
VISUAL-MULTI:
- Work with Multiple cursors (<C-n>). (Optional Read more about this plugin)
COC:
- A marketplace (:CocInstall marketplace) packed with extensions (<leader>m), like LSPs (:CocInstall coc-tsserver), linters (:CocInstall coc-eslint), etc. (Optional Read more about this plugin)
DAP:
- A debugger for Neovim (<leader>dc -> continue, <leader>db -> toggle breakpoint). (Optional Read more about this plugin)
NVIM-DAP-VSCODE-JS:
- A NodeJS Debug Adapter. (Optional Read more about this plugin)

Usage

To use Lite Neovim Distro, follow these steps:

Backup or Remove your existing Neovim config (~/.config/nvim). If you don't have any existing Neovim configuration, you can skip this step.

Install the config:

 git clone https://github.com/stanleyogada/lite-neovim-distro.git ~/.config/nvim && nvim

Note: If you get an error, just Hit the ENTER KEY on your keyboard twice and Packer will fix the errors and set everything up for you.
If you're still getting any errors, you might be missing 1 or more requirements on your system, definitely check out the docs for more info

You're all set 🚀
```
 nvim
```

Conclusions

Lite Neovim Distro provides a streamlined Neovim setup, prioritizing speed and efficiency. With its minimalist approach and essential plugins, you can enjoy a powerful editing experience without the bloat. Give it a try and elevate your text editing workflow!