AstroNvim is an aesthetic and feature-rich neovim config that is extensible and easy to use with a great set of plugins
- File explorer with Neo-tree
- Autocompletion with Cmp
- Git integration with Gitsigns
- Statusline with Heirline
- 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
- Nerd Fonts (Optional with manual intervention: See Documentation on customizing icons)
- Neovim 0.8 (Not including nightly)
- A clipboard tool is necessary for the integration with the system clipboard (see
:help clipboard-toolfor 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>tlor<leader>gg) - go DiskUsage() - disk usage toggle terminal (
<leader>tu) - bottom - process viewer toggle terminal (
<leader>tt) - Python - python repl toggle terminal (
<leader>tp) - Node - node repl toggle terminal (
<leader>tn)
- ripgrep - live grep telescope search (
Note when using default theme: For MacOS, the default terminal does not have true color support. You will need to use iTerm2 or another terminal emulator that has true color support.
mv ~/.config/nvim ~/.config/nvimbackup
git clone https://github.com/AstroNvim/AstroNvim ~/.config/nvim
nvim +PackerSync
Enter :LspInstall followed by the name of the server you want to install
Example: :LspInstall pyright
Enter :TSInstall followed by the name of the language you want to install
Example: :TSInstall python
Run :PackerClean to remove any disabled or unused plugins
Run :PackerSync to update and clean plugins
Run :AstroUpdate to get the latest updates from the repository
AstroNvim Documentation Core AstroNvim LUA API 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
Sincere appreciation to the following repositories, plugin authors and the entire neovim community out there that made the development of AstroNvim possible.
