1. Overview

Based on Astrovim link to github

Image Preview

This repository serves as a personalized configuration for Neovim, built atop AstroNvim. It includes:

• init.lua — main configuration entry.
• lua/ directory — modular plugin and configuration files.
• lazy-lock.json — plugin lockfile (for lazy.nvim).
• Configuration standards via .neoconf.json, .stylua.toml, and selene.toml.

---

2. Prerequisites

Before diving in, ensure your environment satisfies the following:

• Neovim v0.9+, ideally v0.10+, to enable full compatibility with AstroNvim features like Lua configuration and built-in LSP.
• Git for cloning and version control.

You may also consider installing:

• Node.js, npm, Python (pip), Rust, or Go, depending on plugins your configuration uses (e.g., LSP servers, formatters, fuzzy-finders).

---

3. Installation

3.1 Backup Existing Configuration

mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/shared/nvim.bak
mv ~/.local/state/nvim ~/.local/state/nvim.bak
mv ~/.cache/nvim ~/.cache/nvim.bak

3.2 Clone Your Config

git clone https://github.com/aashish-thapa/nvim.git ~/.config/nvim

3.3 Launch Neovim

nvim

On first launch, AstroNvim’s package manager (lazy.nvim) will install and configure plugins based on your Lua modules and lockfile.(GitHub)

---

4. Structure & Files

File / Folder	Purpose
init.lua	Core configuration loader
lua/	Modular config (plugins, options, keybindings, etc.)
lazy-lock.json	Locked plugin versions for reproducible setups
.neoconf.json	AstroNvim config defaults and override declarations
.stylua.toml, selene.toml	Style and linting configurations ensuring code consistency

---

5. Customization & Management

• Modify or Add Configs: Edit or add files in the lua/ folder to customize plugin behavior, keybindings, themes, LSP setup, etc.

• Sync Plugins: For plugin updates or lockfile changes:

  :Lazy sync

• Restore Previous Setup: Undo changes by restoring backups you made in Step 3.1.

---

6. Troubleshooting

• Missing Plugins or Errors? Run :Lazy sync to ensure dependencies are installed.
• Configuration Issues? Temporarily replace ~/.config/nvim with a minimal setup to debug.
• Check Health: Run :checkhealth to get diagnostics for LSPs, treesitter, and more.

---