nvim

🖥️ Neovim Config (NvChad-Based)

Welcome to my personal Neovim configuration, built on top of NvChad for a modern, fast, and minimal Neovim setup tailored for web development, JavaScript/TypeScript, and general-purpose programming.

⚡ Designed for speed, productivity, and ease of maintenance with VSCode compatibility.

📷 Screenshots

✨ Key Features

• 🚀 Lazy-loaded plugin architecture via NvChad v2.5
• 🎨 Tokyo Night theme with transparency and custom dashboard
• 🧠 Intelligent code formatting with Prettier, Stylua, and format-on-save
• 🔧 Comprehensive LSP support for modern web development
• 🧵 Template string auto-conversion (VS Code-like behavior)
• 🏷️ Auto HTML/JSX tag closing and renaming
• 🔍 Enhanced Telescope UI with dropdown selections
• 🧑‍🔧 LazyGit integration for seamless Git workflow
• 🖥️ Tmux navigation support for terminal multiplexing
• 📝 Markdown rendering with live preview
• 👨‍💻 VSCode-Neovim compatibility with dedicated config
• ⌨️ Custom key mappings for productivity
• ��� BlVink completion engine for fast autocompletion
• 🌲 Enhanced Treesitter with auto-install for syntax highlighting

🛠️ Plugin Ecosystem

🌐 Language Support

Full LSP Support

• JavaScript/TypeScript - Complete IntelliSense, auto-imports, refactoring (ts_ls)
• React (JSX/TSX) - Component intelligence, prop validation
• HTML/CSS - Tag completion, CSS properties, validation
• JSON - Schema validation, formatting
• Lua - Neovim API awareness, diagnostics with vim globals
• Markdown - Live rendering with Marksman LSP
• TailwindCSS - Class completion and validation
• Bash/Shell - Script validation and completion
• Emmet - Abbreviation expansion for web technologies

Enhanced Features

• TailwindCSS - Class completion and validation
• Emmet - Fast HTML/CSS abbreviation expansion for HTML, CSS, JS/TS React
• Template Strings - Auto-conversion for JS/TS/React/Vue/Svelte/Python/C#
• Auto-tagging - Smart HTML/JSX tag management with Treesitter
• Bash/Shell - LSP support for shell scripting
• Markdown - Enhanced support with Marksman LSP and live rendering

Formatting Support

• Prettier/Prettierd - JavaScript, TypeScript, HTML, CSS, JSON, Markdown, YAML
• Stylua - Lua code formatting
• Shfmt - Shell script formatting
• Format on Save - Automatic formatting with 500ms timeout and LSP fallback

⚙️ Custom Configuration Highlights

Theme & UI

• Tokyo Night theme with transparency enabled
• Custom dashboard with ASCII art header
• Minimal statusline with rounded separators
• Relative line numbers for better navigation

Key Mappings

• ; → : (Quick command mode access)
• jk → <ESC> (Fast insert mode exit)
• <C-s> → Save file (works in all modes)
• <C-a> → Select all text
• <A-hjkl> → Navigate in insert mode
• <leader>lg → Open LazyGit
• <A-i> → Toggle floating terminal with custom styling
• <C-hjkl> → Tmux navigation
• <C-\> → Go to previous Tmux pane
• g1-g9 → Switch between buffers (g0 for last buffer)
• Visual mode selections: <leader>i{, <leader>a{, etc. for brackets/quotes

Advanced Features

• VSCode compatibility - Dedicated minimal config for VSCode-Neovim extension
• Floating terminal - Customized with rounded borders (80% width/height)
• Smart diagnostics - Virtual text enabled globally
• Auto-formatting - Format on save with 500ms timeout and LSP fallback
• Template strings - Auto-convert quotes to backticks in JS/TS/React
• Blink completion - Fast completion engine integrated with NvChad
• Relative line numbers - Enhanced navigation experience
• Buffer switching - Quick buffer navigation with g1-g9 keys

🧰 Prerequisites

Required

• Neovim v0.9+ (v0.10+ recommended)
• Git
• Node.js and npm (for LSP servers and formatters)

Optional but Recommended

• LazyGit - Git UI integration
• Tmux - Terminal multiplexer for navigation
• Nerd Font - For proper icon display

Language Servers & Formatters

The following LSP servers are configured and can be installed via Mason:

# LSP Servers (install via :Mason or manually)
npm install -g typescript-language-server    # JavaScript/TypeScript
npm install -g vscode-langservers-extracted  # HTML, CSS, JSON
npm install -g @tailwindcss/language-server  # TailwindCSS
npm install -g emmet-ls                       # Emmet abbreviations
npm install -g bash-language-server          # Bash/Shell
npm install -g marksman                       # Markdown

# Formatters (for conform.nvim)
npm install -g prettier                       # JS/TS/HTML/CSS/JSON/MD/YAML
npm install -g @fsouza/prettierd             # Faster Prettier daemon
cargo install stylua                          # Lua formatting
npm install -g shfmt                          # Shell script formatting

🚀 Installation

Method 1: Fresh NvChad Installation

# Backup existing config (if any)
mv ~/.config/nvim ~/.config/nvim.backup

# Clone this config
git clone https://github.com/ahmad9059/nvim ~/.config/nvim

# Start Neovim (plugins will auto-install)
nvim

# Install LSP servers and formatters
:Mason
# Then install the servers you need, or run:
:MasonInstallAll

# Sync plugins if needed
:Lazy sync

Method 2: VSCode-Neovim Users

This config includes dedicated VSCode compatibility. Simply install the VSCode-Neovim extension and point it to this config.

🎯 Usage Guide

First Launch

1. Open Neovim - plugins will automatically install
2. Wait for Lazy.nvim to finish downloading plugins
3. Restart Neovim for full functionality
4. Run :checkhealth to verify everything is working

Key Workflows

Git Integration

• <leader>lg - Open LazyGit for visual Git operations
• Use LazyGit’s intuitive interface for staging, committing, and pushing

Code Formatting

• Automatic - Format on save (500ms timeout)
• Manual - Use LSP formatting commands
• Supported - JS, TS, HTML, CSS, JSON, Markdown, Lua

Terminal Usage

• <A-i> - Toggle floating terminal with custom styling
• Terminal opens with 80% width, 70% height, rounded borders
• Positioned at 10% from top, 8% from left for optimal viewing

Tmux Integration

• <C-h/j/k/l> - Navigate between Neovim and Tmux panes seamlessly
• <C-\> - Go to previous Tmux pane

🔧 Troubleshooting

Common Issues

LSP not working?

# Check if language servers are installed
:LspInfo

# Install missing servers via Mason
:Mason

Formatting not working?

# Check formatter availability
:ConformInfo

# Install formatters manually
npm install -g prettier @fsouza/prettierd
cargo install stylua
npm install -g shfmt

Plugins not loading?

# Check plugin status
:Lazy

# Force plugin sync
:Lazy sync

Tmux navigation not working?

• Ensure Tmux is installed and running
• Check if christoomey/vim-tmux-navigator plugin is loaded

📁 Project Structure

~/.config/nvim/
├── init.lua                 # Main entry point with VSCode compatibility
├── lazy-lock.json          # Plugin version lock file
├── .stylua.toml            # Stylua formatter configuration
├── lua/
│   ├── autocmds.lua        # Auto commands
│   ├── chadrc.lua          # NvChad theme and UI configuration
│   ├── mappings.lua        # Custom key mappings
│   ├── options.lua         # Neovim options (relative numbers, etc.)
│   ├── configs/
│   │   ├── conform.lua     # Formatter configuration (Prettier, Stylua, etc.)
│   │   ├── lazy.lua        # Lazy.nvim setup
│   │   └── lspconfig.lua   # LSP server configurations
│   └── plugins/
│       └── init.lua        # Plugin specifications
└── preview/
    ├── preview.png         # Screenshot 1
    └── preview-2.png       # Screenshot 2

🎨 Customization

Changing Theme

Edit lua/chadrc.lua:

M.base46 = {
  theme = "tokyonight", -- Current theme (change to your preferred theme)
  transparency = true,  -- Current setting (set to false to disable)
  hl_override = {
    Comment = { italic = true },
    ["@comment"] = { italic = true },
  },
}

Adding New LSP

Edit lua/configs/lspconfig.lua:

-- Example: Python LSP
lspconfig.pyright.setup {
  on_attach = on_attach,
  capabilities = capabilities,
}

Custom Key Mappings

Edit lua/mappings.lua:

-- Example: Add your custom mappings
map("n", "<leader>custom", "<cmd>YourCommand<CR>", { desc = "Your description" })

-- Current custom mappings include:
-- Buffer navigation with g + numbers
-- Visual mode selections for brackets/quotes
-- Tmux navigation integration
-- Custom terminal toggle with styling

🤝 Contributing

Feel free to:

• Report bugs or issues
• Suggest new features or improvements
• Submit pull requests
• Share your customizations

Development Setup

1. Fork the repository
2. Create a feature branch
3. Test your changes thoroughly
4. Submit a pull request with clear description

🙌 Credits & Acknowledgments

Core Dependencies

• NvChad - Amazing Neovim configuration framework
• Lazy.nvim - Modern plugin manager
• Telescope - Fuzzy finder and UI

Key Plugins

• conform.nvim - Formatter integration
• nvim-lspconfig - LSP configuration
• LazyGit - Git terminal UI
• template-string.nvim - Smart template strings
• noice.nvim - Enhanced UI components

Community

• All the amazing open-source contributors
• NvChad community for the solid foundation
• Neovim core team for the incredible editor

👨‍💻 Author

Ahmad Hassan
Software Engineer & Full Stack Developer

📄 License

This project is open source and available under the MIT License.

MIT License - Feel free to use, modify, and distribute

⭐ Show Your Support

If this configuration helped you, please consider:

• ⭐ Starring the repository
• 🍴 Forking for your own customizations
• 📢 Sharing with fellow developers
• 🐛 Reporting issues or suggesting improvements

Happy coding with Neovim! 🚀