Awesome Open Source
Awesome Open Source





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


Dashboard Preview Image Coding Preview Image Debugging Preview Image



  • Nerd Fonts (Optional with manual intervention: See Documentation on customizing icons)
  • 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)
  • 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)

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.


Make a backup of your current nvim and shared folder

mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/share/nvim.bak

Clone the repository

git clone ~/.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

Install Debugger

Enter :DapInstall followed by the name of the debugger you want to install
Example: :DapInstall 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


AstroNvim Documentation Core AstroNvim LUA API Documentation


There have been some great review videos released by members of the community! Here are a few:


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


Related Awesome Lists
Top Programming Languages

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Lua (38,387
Vim (18,814
Ide (9,228
Neovim (4,781
Nvim (1,800
Neovim Configuration (166
Neovim Lua (143
Neovim Config (131
Neovim Setup (19
Astrovim (4
Astronvim (3