{"id":15206798,"url":"https://github.com/astronvim/astronvim","last_synced_at":"2025-12-29T17:31:58.682Z","repository":{"id":37004321,"uuid":"454957552","full_name":"AstroNvim/AstroNvim","owner":"AstroNvim","description":"AstroNvim is an aesthetic and feature-rich neovim config that is extensible and easy to use with a great set of plugins ","archived":false,"fork":false,"pushed_at":"2025-04-18T15:04:56.000Z","size":3650,"stargazers_count":13267,"open_issues_count":3,"forks_count":945,"subscribers_count":60,"default_branch":"main","last_synced_at":"2025-04-21T06:55:49.942Z","etag":null,"topics":["astronvim","astrovim","hacktoberfest","ide","lua","neovim","neovim-config","neovim-configuration","neovim-dotfiles","neovim-lua","neovim-lua-plugin","neovim-plugin","neovim-plugins","neovim-setup","nvim","vim"],"latest_commit_sha":null,"homepage":"https://AstroNvim.com","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AstroNvim.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"AstroNvim","ko_fi":"mehalter","liberapay":"mehalter","custom":"https://www.buymeacoffee.com/mehalter"}},"created_at":"2022-02-02T22:33:34.000Z","updated_at":"2025-04-21T04:30:46.000Z","dependencies_parsed_at":"2023-10-02T22:19:34.622Z","dependency_job_id":"12900f0d-6ace-4300-ba04-c7af85b0cd0c","html_url":"https://github.com/AstroNvim/AstroNvim","commit_stats":{"total_commits":2123,"total_committers":95,"mean_commits":"22.347368421052632","dds":"0.47574187470560525","last_synced_commit":"86f153cc426a32f86f8102368b96107c39e69e0c"},"previous_names":[],"tags_count":373,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstroNvim%2FAstroNvim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstroNvim%2FAstroNvim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstroNvim%2FAstroNvim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstroNvim%2FAstroNvim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AstroNvim","download_url":"https://codeload.github.com/AstroNvim/AstroNvim/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250278337,"owners_count":21404182,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astronvim","astrovim","hacktoberfest","ide","lua","neovim","neovim-config","neovim-configuration","neovim-dotfiles","neovim-lua","neovim-lua-plugin","neovim-plugin","neovim-plugins","neovim-setup","nvim","vim"],"created_at":"2024-09-28T06:03:02.237Z","updated_at":"2025-12-29T17:31:58.676Z","avatar_url":"https://github.com/AstroNvim.png","language":"Lua","readme":"\u003cdiv align=\"center\" id=\"madewithlua\"\u003e\n  \u003cimg\n    src=\"https://astronvim.com/logo/astronvim.svg\"\n    width=\"110\"\n    ,\n    height=\"100\"\n  /\u003e\n\u003c/div\u003e\n\u003ch1 align=\"center\"\u003eAstroNvim\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003e\n  \u003ca href=\"https://docs.astronvim.com/#-installation\"\u003eInstall\u003c/a\u003e\n  ·\n  \u003ca href=\"https://docs.astronvim.com/#-configuration\"\u003eConfigure\u003c/a\u003e\n  ·\n  \u003ca href=\"https://github.com/AstroNvim/astrocommunity\"\u003eCommunity Plugins\u003c/a\u003e\n  ·\n  \u003ca href=\"https://astronvim.com\"\u003eWebsite\u003c/a\u003e\n  ·\n  \u003ca href=\"https://discord.astronvim.com\"\u003eDiscord\u003c/a\u003e\n\u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/AstroNvim/AstroNvim/pulse\"\u003e\u003cimg src=\"https://img.shields.io/github/last-commit/AstroNvim/AstroNvim?style=for-the-badge\u0026logo=github\u0026color=7dc4e4\u0026logoColor=D9E0EE\u0026labelColor=302D41\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/AstroNvim/AstroNvim/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/AstroNvim/AstroNvim?style=for-the-badge\u0026logo=gitbook\u0026color=8bd5ca\u0026logoColor=D9E0EE\u0026labelColor=302D41\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/AstroNvim/AstroNvim/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/AstroNvim/AstroNvim?style=for-the-badge\u0026logo=apachespark\u0026color=eed49f\u0026logoColor=D9E0EE\u0026labelColor=302D41\"\u003e\u003c/a\u003e\n     \u003cimg src=\"https://img.shields.io/endpoint?url=https://waka.mehalter.com/api/compat/shields/v1/mehalter/interval:any/label:AstroNvim\u0026style=for-the-badge\u0026label=wakatime\u0026logo=wakatime\u0026color=a6da95\u0026logoColor=D9E0EE\u0026labelColor=302D41\"\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://www.twitter.com/AstroNvim\"\u003e\u003cimg src=\"https://img.shields.io/badge/@AstroNvim-e05d44?style=for-the-badge\u0026logo=twitter\u0026color=fab387\u0026logoColor=D9E0EE\u0026labelColor=302D41\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://hachyderm.io/@AstroNvim\"\u003e\u003cimg src=\"https://img.shields.io/badge/@AstroNvim-e05d44?domain=https%3A%2F%2Fhachyderm.io\u0026style=for-the-badge\u0026logo=mastodon\u0026color=eebebe\u0026logoColor=D9E0EE\u0026labelColor=302D41\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://www.reddit.com/r/AstroNvim/\"\u003e\u003cimg src=\"https://img.shields.io/badge/%2Fr%2FAstroNvim-e05d44?style=for-the-badge\u0026logo=reddit\u0026color=ee99a0\u0026logoColor=D9E0EE\u0026labelColor=302D41\"\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    \u003ca href=https://discord.astronvim.com\u003e\u003cimg src=\"https://img.shields.io/discord/939594913560031363?style=for-the-badge\u0026logo=discord\u0026color=cba6f7\u0026logoColor=D9E0EE\u0026labelColor=302D41\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\nAstroNvim is an aesthetically pleasing and feature-rich neovim config that is extensible and easy to use with a great set of plugins\n\u003c/p\u003e\n\n## 🌟 Preview\n\n![Preview Image](https://astronvim.com/themes/overview.png)\n\n## ✨ Features\n\n- Common plugin specifications with [AstroCommunity](https://github.com/AstroNvim/astrocommunity)\n- File explorer with [Neo-tree](https://github.com/nvim-neo-tree/neo-tree.nvim)\n- Autocompletion with [Blink.cmp](https://github.com/Saghen/blink.cmp)\n- Git integration with [Gitsigns](https://github.com/lewis6991/gitsigns.nvim)\n- Statusline, Winbar, and Bufferline, Statuscolumn with [Heirline](https://github.com/rebelot/heirline.nvim)\n- Terminal with [Toggleterm](https://github.com/akinsho/toggleterm.nvim)\n- Fuzzy finding with [Snacks Picker](https://github.com/folke/snacks.nvim/blob/main/docs/picker.md)\n- Syntax highlighting with [Treesitter](https://github.com/nvim-treesitter/nvim-treesitter)\n- Formatting and Linting with [None-ls](https://github.com/nvimtools/none-ls.nvim)\n- Language Server Protocol with [Native LSP](https://github.com/neovim/nvim-lspconfig)\n- Debug Adapter Protocol with [nvim-dap](https://github.com/mfussenegger/nvim-dap)\n\n## ⚡ Requirements\n\n- [Nerd Fonts](https://www.nerdfonts.com/font-downloads) (_Optional with manual intervention:_ See [Documentation on customizing icons](https://docs.astronvim.com/Recipes/icons)) \u003csup\u003e[[1]](#1)\u003c/sup\u003e\n- [Neovim 0.10+ (_Not_ including nightly)](https://github.com/neovim/neovim/releases/tag/stable)\n- [Tree-sitter CLI](https://github.com/tree-sitter/tree-sitter/blob/master/cli/README.md) (_Note:_ This is only necessary if you want to use `auto_install` feature with Treesitter)\n- A clipboard tool is necessary for the integration with the system clipboard (see [`:help clipboard-tool`](https://neovim.io/doc/user/provider.html#clipboard-tool) for supported solutions)\n- Terminal with true color support (for the default theme, otherwise it is dependent on the theme you are using) \u003csup\u003e[[2]](#2)\u003c/sup\u003e\n- Optional Requirements:\n  - [ripgrep](https://github.com/BurntSushi/ripgrep) - live grep picker search (`\u003cleader\u003efw`)\n  - [lazygit](https://github.com/jesseduffield/lazygit) - git ui toggle terminal (`\u003cleader\u003etl` or `\u003cleader\u003egg`)\n  - [go DiskUsage()](https://github.com/dundee/gdu) - disk usage toggle terminal (`\u003cleader\u003etu`)\n  - [bottom](https://github.com/ClementTsang/bottom) - process viewer toggle terminal (`\u003cleader\u003ett`)\n  - [Python](https://www.python.org/) - python repl toggle terminal (`\u003cleader\u003etp`)\n  - [Node](https://nodejs.org/en/) - node repl toggle terminal (`\u003cleader\u003etn`)\n\n\u003e [!NOTE] \u003e \u003csup id=\"1\"\u003e[1]\u003c/sup\u003e 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.\n\n\u003e [!NOTE] \u003e \u003csup id=\"2\"\u003e[2]\u003c/sup\u003e Note when using default theme: For MacOS, the default terminal does not have true color support. You will need to use [iTerm2](https://iterm2.com/), [Kitty](https://sw.kovidgoyal.net/kitty/), [WezTerm](https://wezterm.org), or another [terminal emulator](https://github.com/termstandard/colors?tab=readme-ov-file#truecolor-support-in-output-devices) that has true color support.\n\n## 🛠️ Installation\n\nAstroNvim is provided as a plugin that can be installed with the [`lazy.nvim`](https://github.com/folke/lazy.nvim) plugin manager and then used to import all of the plugin configurations that AstroNvim provides. To quickly get started it is recommended to start with the official [AstroNvim Template](https://github.com/AstroNvim/template) which provides a great starting point for a new AstroNvim based configuration.\n\n### Linux/Mac OS (Unix)\n\n#### Make a backup of your current nvim and shared folder\n\n```shell\nmv ~/.config/nvim ~/.config/nvim.bak\nmv ~/.local/share/nvim ~/.local/share/nvim.bak\nmv ~/.local/state/nvim ~/.local/state/nvim.bak\nmv ~/.cache/nvim ~/.cache/nvim.bak\n```\n\n#### Clone the template repository\n\n```shell\ngit clone --depth 1 https://github.com/AstroNvim/template ~/.config/nvim\nrm -rf ~/.config/nvim/.git\nnvim\n```\n\n### Windows (Powershell)\n\n#### Make a backup of your current nvim and nvim-data folder\n\n```pwsh\nRename-Item -Path $env:LOCALAPPDATA\\nvim -NewName $env:LOCALAPPDATA\\nvim.bak\nRename-Item -Path $env:LOCALAPPDATA\\nvim-data -NewName $env:LOCALAPPDATA\\nvim-data.bak\n```\n\n#### Clone the repository\n\n```pwsh\ngit clone --depth 1 https://github.com/AstroNvim/template $env:LOCALAPPDATA\\nvim\nRemove-Item $env:LOCALAPPDATA\\nvim\\.git -Recurse -Force\nnvim\n```\n\n#### Minimal `~/.config/nvim/init.lua`\n\nSome user's might not want to use an entire template or do any customization. Here is a minimal `~/.config/nvim/init.lua` file that simply set's up a base AstroNvim installation:\n\n```lua\nlocal lazypath = vim.fn.stdpath \"data\" .. \"/lazy/lazy.nvim\"\nif not vim.uv.fs_stat(lazypath) then\n  -- stylua: ignore\n  vim.fn.system({ \"git\", \"clone\", \"--filter=blob:none\", \"https://github.com/folke/lazy.nvim.git\", \"--branch=stable\", lazypath })\nend\nvim.opt.rtp:prepend(lazypath)\n\nrequire(\"lazy\").setup { \"AstroNvim/AstroNvim\", version = \"^5\", import = \"astronvim.plugins\" }\n```\n\n## 📦 Basic Setup\n\n#### Install LSP\n\nEnter `:LspInstall` followed by the name of the server you want to install\u003cbr\u003e\nExample: `:LspInstall pyright`\n\n#### Install language parser\n\nEnter `:TSInstall` followed by the name of the language you want to install\u003cbr\u003e\nExample: `:TSInstall python`\n\n#### Install Debugger\n\nEnter `:DapInstall` followed by the name of the debugger you want to install\u003cbr\u003e\nExample: `:DapInstall python`\n\n#### Manage plugins\n\nRun `:Lazy check` to check for plugin updates\n\nRun `:Lazy update` to apply any pending plugin updates\n\nRun `:Lazy clean` to remove any disabled or unused plugins\n\nRun `:Lazy sync` to update and clean plugins\n\n#### Update AstroNvim Packages\n\nRun `:AstroUpdate` (`\u003cleader\u003epa`) to update both Neovim plugins and Mason packages\n\n## 🗒️ Links\n\n- [AstroNvim Website](https://astronvim.com)\n- [AstroNvim Documentation](https://docs.astronvim.com)\n- [Setup](https://docs.astronvim.com/#-setup) is given for basic editor setup after installation\n- [Default Mappings](https://docs.astronvim.com/mappings) more about the default key bindings\n- [Customizing Plugins](https://docs.astronvim.com/configuration/customizing_plugins/) more about configuring and adding plugins\n\n### 📹 Videos\n\nThere have been some great review videos released by members of the community! Here are a few:\n\n- [Neovim With AstroNvim | Your New Advanced Development Editor](https://www.youtube.com/watch?v=GEHPiZ10gOk) (Version: 3, Content By: [@Cretezy](https://github.com/Cretezy))\n- [Why I'm quitting VIM by Carlos Mafla](https://www.youtube.com/watch?v=71GDopdc9rw) (Version: 2, Content By: [@gigo6000](https://github.com/gigo6000))\n- [Astro Vim - All in one Nvim config!! by John McBride](https://www.youtube.com/watch?v=JQLZ7NJRTEo) (Version: 1, Content By: [@jpmcb](https://github.com/jpmcb))\n\n## 🚀 Contributing\n\nIf you plan to contribute, please check the [contribution guidelines](https://github.com/AstroNvim/.github/blob/main/CONTRIBUTING.md) first.\n\n## ⭐ Credits\n\nSincere appreciation to the following repositories, plugin authors and the entire neovim community out there that made the development of AstroNvim possible.\n\n- [Plugins](https://docs.astronvim.com/reference/default_plugins/)\n- [NvChad](https://github.com/NvChad/NvChad)\n- [LunarVim](https://github.com/LunarVim)\n- [CosmicVim](https://github.com/CosmicNvim/CosmicNvim)\n\n\u003cdiv align=\"center\" id=\"madewithlua\"\u003e\n\n[![Lua](https://img.shields.io/badge/Made%20with%20Lua-blue.svg?style=for-the-badge\u0026logo=lua)](https://lua.org)\n\n\u003c/div\u003e\n","funding_links":["https://github.com/sponsors/AstroNvim","https://ko-fi.com/mehalter","https://liberapay.com/mehalter","https://www.buymeacoffee.com/mehalter"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastronvim%2Fastronvim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fastronvim%2Fastronvim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastronvim%2Fastronvim/lists"}