This is my personal Neovim configuration, based on the excellent kickstart.nvim. It's designed to be a lightweight, well-documented, and powerful starting point for anyone looking to get started with Neovim.
This configuration includes a curated set of plugins and settings to provide a modern and efficient development environment. Here are some of the key features:
Plugin Management with lazy.nvim: All plugins are managed using the fast and easy-to-use lazy.nvim plugin manager. You can easily add, remove, or update plugins by modifying the init.lua file.
Fuzzy Finding with Telescope: Quickly find files, buffers, and more with the powerful fuzzy finder, Telescope.
LSP and Autocompletion: Full support for the Language Server Protocol (LSP) for features like go-to-definition, find-references, and diagnostics. Autocompletion is provided by nvim-cmp, which integrates with various sources like LSP, snippets, and more.
Syntax Highlighting with Tree-sitter: Enjoy fast and accurate syntax highlighting with nvim-treesitter.
Git Integration: Seamless integration with Git, allowing you to see diffs, blame, and more directly in the editor.
Customizable and Extendable: This configuration is designed to be easily customized. You can add your own plugins, keymaps, and settings to tailor it to your workflow.
-
Install Neovim First, you'll need to install Neovim. This configuration targets the latest stable and nightly versions of Neovim. You can find the installation instructions for your operating system on the Neovim website.
-
Install Dependencies
Next, you'll need to install some external dependencies:
Basic Utilities: git, make, unzip, and a C compiler (gcc).
File Searching: ripgrep and fd.
Clipboard: xclip or xsel on Linux, or win32yank on Windows.
Nerd Font (Optional): For icons and a better visual experience, it's recommended to install a Nerd Font.
-
Clone the Configuration
Now, you can clone this configuration to your Neovim configuration directory.
Linux and macOS:
git clone https://github.com/Mohamed-El-Mouhib/mynvim.config.git "${XDG_CONFIG_HOME:-$HOME/.config}"/nvimOn the first launch, lazy.nvim will automatically install all the plugins.
nvim
To get a better understanding of how this configuration works and how to customize it, I highly recommend watching this video:
The Only Video You Need to Get Started with Neovim: This video by TJ DeVries, a core Neovim maintainer, provides a comprehensive overview of the kickstart philosophy, core Neovim concepts, and how to configure plugins. [00:35]
How do I add a new plugin?
You can add a new plugin by adding a new entry to the plugins table in your init.lua file. For example, to add a new plugin from GitHub, you would add a line like this:
{ 'owner/repo.nvim' }
How do I customize a plugin's configuration?
You can customize a plugin's configuration by adding an opts table to its entry in the plugins table. For example:
{
'owner/repo.nvim',
opts = {
-- your configuration options here
}
}
Where can I find more information about a specific plugin?
You can find more information about a specific plugin by visiting its GitHub repository. You can also use the :Lazy command to view the installed plugins and their documentation.