My NeoVim Config

Credit

Forked off AstroNvim + Et. Al to random people on stack overflow with the same problems as me.

Some Notes about stuff not working

Some of the stuff I have in my neovim config may not actually work just by installing this branch. This is probably because it's something I've got configured in my ~/.vim folder. Notable mention here is snippets. I'm sure at some point I'll get around to fixing that but for now, if it doesn't work, feel free to comment stuff out that's breaking anything since it's probably not that important anyways.

AstroNvim

AstroNvim is an aesthetic and feature-rich neovim config that is extensible and easy to use with a great set of plugins

Notice: AstroNvim v1.4.0 has added stable and nightly update channels. For the time being we have kept the default update channel to nightly so that the behavior of AstroNvim doesn't change (this could be considered a breaking change to some). We are planning to make the stable channel the default update channel when Neovim v0.8 is released and we tag AstroNvim v2.0.0 to incorporate this "breaking" change.

🌟 Preview

✨ Features

File explorer with Neo-tree
Autocompletion with Cmp
Git integration with Gitsigns
Statusline with Feline
Terminal with Toggleterm
Fuzzy finding with Telescope
Syntax highlighting with Treesitter
Formatting and linting with Null-ls
Language Server Protocol with Native LSP
Buffer Line with bufferline.nvim

⚡ Requirements

Nerd Fonts
Neovim 0.7+
A clipboard tool is necessary for the integration with the system clipboard (see :help clipboard-tool for supported solutions)
Terminal with true color support (for the default theme, otherwise it is dependent on the theme you are using)
Optional Requirements:
- ripgrep - live grep telescope search (<leader>fw)
- lazygit - git ui toggle terminal (<leader>tl or <leader>gg)
- NCDU - disk usage toggle terminal (<leader>tu)
- Htop - process viewer toggle terminal (<leader>tt)
- Python - python repl toggle terminal (<leader>tp)
- Node - node repl toggle terminal (<leader>tn)

Note when using default theme: For MacOS, the default terminal does not have true color support. You wil need to use iTerm2 or another terminal emulator that has true color support.

Note if you are still on Neovim v0.6: You can still install the previous version of AstroNvim that supported. After cloning the repository run git checkout nvim-0.6 to check out this version. This will no longer be receiving updates.

🛠️ Installation

Make a backup of your current nvim folder

mv ~/.config/nvim ~/.config/nvimbackup

Clone the repository (with https)

git clone https://github.com/imagine-hussain/nvim-conf ~/.config/nvim
nvim +PackerSync

Clone the repo (for the ssh enjoyers)

git clone git@github.com:imagine-hussain/nvim-conf.git ~/.config.nvim
nvim +PackerSync

📦 Basic Setup

Install LSP

Enter :LspInstall followed by the name of the server you want to install
Example: :LspInstall pyright

Install language parser

Enter :TSInstall followed by the name of the language you want to install
Example: :TSInstall python

Manage plugins

Run :PackerClean to remove any disabled or unused plugins
Run :PackerSync to update and clean plugins

Update AstroNvim

Run :AstroUpdate to get the latest updates from the repository

🗒️ Links

AstroNvim Documentation

Basic Usage is given for basic usage
Default Mappings more about the default key bindings
Default Plugin Configuration more about the provided plugin defaults
Advanced Configuration more about advanced configuration

Watch a review video to know about the out of the box experience

⭐ Credits

Sincere appreciation to the following repositories, plugin authors and the entire neovim community out there that made the development of AstroNvim possible.

Wal-eed / nvim-config