# AstroNvim — Aesthetic and Feature-Rich Neovim Configuration

> An extensible Neovim configuration that balances aesthetics and functionality with a community-driven plugin ecosystem and a structured user config template.

## Install

Save in your project root:

# AstroNvim — Aesthetic and Feature-Rich Neovim Configuration

## Quick Use
```bash
git clone --depth 1 https://github.com/AstroNvim/template ~/.config/nvim
rm -rf ~/.config/nvim/.git
nvim
```

## Introduction
AstroNvim is a Neovim configuration that focuses on providing a visually polished and fully-featured IDE experience out of the box. It uses a template-based approach for user customization and an astrocommunity repository where the community contributes language packs and tool integrations.

## What AstroNvim Does
- Delivers a complete Neovim IDE with LSP, completion, debugging, and Git integration
- Provides the astrocommunity repository with 200+ community plugin packs
- Ships a polished UI with Heirline statusline, Neo-tree, and which-key
- Uses a template config that separates user overrides from core framework code
- Integrates Mason for automatic LSP server and tool installation

## Architecture Overview
AstroNvim is structured as a lazy.nvim plugin that defines a base configuration. The user clones a template repository containing a lua/plugins/ directory where specs override or extend the defaults. The astrocommunity repository provides drop-in plugin packs (e.g., lang/python, lang/rust) that users import as single-line specs. AstroNvim's core handles plugin loading order, UI setup, and default keybinding registration.

## Self-Hosting & Configuration
- Clone the AstroNvim template into your Neovim config directory
- First launch installs all plugins via lazy.nvim automatically
- Import community packs by adding them to lua/community.lua
- Override any default plugin by creating a matching spec in lua/plugins/
- Requires Neovim 0.9+, Git, a Nerd Font, and optionally ripgrep and lazygit

## Key Features
- astrocommunity ecosystem with language packs, themes, and tool integrations
- Heirline-based statusline and winbar with contextual breadcrumbs
- Built-in debugging via nvim-dap with community adapter configurations
- Automatic updater checks for new AstroNvim releases
- Polished defaults for indent guides, notifications, and buffer management

## Comparison with Similar Tools
- **LazyVim** — extras built into the core; AstroNvim uses a separate community repository
- **NvChad** — custom UI plugin and compiled themes; AstroNvim uses Heirline and standard colorschemes
- **kickstart.nvim** — minimal educational starter; AstroNvim is a full managed distribution
- **LunarVim** — standalone binary approach; AstroNvim integrates as a standard Neovim config
- **Doom Emacs** — Emacs module system; AstroNvim is the Neovim equivalent with Lua-based configuration

## FAQ
**Q: How do I add Python support?**
A: Import the astrocommunity lang/python pack in your community.lua file.

**Q: Can I use AstroNvim without Nerd Fonts?**
A: It works without them, but many UI elements rely on icon glyphs that require a patched font.

**Q: How do I update AstroNvim?**
A: Run :AstroUpdate to pull the latest framework version and sync plugins.

**Q: What is astrocommunity?**
A: A community-maintained repository of plugin packs that add language support, tools, and themes to AstroNvim via single-line imports.

## Sources
- https://github.com/AstroNvim/AstroNvim
- https://docs.astronvim.com/

---
Source: https://tokrepo.com/en/workflows/asset-335e2620
Author: AI Open Source