Awesome

My Neovim Setup

My personal Neovim setup written in Lua.

Table of Contents

• Features
• Philosophy
• Requirements
• Installation
• Keymaps
  • General
  • Explorer
    • Folders Explorer
    • Git Explorer
  • Windows
  • Buffers
  • Tabs
  • Snippets
  • Selection
  • Commenting
  • Moving text
  • Git
  • Language servers
  • Debugging
• Recommendations
  • Fonts
• Maintainer
• License

Features

The main features and plugins provided by this setup are as follows:

• 🧠 Smooth times based on scientific research.
• 🫴 Lazy loading of plugins with lazy.nvim.
• ⚡ Modern Vim's native options by human.vim.
• 📂 Robust folders explorer with neo-tree.nvim.
• 🔭 Powerful fuzzy finder with nvim-telescope.
• 🌳 Advanced syntax recognition with nvim-treesitter.
• 💡 Neovim native language server protocol.
• 🔗 Multiple cursors with vim-visual-multi.
• 📜 Friendly snippets with LuaSnip.
• 🤖 Autocomplete with nvim-cmp powered by Tabnine Machine Learning.
• 👷 Git status of files with gitsigns.nvim.
• 🐛 Code debugging with nvim-dap.
• 👀 Markdown previewer with markdown-preview.nvim.
• 🐱 Useful and smart status bar with feline.nvim.
• 👁 Harmonic and consistent theme by Enfocado.
• 💅 Modern and nice user interface with bufferline.nvim, edgy.nvim, noice.nvim, nvim-notify, and dressing.nvim.
• 🟩 Tmux integration with smart-splits.nvim.
• 💫 Smooth UI animations with mini.animate.
• 😎 Last but not least, announce your presence on Discord with funny messages (in Spanish) by presence.nvim.

Philosophy

My Neovim setup, unlike many others, has and follows a well-defined philosophy, governed by coherence and minimalism. You won't find any unnecessary plugins or redundant plugins here, and every little aspect is tweaked to keep everything consistent as a whole; for example, all the icons used are the standard ones and all floating windows have a rounded edge. As it should be...

DISCLAIMER: due to this you will see that I make many commits perfecting aspects that seem insignificant, I apologize for my sick perfectionism.

Requirements

• Nerd Fonts patched with codicons.ttf - to show nice icons.
• Neovim Nightly - obviously.
• Git - to install nvim plugins with lazy.nvim.
• Node and NPM - to install language servers and debug adapters with mason.nvim.
• ripgrep (rg) - to search patterns with nvim-telescope.
• fd - to find files with nvim-telescope.
• cargo - to replace the enemy with nvim-spectre (optional).
• sqlite - to storage yank history with yanky.nvim (optional).

Installation

First, if you have a previous Neovim config, make sure to make a backup before installing this setup in case something goes wrong in the process. This is done by backing up the ~/.config/nvim/ folder and its contents.

To install this configuration, you just need to clone this repository to the Neovim user config runtime directory for your operating system, which you can find here, or by running the :help config help command within Neovim. For a clean install, make sure you have all Neovim runtime folders ~/.local/share/nvim (Linux/MacOS) and $LOCALAPPDATA/nvim-data (Windows) clean.

For example, to install on Linux/MacOS:

git clone https://github.com/wuelnerdotexe/nvim ~/.config/nvim --depth 1

Keymaps

The keymaps created by this config are very well thought out to be intuitive, meaningful, and most of all, to stick to the essence of Vim without conflicting with it. Keymaps are normally assigned two letters, which signify an action, for example: d + p = diagnostic preview. Keep in mind that the functionality will always come first and then the action. This is the standard created and used by this configuration for unique consistency.

IMPORTANT: the \ (backslash) remains as the <leader> key, and the | (pipe) remains as the <localleader> key.

General

Explorer

Folders Explorer

Git Explorer

Windows

Buffers

Tabs

Snippets

Selection

Commenting

Moving text

Git

Language servers

Debugging

NOTE: only custom keymaps unique to this configuration are documented here. There are many more keymaps available by default in each installed plugin, in addition to the hundreds that come with Vim by default.

Recommendations

Fonts

In order for the Enfocado's Human Writing feature work as it should, I recommend that you use either of these three beautiful fonts, which align with the "Mankind and Machine" concept.

• IBM Plex Mono.
• Victor Mono.

Maintainer

Hi 👋, I'm Wuelner, a software developer from Guatemala, passionate about creating minimalist solutions using solid fundamentals focused on "how things should be".

License

GPL-3.0 © Wuelner Martínez.