Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/midhunterx/nvme

πŸ‘¨β€πŸ’» A personalized NeoVim from scratch with all the features that I want for 100% comfortable development.
https://github.com/midhunterx/nvme

ide lua neovim neovim-config rice

Last synced: 10 months ago
JSON representation

πŸ‘¨β€πŸ’» A personalized NeoVim from scratch with all the features that I want for 100% comfortable development.

Awesome Lists containing this project

README 

          
image:./img/nvim_dashboard.jpg[]



= NvME

/ΛˆΙ›nvi mi:/



A **ME**ticulous nvim distribution, crafted from scratch solely for **ME** with

every features and keybindings configured to offer supre**ME** comfort and

comple**ME**nt **ME** workflow im**ME**nsely.



== ⚑ Requirements



* *Neovim* (Needs to be built with LuaJIT)

* *GCC*: For compiling treesitter languages in Linux

* *Zig Compiler*: For compiling treesitter languages in Windows

* *git*: For git integration, cloning plugin repos etc.

* *ripgrep*: For live grep

* *fd*: For Find Files

* *vifm*: File Manager

* *lazygit*: Git UI

* *python*: For Python Language Server & Black Formatter

* *nodejs*: For other Language Servers and Formatters

* *live-server* (npm): For local HTML Server

* *Windsurf account*: Auth for AI code completion



=== Install Requirements



.πŸ… Arch Based System (pacman)

[source,bash]

----

sudo pacman -S neovim git ripgrep fd vifm lazygit python npm

sudo npm install -g live-server

----



== πŸš€ Install (backups prev config if any)



If any config is already present, it backups your config and puts NvME in place.



=== 🐧 Linux



* Suggested Compiler: *GCC*



.bash / zsh

[source,bash]

----

ME=~/.config/nvim; [ -d $ME ] && mv $ME ${ME}_backup/

git clone https://github.com/MidHunterX/NvME $ME --depth 1 && nvim

----



.fish

[source,fish]

----

set ME ~/.config/nvim; test -d $ME; and mv $ME {$ME}_backup

git clone https://github.com/MidHunterX/NvME $ME --depth 1 && nvim

----



=== πŸͺŸ Windows



* Suggested Compiler: *Zig Compiler*



.powershell

[source,pwsh]

----

git clone https://github.com/MidHunterX/NvME $env:localappdata\nvim --depth 1; nvim

----



.cmd

[source,cmd]

----

git clone https://github.com/MidHunterX/NvME %localappdata%\nvim --depth 1 && nvim

----



== 🚢 Uninstall (go back to previous config if exists)



Uninstalls NvME and returns back to previous config if any.



.bash / zsh

[source,bash]

----

ME=~/.config/nvim; [ -d $ME ] && rm -rf $ME && mv ${ME}_backup/ $ME

----



.fish

[source,fish]

----

set ME ~/.config/nvim; test -d $ME && rm -rf $ME; and mv ${ME}_backup/ $ME

----



== 🌱 Development Environment Setup



=== AI Code Completion



* Authorize Windsurf (Codeium) using:



----

:Codeium Auth

----



* Insert completion using `` just like how it is done in fish shell



=== Python Django



* From `:Mason`, Install `pyright` Language Server



* Django uses some Python "magic" that makes having precise types for some code patterns problematic. To provide more precise static types and type inference for Django framework and be recognizable to pyright LSP, install:



----

pip install django-stubs

----



=== Flutter



----

sudo pacman -S jdk21-openjdk

sudo archlinux-java set java-21-openjdk

----



== πŸ˜‡ Behaviours



image:./img/nvim_record.jpg[]



Important Stuff on Top Left Side::

Macro Record Status posess high importance until recording is stopped.

Therefore it stays on left side only for the time being recorded for a macro.



Less Important Stuff on Top Right Side::

Buffer list is not needed at all times, therefore it doesn't have that much

importance to interfere with the code in buffer.



Yank into System Clipboard by Default::

Less hastle when copy pasting between windows frequently.



Highlight Yanked Text for 150ms::

Quickly know how much text got yanked when using direct yank commands.



Scroll past EOF in buffer with `j`::

Personal preference for EOF to not be stuck at the bottom of the screen.



Show Relative Line Number on Normal Mode::

That's the only time you need Relative Line Numbers for Jumping Lines.



Show Normal Line Number on Insert Mode::

Useful when doing substitution based on line numbers.



== πŸ›‚ Custom Features



image:./img/nvim_hitfont.jpg[]



* Convert text to Hit Font with `:HitFont`

* Toggle Boolean Values with `C-a`

* Trim trailing lines and Write Buffer with `w`

* Git add . + commit -m with `gc` (Replaced with Lazygit)

* Execute files with `F5` or `:lua Execute_order_69()`

* Run file formatter with `fm` or `:lua Run_formatter()`



== πŸ“ Autocompletion Behaviour



image:./img/nvim_cmp.jpg[]



* Autocompletion suggestions keep popping while typing

* If the suggestion box is visible, you can do the following:

* Select Next entries with: `C-n`, `Down`

* Select Previous entries with: `C-p`, `Up`

* Accept an entry with `CR`, `i`, `C-i`

* Cancel Completion with `C-e`, `o`, `C-o`



Note: `TAB` does multiple things here



* If accepted entry is a snippet and snippet is expanded, use `TAB` & `S-Tab` for jumping around the snippet fields.

* If autocompletion menu is visible, use `TAB` to select LSP pre-selected entry.

* If LSP pre-selected entry is not available in menu, `TAB` will select the first entry.

* If menu and snippet are both not visible, `TAB` will jump over quotes and brackets.

* If quotes and brackets are not available, `TAB` will act as normal `TAB`.



.`Show Completion Workflows`

[%collapsible]

====



[discrete]

=== Autocompletion: Terminal Style

[source,yaml]

----

Select: Tab, S-Tab

Accept: Enter

----



[discrete]

=== Autocompletion: Ide Style

[source,yaml]

----

Select: Down, Up

Accept: Enter

----



[discrete]

=== Autocompletion: Vim / Emacs Style

[source,yaml]

----

Select: C-n, C-p

Accept: Enter

Reject: C-e

----



[discrete]

=== Autocompletion: Personal Style

[source,yaml]

----

Select: Down, Up / Tab, S-Tab

Accept: i

Reject: o

----



====



== πŸ—ΊοΈ Custom Key Remaps



=== Normal Mode

[%header]

|===

| Key          | Description

| `u`          | Undo

| `U`          | Redo

| `H`          | Move cursor to start `^` of a line

| `L`          | Move cursor to end `$` of a line

| ``      | Scroll Half page up with Cursor centered

| ``      | Scroll Half page down with Cursor centered

| ``      | Go to Previous Buffer

| ``      | Go to Next Buffer

| ``    | Leader Key

| `rr` | Replace word under cursor with Regex

| `x`  | Delete Current Buffer

| `d`  | Deletes selection into blackhole register

| `p`  | Deletes selection into blackhole register and paste

| `ghh`        | Git Preview Hunk

| `ghn`        | Git Goto Next Hunk

| `ghp`        | Git Goto Previous Hunk

|===



=== Visual Mode

[%header]

|===

| Key       | Description

| `` | Leader

| `J`       | Move line Down with autoindent

| `K`       | Move line Up with autoindent

| `<`       | Indent line/selection to Left

| `>`       | Indent line/selection to Right

| `H`       | Move cursor to start `^` of a line

| `L`       | Move cursor to end `$` of a line

|===



=== Terminal Mode

[%header]

|===

| Key      | Description

| `n` | Return to Normal Mode

|===



== πŸ“• More Text Objects



=== Default Text Objects

[%header]

|===

| Default Text Objects    | Description

| `p`                     | Paragraph

| `w`                     | Word

| `"` `'` `'` `"`         | Strings

| `[` `{` `(` `)` `}` `]` | Brackets

| `t`                     | Markup Tags

|===



=== Added Text Objects

[%header]

|===

| New Text Objects | Description

| `i`              | Conditional

| `l`              | Loop

| `f`              | Function

| `m`              | Method

| `c`              | Class

| `a`              | Argument

| `=`              | Assignment

| `:`              | Propery

|===



== πŸ”Œ Plugins



image:./img/nvim_plugins.jpg[]



* Navigate through code Functions/Methods with `aerial.nvim`

* Lazy Loading Plugin Manager `lazy.nvim`

* Autoclosing Braces and Tags with `nvim-autopairs`

* Disable Features on Large Files with `bigfile.nvim`

* Default Colorscheme: `catppuccin`

* Fancy Dashboard with `dashboard-nvim`

* Gitsigns on Signcolumn with `gitsigns.nvim`

* Install LSP servers, DAP servers, Linters and Formatters with `mason.nvim`

* NeoVim LSP Configuration with `nvim-lspconfig`

* Code Autocompletion with `nvim-cmp`

* Code Snippets with `luasnip` + `friendly-snippets`

* Tab out of Brackets and Quotes with `neotab.nvim`

* Scope based Indentation Lines with `indent-blankline.nvim`

* Lazygit Integration with `lazygit.nvim`

* Fast Cursor Navigation with `leap.nvim`

* Bracket pair highlighting with `rainbow-delimiters.nvim`

* Status Line and Buffer Line with `lualine.nvim`

* Change, Delete surrounding brackets or quotes quickly with `nvim-surround`

* Fuzzy search project files, Grep text search etc. with `telescope.nvim`

* Navigate through undo history tree with `telescope-undo.nvim`

* ToDo, Bug, Hack comments highlighting with `todo-comments.nvim`

* Convert, Manipulate and Pick Colors with `ccc.nvim`

* Semantic based Syntax Highlighting with `nvim-treesitter`

* See code context on top with `nvim-treesitter-context` instead of breadcrumbs

* View live Treesitter parsing tree with `nvim-treesitter/playground`

* Added more text objects with `nvim-treesitter-textobjects`

* Manage and Explore files and folders with `vifm.vim`

* Visible Color Codes on buffer with `nvim-coloriser.lua`

* Distraction free Coding Zen Mode with `zen-mode.nvim` + `twilight.nvim`