🦙 My Personal Neovim Setup - From Scratch

My Neovim Distribution #

📦 Overview #

This project is my Neovim setup from scratch, named marco-souza/nvim. It provides:

• Basic editor configurations
• A beautiful colorscheme
• A comprehensive plugin setup
• Tree-sitter integration for enhanced syntax highlighting
• Out-of-the-box support for popular programming languages

This setup is designed for developers who want a lightweight yet powerful Neovim configuration.

📖 Inspiration #

This setup is based on:

• Understanding Neovim
• Neovim IDE from Scratch

🚀 Installation Instructions #

Requires Neovim 0.11+. Always review the code before installing a configuration.

Clone the repository and install the plugins:

git clone git@github.com:marco-souza/nvim ~/.config/nvim
nvim --headless +"Lazy! sync" +qa

Open Neovim with this config:

nvim

Backup Existing Configuration #

mv $HOME/.config/nvim $HOME/.config/nvim.bkp

🛠️ Features and Plugins #

🎨 Colorscheme #

• rose-pine/neovim: A soothing colorscheme.

📝 Commenting #

• folke/todo-comments.nvim: Highlight and manage TODO comments.
• numToStr/Comment.nvim: Simplify code commenting.

🧩 Completion #

• saghen/blink.cmp: A lightweight completion plugin.

🛠️ Editing Support #

• windwp/nvim-ts-autotag: Autocomplete HTML tags.
• windwp/nvim-autopairs: Automatically close brackets and quotes.

📂 File Explorer #

• stevearc/oil.nvim: Manage files like a pro.

🔍 Fuzzy Finder #

• ibhagwan/fzf-lua: A blazing fast fuzzy finder.
• nvim-telescope/telescope.nvim: Powerful file and content searching.

🧑‍💻 Git Integration #

• sindrets/diffview.nvim: Visualize git diffs.
• NeogitOrg/neogit: A Magit-inspired git plugin.

📏 Indentation #

• lukas-reineke/indent-blankline.nvim: Display indentation guides.

🔑 Keybinding #

• folke/which-key.nvim: Display available keybindings.

🤖 Language Servers #

• neovim/nvim-lspconfig: Configure LSP servers easily.
• williamboman/mason.nvim: Manage LSP servers, formatters, and linters.

📍 Marks #

• ThePrimeagen/harpoon: Navigate and manage marks easily.

🔧 Plugin Development #

• nvim-lua/plenary.nvim: Utility functions for Neovim plugins.
• MunifTanjim/nui.nvim: UI components for plugins.

📜 Snippets #

• rafamadriz/friendly-snippets: Predefined snippets for various languages.

🌟 Startup #

• goolord/alpha-nvim: A customizable startup screen.

📊 Statusline #

• nvim-lualine/lualine.nvim: A fast and customizable statusline.

🖋️ Syntax #

• kylechui/nvim-surround: Manage surrounding characters.
• nvim-treesitter/nvim-treesitter: Syntax highlighting and parsing.
• nvim-treesitter/nvim-treesitter-textobjects: Enhanced text object support.

📚 Language Servers #

This setup supports multiple language servers managed via mason.nvim. Additional servers can be installed as needed.

🛠️ Dependencies #

• git: Required to clone the repository.
• lazy.nvim: Installed automatically.
• node: Ensure Node.js is installed for certain language servers.
• ripgrep: Required for most fuzzy finders.

🌟 Usage #

# Backup old config
mv $HOME/.config/nvim $HOME/.config/nvim.bkp

# Clone the config
git clone git@github.com:marco-souza/nvim.git $HOME/.config/nvim
# Or use HTTPS
git clone https://github.com/marco-souza/nvim.git $HOME/.config/nvim

Run this setup in your terminal and experience Neovim like never before. 🎉