https://github.com/visrust/arch-nvim
visrust/arch-nvim : 🦀 A Neovim configuration that aims to provide an IDE-like experience while preserving Neovim’s minimalism. Supports multiple languages out of the box, promotes a cleaner code culture, and enables smarter, less noisy coding.
https://github.com/visrust/arch-nvim
arch-linux arch-nvim astronvim lazyvim lunarvim neovim nvchad nvim nvim-arch nvim-distro nvim-plugin termux
Last synced: about 2 months ago
JSON representation
visrust/arch-nvim : 🦀 A Neovim configuration that aims to provide an IDE-like experience while preserving Neovim’s minimalism. Supports multiple languages out of the box, promotes a cleaner code culture, and enables smarter, less noisy coding.
- Host: GitHub
- URL: https://github.com/visrust/arch-nvim
- Owner: visrust
- License: mit
- Created: 2025-11-11T11:58:56.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-02-12T10:38:48.000Z (4 months ago)
- Last Synced: 2026-02-12T15:27:29.467Z (4 months ago)
- Topics: arch-linux, arch-nvim, astronvim, lazyvim, lunarvim, neovim, nvchad, nvim, nvim-arch, nvim-distro, nvim-plugin, termux
- Language: Lua
- Homepage: https://visrust.github.io/arch-nvim/
- Size: 278 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Audit: auditor/INDEX.md
Awesome Lists containing this project
README
# 🦀 arch-nvim
> The beautiful neovim configuration that just works for any programmer. And is maintained actively.
[](https://github.com/visrust/arch-nvim/releases/tag/v1.0)
[](https://neovim.io)
[](LICENSE)
[](https://github.com/visrust/arch-nvim)
[Features](#-features) • [Installation](#-installation) • [Screenshots](#-screenshots) • [Keymaps](KEYMAPS.md) • [Documentation](#-documentation)
---
## ✨ Features
### 🎨 Beautiful & Modern UI
- **56 carefully curated plugins** for optimal performance
- Multiple premium themes (TokyoNight, Catppuccin, Rose Pine, Nightfox)
- Elegant bufferline with `nvim-cokeline`
- Stunning statusline powered by `lualine.nvim`
- Alpha dashboard for quick access
### 🚀 Productivity Powerhouse
- **20 LSP servers** pre-configured for multiple languages
- Lightning-fast fuzzy finding with `fzf-lua`
- Advanced completion with `blink.cmp`
- Integrated debugging with `nvim-dap`
- Smart code navigation with `leap.nvim`
- Session management with `resession.nvim`
### 🛠️ Developer Experience
- Git integration via `lazygit.nvim`
- File management with `oil.nvim` and `yazi.nvim`
- Terminal integration with `toggleterm.nvim`
- Auto-pairs, surround operations, and multi-cursor editing
- Code formatting with `conform.nvim`
- Comprehensive snippet support
### 🎯 Language Support
#### High-Level Languages
- Python (pyright)
- Lua (lua_ls)
#### Low-Level Languages
- C/C++ (clangd)
- Rust (rust-analyzer)
- Zig (zls)
- Assembly (asm-lsp)
- CMake
#### Web Development
- TypeScript/JavaScript (ts_ls)
- HTML, CSS
- Go (gopls)
- PHP (phpactor)
#### Game Development
- GDScript (Godot_ls)
#### Utilities & Documentation
- Bash, Docker, JSON, YAML
- Markdown (marksman, vale)
- Vim script
---
## 📦 Installation
### Prerequisites
- Neovim ≥ 0.9.0
- Git
- A [Nerd Font](https://www.nerdfonts.com/) (recommended: JetBrainsMono Nerd Font)
- Node.js (for some LSP servers)
- Ripgrep (for fzf-lua)
### Quick Install
```bash
# Backup your existing config
mv ~/.config/nvim ~/.config/nvim.backup
# Clone arch-nvim (stable v1.0)
git clone --depth 1 --branch v1.0 https://github.com/visrust/arch-nvim.git ~/.config/nvim
# Launch Neovim
nvim
```
The plugin manager will automatically install all plugins on first launch.
### Manual Installation
1. Clone the repository:
```bash
git clone https://github.com/visrust/arch-nvim.git ~/.config/nvim
```
2. Checkout the stable release:
```bash
cd ~/.config/nvim
git checkout v1.0
```
3. Launch Neovim and let plugins install:
```bash
nvim
```
---
## 📸 Screenshots
### Dashboard & Workflow
### Coding Experience
### File Navigation
### Fuzzy Finding
### Integrated Terminal
---
## 📚 Documentation
### 📊 Configuration Overview
| Metric | Count |
|--------|------:|
| **Unique Plugins** | 56 |
| **LSP Servers** | 20 |
| **Keybindings** | 36+ |
| **Functions** | 56 |
| **Themes** | 4 |
### 📖 Detailed Documentation
- **[Keybinding Reference](KEYMAPS.md)** - Complete list of all keyboard shortcuts
- **[Plugin Inventory](01_PLUGINS.md)** - All installed plugins and their purposes
- **[LSP Servers](04_LSP_SERVERS.md)** - Language server configurations
- **[Duplicate Detection](03_DUPLICATES.md)** - Configuration audit results
### ⚙️ Configuration Structure
```
arch-nvim/
├── lua/
│ └── user/
│ ├── config/ # Plugin configurations
│ │ ├── dap/ # Debugger setup
│ │ ├── ide/ # IDE features
│ │ ├── server/ # LSP servers
│ │ └── tools/ # Utility tools
│ ├── sys/ # System configurations
│ ├── ui/ # UI components
│ └── other/ # Miscellaneous
└── init.lua # Entry point
```
---
## ⌨️ Quick Reference
> For the complete keybinding reference, see [KEYMAPS.md](KEYMAPS.md)
### Essential Shortcuts
| Key | Action | Mode |
|-----|--------|------|
| `` | Next buffer | Normal |
| `hf` | Help tags (Fuzzy) | Normal |
| `zz` | Run code | Normal |
| `dd` | Debug | Normal |
| `m` / `M` | Leap forward/backward | Normal |
| `ut` | Toggle Undotree | Normal |
### Leader Key Groups
- `r*` - Replace operations
- `l*` - LSP operations
- `d*` - Debug operations
- `g*` - Git operations
- `gp*` - Goto preview operations
---
## 🔧 Customization
### Changing the Theme
Edit `lua/user/sys/plugins.lua` and modify the colorscheme section:
```lua
-- Available themes: tokyonight, catppuccin, rose-pine, nightfox
vim.cmd([[colorscheme tokyonight]])
```
### Adding LSP Servers
1. Create a new file in `lua/user/config/server//`
2. Configure the LSP using `lspconfig`
3. The server will be automatically loaded
### Modifying Keybindings
Edit keybindings in:
- `lua/user/sys/mappings.lua` - Core mappings
- `lua/user/other/keymaps/general.lua` - General keymaps
- Individual plugin configs for plugin-specific maps
---
## 🐛 Troubleshooting
### Plugins Not Installing
```bash
# Remove plugin cache
rm -rf ~/.local/share/nvim
# Restart Neovim
nvim
```
### LSP Not Working
1. Ensure the language server is installed:
```bash
:Mason
```
2. Check LSP status:
```vim
:LspInfo
```
### Performance Issues
- Check for duplicate plugins in [03_DUPLICATES.md](03_DUPLICATES.md)
- Disable unused LSP servers
- Consider using lazy loading for heavy plugins
---
## 🤝 Contributing
Contributions are welcome! Please:
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request
### Development Guidelines
- Follow the existing configuration structure
- Document new keybindings
- Update KEYMAPS.md for new shortcuts
- Test with multiple languages
---
## 📝 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
## 💖 Acknowledgments
Special thanks to all the plugin authors and the Neovim community for making this configuration possible.
### Featured Plugins
- [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig)
- [blink.cmp](https://github.com/saghen/blink.cmp)
- [fzf-lua](https://github.com/ibhagwan/fzf-lua)
- [nvim-dap](https://github.com/mfussenegger/nvim-dap)
- [lualine.nvim](https://github.com/nvim-lualine/lualine.nvim)
- And 50+ more amazing plugins!
---
## 🌟 Star History
If you find this configuration helpful, please consider giving it a star! ⭐
---
**Built with ❤️ for the Neovim community**
[Report Bug](https://github.com/visrust/arch-nvim/issues) • [Request Feature](https://github.com/visrust/arch-nvim/issues)