Install · Configure · Community Plugins · Docs · Discord
AstroNvim is an aesthetic and feature-rich neovim config that is extensible and easy to use with a great set of plugins
- Common plugin specifications with AstroCommunity
- File explorer with Neo-tree
- Autocompletion with Cmp
- Git integration with Gitsigns
- Statusline, Winbar, and Bufferline 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
- Debug Adapter Protocol with nvim-dap
- Nerd Fonts (Optional with manual intervention: See Documentation on customizing icons) [1]
- Neovim 0.8+ (Not including nightly)
- Tree-sitter CLI (Note: This is only necessary if you want to use
auto_install
feature with Treesitter) - 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) [2]
- Optional Requirements:
- ripgrep - live grep telescope search (
<leader>fw
) - lazygit - git ui toggle terminal (
<leader>tl
or<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 (
[1] All downloadable Nerd Fonts contain icons which are used by AstroNvim. Install the Nerd Font of your choice to your system and in your terminal emulator settings, set its font face to that Nerd Font. If you are using AstroNvim on a remote system via SSH, you do not need to install the font on the remote system.
[2] Note when using default theme: For MacOS, the default terminal does not have true color support. You will need to use iTerm2, Kitty, WezTerm, or another terminal emulator that has true color support.
mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/share/nvim.bak
git clone --depth 1 https://github.com/AstroNvim/AstroNvim ~/.config/nvim
nvim
Rename-Item -Path $env:LOCALAPPDATA\nvim -NewName $env:LOCALAPPDATA\nvim.bak
Rename-Item -Path $env:LOCALAPPDATA\nvim-data -NewName $env:LOCALAPPDATA\nvim-data.bak
git clone --depth 1 https://github.com/AstroNvim/AstroNvim $env:LOCALAPPDATA\nvim
nvim
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
Enter :DapInstall
followed by the name of the debugger you want to install
Example: :DapInstall python
Run :Lazy check
to check for plugin updates
Run :Lazy update
to apply any pending plugin updates
Run :Lazy clean
to remove any disabled or unused plugins
Run :Lazy sync
to update and clean plugins
Run :AstroUpdate
to get the latest updates from the repository
Run :AstroUpdatePackages
(<leader>pa
) to update both Neovim plugins and Mason packages
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
There have been some great review videos released by members of the community! Here are a few:
- Neovim With AstroNvim | Your New Advanced Development Editor (Version: 3, Content By: @Cretezy)
- Why I'm quitting VIM by Carlos Mafla (Version: 2, Content By: @gigo6000)
- Astro Vim - All in one Nvim config!! by John McBride (Version: 1, Content By: @jpmcb)
If you plan to contribute, please check the contribution guidelines first.
Sincere appreciation to the following repositories, plugin authors and the entire neovim community out there that made the development of AstroNvim possible.