bugsvim is a thoughtfully curated NeoVim configuration built for modern development workflows. It combines the power of Lua-based configuration with a carefully selected collection of plugins to provide a fast, extensible, and enjoyable editing experience.

This configuration is forked from BUGSVIM by Abhra00. We are grateful for the excellent foundation and extend our thanks to:

• Abhra00 for the original BUGSVIM project
• folke and the lazy.nvim team for the exceptional plugin manager
• nvim-treesitter contributors for intelligent syntax parsing
• All maintainers of the plugins integrated into this configuration

• Tokyo Night colorscheme with carefully tuned defaults
• Dynamic statusline via lualine showing real-time editor information
• Smart session persistence that survives restarts
• Smooth animations and visual feedback

• Complete LSP ecosystem with support for:
  • Lua (lua-language-server)
  • Python (Pyright + Ruff)
  • TypeScript/JavaScript (ts_ls)
  • C/C++ (clangd)
  • Rust (rust-analyzer)
  • Bash (bash-language-server)
  • HTML, CSS, Tailwind CSS
  • Hyprland (hyprls)
  • Java (JDTLS)
• Enhanced diagnostics with inline error messages, gutter signs, and floating windows
• Advanced code completion via Blink Cmp with intelligent caching
• Multi-formatter support via Conform (stylua, shfmt, clang-format, prettier)
• Real-time linting with nvim-lint
• Interactive debugging support via nvim-dap

• Treesitter-powered syntax highlighting and text objects
• Fast fuzzy finding and navigation
• Git integration with gitsigns for inline blame and diff hunks
• Task & TODO tracking with todo-comments
• Smart snippets for rapid coding
• Lazy loading for sub-millisecond startup times
• Which-key integration for discoverable keybindings
• Beautiful UI with Noice.nvim - command palette and event notifications in popup windows

• Spring Boot development support
• Java Development via JDTLS
• Markdown support with live preview in browser (markdown-preview.nvim)
• Enhanced markdown editing with checkbox and table support (markdown.nvim)
• Snacks.nvim for notifications, animations, and quality-of-life features
• Mini.nvim utilities for enhanced editing
• LazyDev for integrated Neovim API documentation

• Persistent undo history
• Auto-formatting on save
• Smart keybindings
• Graceful error handling

bugsvim provides automated installation scripts for major Linux distributions:

git clone https://github.com/dwilliam62/bugsvim ~/.config/bugsvim
cd ~/.config/bugsvim
bash install-arch.sh

git clone https://github.com/dwilliam62/bugsvim ~/.config/bugsvim
cd ~/.config/bugsvim
bash install-debian.sh

git clone https://github.com/dwilliam62/bugsvim ~/.config/bugsvim
cd ~/.config/bugsvim
bash install-fedora.sh

The installation scripts will:

• Detect your distribution
• Backup your existing NeoVim configuration
• Install all required system packages and language servers
• Configure npm with user-level permissions
• Verify the complete installation
• Copy the configuration to ~/.config/nvim

See INSTALL.md for manual installation steps.

After installation:

# Reload your shell to apply PATH changes
source ~/.$(basename $SHELL)rc

# Launch NeoVim
nvim

# Plugins will auto-install on first launch
# Verify LSP status: :LspInfo
# Check health: :checkhealth

For detailed post-installation setup, see POST-INSTALL.md.

All configuration is organized in ~/.config/nvim/lua/:

nvim/
├── init.lua              # Entry point
└── lua/
    ├── config/           # Core configuration
    │   ├── options.lua   # Editor options & settings
    │   ├── keymaps.lua   # Key bindings
    │   ├── lazy.lua      # Plugin manager setup
    │   ├── autocmds.lua  # Auto commands
    │   └── globals.lua   # Global variables
    ├── plugins/          # Plugin specifications
    ├── servers/          # LSP configurations
    └── utils/            # Utility functions

For common issues and solutions, see POST-INSTALL.md.

This project is licensed under the GNU General Public License v3 (GPL-3.0).

You are free to:

• Use this software for any purpose
• Distribute copies
• Modify the source code

Under the condition that:

• You provide source code availability (include it or link to it)
• Any modified versions must also use GPL-3.0
• You include the license and copyright notices

See the LICENSE file for the full text.

For issues or contributions, visit the GitHub repository.