AetherialNvim

The Ultimate Cognitive Neovim Experience

---

🔮 1. Philosophy: Engineering Purity

AetherialNvim It solves the "Distro Burden" by enforcing a strict architectural boundary.

• The Core (lua/aether/): The engine. Immutable. Managed by AetherShield.
• The User (lua/user/): The soul. Your overrides, your keymaps, your plugins. Never overwritten.

Dashboard

System Health	Theme Management

---

🛡️ 2. Core Pillars

🌟 Features

🚀 Performance First

• Blink.cmp - Next-generation completion engine written in Rust (goodbye nvim-cmp lag!)
• Lazy-loaded plugins - Sub-50ms startup time
• Smart caching - TreeSitter, LSP, and syntax optimizations
• Async everything - Non-blocking UI, no more freezes

🎨 Visual Excellence

• 15+ Premium Themes - Curated colorscheme collection with live preview
• Themery.nvim - Interactive theme switcher UI
• Smooth Animations - Powered by mini.animate for buttery-smooth transitions
• Modern UI Stack
  • Noice.nvim - Command line, notifications, and message UI overhaul
  • Bufferline - Beautiful tab-like buffer list
  • Lualine - Blazing fast statusline
  • Dashboard - Greeter with MRU and quick actions

🧠 Intelligence Built-In

• LSP Zero - Pre-configured Language Server Protocol support
• Mason Integration - One-command LSP/linter/formatter installation
• Smart Auto-completion - Context-aware suggestions with Blink.cmp
• Inline Diagnostics - Beautiful error/warning displays
• Code Actions - Quick fixes and refactoring at your fingertips

📂 File Navigation

• Telescope.nvim - Fuzzy finder on steroids
• Neo-tree - Modern file explorer with Git integration
• Flash.nvim - Jump anywhere in milliseconds
• Smart buffer management - Easy switching, closing, and organizing

🔧 Developer Tools

• Git Integration - Gitsigns, diffview, and conflict resolution
• Terminal - Integrated toggleable terminal (Snacks)
• Session Management - Auto-save and restore workspace sessions
• Markdown Preview - Real-time markdown rendering
• Health Checks - Built-in diagnostics for your config

🎯 Productivity

• Which-Key - Never forget a keybinding
• Smart indentation - Auto-detect and maintain code style
• Multi-cursor support - Edit multiple locations simultaneously
• Snippet expansion - Built-in snippet engine
• Undo tree - Visual undo history

---

💭 Philosophy

AetherialNvim is built on three core principles:

🎭 "Opinionated, Not Overbearing"

I've made thoughtful decisions about plugins and configurations, but your workflow is sacred. Every core plugin can be modified or disabled through the user/ directory without touching the base config.

🧩 "Modular by Design"

The architecture mirrors how you think about code:

aether/
├── core/       → Editor fundamentals (options, keymaps, autocmds)
├── modules/
│   ├── coding/    → Completion, snippets, formatting
│   ├── editor/    → File nav, search, buffer management
│   ├── lsp/       → Language intelligence
│   ├── treesitter/ → Syntax & parsing
│   └── ui/        → Themes, statusline, notifications

Each module is self-contained and lazy-loaded. Want to rip out the UI layer? Delete modules/ui/. Done.

⚡ "Fast is a Feature"

Performance isn't negotiable. We use:

• Blink.cmp instead of nvim-cmp (5-10x faster completion)
• Lazy loading for everything non-essential
• Native Lua over VimScript whenever possible
• Optimized TreeSitter queries and fold expressions

Startup time: ~40-60ms on modern hardware

---

📦 3. Installation

Prerequisites

• Neovim ≥ 0.10.0
• Git ≥ 2.19.0
• A Nerd Font (recommended: JetBrainsMono, FiraCode, Hack)
• ripgrep (for Telescope)
• Node.js (for some LSP servers)

Quick Start

🐧 Linux / MacOS Installation

1️⃣ Backup your existing config (if any)

mv ~/.config/nvim ~/.config/nvim.backup
mv ~/.local/share/nvim ~/.local/share/nvim.backup
mv ~/.local/state/nvim ~/.local/state/nvim.backup
mv ~/.cache/nvim ~/.cache/nvim.backup

2️⃣ Clone AetherialNvim

git clone https://github.com/AetherSyscall/AetherialNvim.git ~/.config/nvim

3️⃣ Launch and Install

nvim +AetherDoctor

On first launch:

• Lazy.nvim will auto-install plugins (~30 seconds)
• Treesitter will compile language parsers
• Mason will install configured LSP servers

4️⃣ Health Check

:checkhealth aether

🪟 Windows Installation

1️⃣ Backup your existing config (if any)

PowerShell:

# Backup Neovim config
if (Test-Path $env:LOCALAPPDATA\nvim) {
    Move-Item $env:LOCALAPPDATA\nvim $env:LOCALAPPDATA\nvim.backup
}

# Backup Neovim data
if (Test-Path $env:LOCALAPPDATA\nvim-data) {
    Move-Item $env:LOCALAPPDATA\nvim-data $env:LOCALAPPDATA\nvim-data.backup
}

Command Prompt:

:: Backup Neovim config
move %LOCALAPPDATA%\nvim %LOCALAPPDATA%\nvim.backup

:: Backup Neovim data
move %LOCALAPPDATA%\nvim-data %LOCALAPPDATA%\nvim-data.backup

2️⃣ Clone AetherialNvim

PowerShell:

git clone https://github.com/AetherSyscall/AetherialNvim.git $env:LOCALAPPDATA\nvim

Command Prompt:

git clone https://github.com/AetherSyscall/AetherialNvim.git %LOCALAPPDATA%\nvim

3️⃣ Install Windows Dependencies

Using Chocolatey:

# Install Chocolatey first if you haven't
# Then install dependencies
choco install mingw ripgrep fd nodejs-lts

# Install a Nerd Font
choco install nerd-fonts-jetbrainsmono

Using Scoop:

# Install Scoop first if you haven't
# Then install dependencies
scoop install gcc ripgrep fd nodejs-lts

# Install a Nerd Font
scoop bucket add nerd-fonts
scoop install JetBrainsMono-NF

Manual Installation:

• GCC/MinGW - For Treesitter compilation
• Ripgrep - For Telescope search
• fd - For file finding
• Node.js - For LSP servers
• Nerd Font - JetBrainsMono recommended

4️⃣ Launch and Install

nvim +AetherDoctor

On first launch:

• Lazy.nvim will auto-install plugins (~30 seconds)
• Treesitter will compile language parsers (requires MinGW/GCC)
• Mason will install configured LSP servers

Note: If Treesitter compilation fails, ensure GCC/MinGW is in your PATH. You can verify with gcc --version in PowerShell/CMD.

5️⃣ Health Check

:checkhealth aether

🔧 Windows-Specific Tips

Terminal Setup:

• Use Windows Terminal for the best experience
• Enable GPU acceleration in Windows Terminal settings
• Set Neovim as the default shell: nvim in the command palette

PATH Configuration: If Mason-installed LSP servers aren't working, add Mason's bin to PATH:

# Add to PowerShell profile ($PROFILE)
$env:PATH += ";$env:LOCALAPPDATA\nvim-data\mason\bin"

WSL Alternative: For the best Linux-like experience, consider using WSL2:

wsl --install

Then follow the Linux installation steps inside WSL.

---

⌨️ 4. Keybindings (The Essentials)

Key	Action	Context
JK	Instant Escape	Terminal Mode
jj	Escape	Insert Mode
<leader>tt	Toggle Terminal	1, 2, 3 counts supported
<leader>ud	Return Home	Return to Dashboard
<leader>co	AetherShield	Jump to User Overrides
<leader>e	Explorer	Toggle Neo-tree
<leader>ff	Find Files	Telescope Search

---

🛠️ 5. Maintenance Commands

• :AetherDoctor - Advanced system health diagnostics.
• :AetherUpdate - Core engine & plugin synchronization.
• :AetherBackup - Create a timestamped snapshot of your user/ config.
• :AetherShieldUnlock - Emergency developer override for core files.

---

AetherialNvim • v1.0.0 (Few messy things , Few ultimate but what matters with age things improve.)