A modern, comprehensive Neovim configuration built with Lua, optimized for Python, Django, and Web Development. Features advanced LSP support, debugging, testing, project management, and professional development workflows.

• Tokyo Night colorscheme with custom transparency support
• Alpha Dashboard with beautiful ASCII art and quick actions
• Lualine status line with file info and git integration
• Bufferline for elegant tab management
• Indent Blankline for visual indentation guides
• Relative line numbers for efficient navigation

• Mason for automatic LSP server management
• nvim-lspconfig with pre-configured servers:
  • Python (Pyright + Ruff LSP) - Advanced Python development with type checking
  • TypeScript/JavaScript - Full featured development
  • Lua (lua_ls) - Neovim configuration optimized
  • HTML/CSS - Web development essentials with Django template support
  • TailwindCSS - Utility-first CSS framework
  • Svelte - Modern web framework support
  • GraphQL - API development
  • Emmet - HTML/CSS expansion
  • Prisma - Database ORM support
  • ESLint - JavaScript/TypeScript linting
• Diagnostics with custom icons and error handling
• Go to definition/references with Telescope integration

• nvim-cmp autocompletion with multiple sources:
  • LSP completion
  • GitHub Copilot integration
  • File path completion
  • Buffer text completion
  • Snippet expansion
• LuaSnip with friendly snippets
• Treesitter syntax highlighting for 20+ languages
• Code actions and smart renaming
• Incremental selection with Treesitter

• Telescope with multiple pickers:
  • File finder (<leader>ff)
  • Live grep (<leader>fs)
  • Recent files (<leader>fr)
  • Grep under cursor (<leader>fc)
  • Todo comments (<leader>ft)
  • Keymaps (<leader>fk)
• FZF native for improved performance

• Neo-tree modern file explorer with:
  • Git integration and status indicators
  • Custom icons and advanced UI
  • Fuzzy finder integration
  • Multiple views (filesystem, buffers, git)
• Project.nvim for intelligent project detection
• Auto-session for project session management
• Overseer task runner for development workflows
• ToggleTerm integrated terminal with custom configurations

• Auto-pairs for bracket completion
• Surround for text object manipulation
• Comment.nvim for smart commenting
• Substitute for improved search/replace
• Todo Comments highlighting and navigation
• Vim Maximizer for window management

• Conform.nvim formatting with:
  • Ruff (modern Python formatter/linter)
  • Prettier for web technologies
  • Stylua for Lua
  • Format on save enabled
• nvim-lint with comprehensive linters:
  • MyPy for Python type checking
  • Flake8 for Python style guide enforcement
  • Bandit for Python security analysis
  • Auto-linting on file events

• Python Configuration System:
  • Smart virtual environment detection
  • Project type detection (Django, Flask, FastAPI)
  • Python executable resolution
• Django Integration:
  • Auto-detection of Django projects
  • Django template file type support (htmldjango)
  • Model/View/URL generators with keymaps
  • Management commands (runserver, migrate, shell, test)
• Virtual Environment Management:
  • VenvSelector for easy environment switching
  • Swenv alternative environment manager
• Python REPL & Debugging:
  • Iron.nvim with Django shell integration
  • nvim-dap-python for debugging with breakpoints
  • Neotest for running and debugging tests
  • Custom configurations for Django, Flask, FastAPI

• Emmet for HTML/CSS expansion
• Auto-tag closing for HTML/JSX/TSX
• Color picker and preview (CCC.nvim)
• Live server (Bracey) for real-time preview
• Package.json management with version info
• REST client for API testing
• Database integration (DadBod UI)
• Markdown preview for documentation

• LazyGit integration for git operations
• Diffview for advanced git diff viewing
• Trouble for diagnostics and quickfix management
• Spectre for advanced search and replace

1. Neovim 0.9+

   # macOS
   brew install neovim
   
   # Ubuntu/Debian
   sudo apt install neovim
   
   # Arch Linux
   sudo pacman -S neovim

2. Git (for plugin management)

3. Node.js 16+ (for LSP servers and web tools)

4. Python 3.8+ (for Python LSP and linting)

5. Ripgrep (for Telescope grep)

   # macOS
   brew install ripgrep
   
   # Ubuntu/Debian
   sudo apt install ripgrep
   
   # Arch Linux
   sudo pacman -S ripgrep

6. Optional but Recommended:

   • LazyGit for git operations: brew install lazygit
   • FZF for enhanced fuzzy finding: brew install fzf
   • fd for faster file finding: brew install fd

1. Backup existing configuration (if any):

   mv ~/.config/nvim ~/.config/nvim.backup

2. Clone this configuration:

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

3. Install external dependencies:

   # Install Node.js formatters
   npm install -g prettier eslint
   
   # Install Python development tools
   pip install ruff black isort mypy bandit debugpy
   
   # Install Stylua (Lua formatter)
   # macOS
   brew install stylua
   
   # Ubuntu/Debian
   sudo apt install stylua
   
   # Or download from releases: https://github.com/JohnnyMorganz/StyLua/releases
   
   # Optional: Install additional Python tools
   pip install ipython jupyter  # Enhanced Python REPL

4. Launch Neovim:

   nvim

5. Plugin installation:

   • Lazy.nvim will automatically install all plugins on first launch
   • LSP servers will be automatically installed via Mason
   • Wait for all installations to complete

~/.config/nvim/
├── init.lua                    # Entry point
├── lazy-lock.json             # Plugin version lock file
├── README.md                  # This documentation
├── lua/kling/
│   ├── core/
│   │   ├── init.lua           # Core module loader
│   │   ├── keymaps.lua        # Global key mappings
│   │   └── options.lua        # Neovim options
│   ├── lazy.lua               # Lazy.nvim setup
│   ├── python-config.lua      # Python utilities and configuration
│   └── plugins/
│       ├── init.lua           # Plugin loader
│       ├── alpha.lua          # Dashboard
│       ├── auto-session.lua   # Session management
│       ├── autopairs.lua      # Auto bracket pairing
│       ├── bufferline.lua     # Tab bar
│       ├── colorscheme.lua    # Tokyo Night theme
│       ├── comment.lua        # Smart commenting
│       ├── copilot.lua        # GitHub Copilot integration
│       ├── dap-python.lua     # Python debugging
│       ├── django.lua         # Django development tools
│       ├── dressing.lua       # UI improvements
│       ├── formatting.lua     # Code formatting
│       ├── indent-blankline.lua # Indentation guides
│       ├── iron.lua           # REPL integration
│       ├── lazygit.lua        # Git integration
│       ├── linting.lua        # Code linting
│       ├── lualine.lua        # Status line
│       ├── neogen.lua         # Documentation generation
│       ├── neotest.lua        # Testing framework
│       ├── nvim-cmp.lua       # Autocompletion
│       ├── nvim-dap.lua       # Debug Adapter Protocol
│       ├── nvim-tree.lua      # File explorer
│       ├── project-management.lua # Project tools
│       ├── substitute.lua     # Search/replace
│       ├── surround.lua       # Text objects
│       ├── telescope.lua      # Fuzzy finder
│       ├── todo-comments.lua  # Todo highlighting
│       ├── treesitter.lua     # Syntax highlighting
│       ├── trouble.lua        # Diagnostics panel
│       ├── venv-selector.lua  # Virtual environment management
│       ├── vim-maximizer.lua  # Window management
│       ├── web-dev.lua        # Web development tools
│       └── lsp/
│           ├── lspconfig.lua  # LSP configuration
│           └── mason.lua      # LSP server management

The configuration uses Tokyo Night with custom transparency. To modify:

-- In lua/kling/plugins/colorscheme.lua
local transparent = true -- Toggle transparency
-- Modify colors in the on_colors function

1. Automatic installation via Mason (recommended):

   -- In lua/kling/plugins/lsp/mason.lua
   ensure_installed = {
     "lua_ls",
     "pyright",
     "ruff_lsp",
     "your_new_server", -- Add here
   }

2. Manual configuration:

   -- In lua/kling/plugins/lsp/lspconfig.lua
   lspconfig.your_server.setup({
     capabilities = capabilities,
     -- Your specific configuration
   })

-- In lua/kling/plugins/formatting.lua
formatters_by_ft = {
  python = { "ruff_format", "ruff_organize_imports" },
  javascript = { "prettier" },
  your_filetype = { "your_formatter" },
}

Add to lua/kling/core/keymaps.lua:

keymap.set("n", "<leader>your_key", "<cmd>YourCommand<CR>", { desc = "Your description" })

1. Check server installation: :Mason
2. Restart LSP: <leader>rs
3. Check logs: :LspLog
4. Python-specific issues:
   • Ensure correct Python interpreter: <leader>cv to select virtual env
   • Check if Pyright is using correct Python: :LspInfo
   • Restart after changing virtual environment

1. Update plugins: :Lazy update
2. Clean and reinstall: :Lazy clean then restart Neovim
3. Check plugin status: :Lazy
4. Profile startup time: :Lazy profile

1. Check startup time: nvim --startuptime startup.log
2. Profile plugins: :Lazy profile

1. Virtual Environment Not Detected:

   • Use <leader>cv to manually select environment
   • Check if venv is in standard locations (venv/, .venv/, env/)
   • Ensure Python executable is accessible

2. Django Features Not Working:

   • Ensure manage.py exists in project root
   • Django commands require proper virtual environment
   • Check if Django is installed: python -m django --version

3. Debugging Issues:

   • Install debugpy: pip install debugpy
   • Check DAP configuration: :lua =vim.tbl_keys(require('dap').configurations.python)

1. Check if formatter is installed: Run formatter command in terminal
2. Check conform setup: :ConformInfo
3. Python formatting: Ensure ruff is installed: pip install ruff

• Neovim Documentation
• Lua Guide for Neovim
• LSP Configuration
• Telescope Documentation
• Treesitter Documentation

• Python LSP Guide
• Django Documentation
• Ruff Formatter/Linter
• Python Debugging with DAP
• Testing with Neotest

• Emmet Documentation
• TailwindCSS IntelliSense
• REST Client Usage

• Lazy.nvim Plugin Manager
• Mason Tool Installation

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

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

This configuration is built upon the excellent work of the Neovim community and the following plugin authors:

• folke - Tokyo Night, Lazy.nvim, Trouble, and many other plugins
• nvim-telescope - Telescope ecosystem
• nvim-treesitter - Treesitter integration
• hrsh7th - nvim-cmp and related plugins
• mfussenegger - nvim-dap, nvim-lint, nvim-dap-python
• stevearc - conform.nvim, overseer.nvim
• linux-cultist - venv-selector.nvim
• nvim-neotest - Testing framework
• Vigemus - Iron.nvim REPL integration
• GitHub Copilot - AI-powered code completion
• And many others in the Neovim ecosystem

• Professional Python Development: Comprehensive Django support with project detection
• Modern Tooling: Ruff LSP for fast Python linting and formatting
• Advanced Debugging: Full DAP integration with Python, Django, Flask, FastAPI configurations
• Intelligent Virtual Environment Management: Automatic detection and switching
• Web Development Ready: Complete toolchain for modern web development
• Project-Aware: Smart project detection and management

Happy coding! 🎉