Skip to content
/ NDE Public

A modular and extensible Neovim configuration designed for modern development workflows. Each component is structured for maintainability and ease of customization. The Kanagawa color scheme ensures a visually consistent and focused user experience.

License

Notifications You must be signed in to change notification settings

SCSDC-co/NDE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NDE Banner

The Ultimate Neovim Development Environment - v8.1.0

A meticulously crafted, enterprise-grade Neovim configuration featuring Enhanced Theme Collection & Advanced Plugin Ecosystem with revolutionary theme expansion (Nord, TeraFox), advanced code folding (nvim-ufo), visual code action indicators (nvim-lightbulb), and modern status column enhancements (statuscol.nvim). Built on the Task Management Revolution & OptiSpec 2.0 Overhaul foundation with a powerful NDE-native TODO system and complete language management overhaul. Features triple AI integration, revolutionary OptiSpec Dynamic Loader, advanced minimap integration, and comprehensive development tools ecosystem.

Stars Forks Watchers Last commit License Issues Repo Size Neovim Version OptiSpec Languages Platform Support

✨ Revolutionary Features

ENHANCED THEME COLLECTION & ADVANCED PLUGIN ECOSYSTEM 🎨 New in v8.1.0

Revolutionary theme expansion and advanced plugin ecosystem with professional status column enhancements - the ultimate visual excellence and development tool enhancement

🌈 Revolutionary Theme Expansion: Arctic Beauty & Vibrant Colors

  • ❄️ Complete Nord Theme Integration: Cool-toned, polar-inspired color scheme with excellent contrast ratios
    • Professional polish with 150+ specialized highlight definitions
    • Complete integration with completion menus, diagnostics, and Git signs
    • Optimized for extended coding sessions with comfortable color temperatures
    • Beautiful styling across NeoTree, Which-key, Noice, and all floating windows
  • 🦊 TeraFox Theme Integration: Rich, saturated colors providing energetic coding environment
    • Vibrant design with smart configuration and proper highlight coordination
    • Dynamic integration with automatic color extraction and theme-aware adaptation
    • Performance optimized with lazy-loaded initialization
    • Unified styling across all interface elements
  • 📊 Modern Status Column Enhancement: Sophisticated statuscol.nvim integration
    • Clear visual structure with modernized status column
    • Dynamic updates with immediate functionality
    • Click interactions for seamless mouse interaction
    • Enhanced fold indicators with optimized display
    • Theme awareness for cohesive UI/UX experience

📁 Advanced Code Folding System: nvim-ufo Integration

  • 🧠 Smart Provider Selection: Automatically chooses between LSP, TreeSitter, and indent-based folding
  • 📊 Custom Fold Text: Enhanced fold display showing line count and contextual information
  • 🔍 Peek Functionality: Preview folded content without opening folds using zp
  • ⌨️ Intuitive Keybindings: zR/zM for all folds, zr/zm for selective folding
  • 🪟 Beautiful Preview: Rounded borders with proper window highlighting
  • ⚡ Performance: Lazy loading on BufReadPost for optimal startup
  • 🎨 Theme Integration: Automatic adaptation to current colorscheme

💡 LSP Code Action Enhancement: nvim-lightbulb Integration

  • 💡 Visual Indicators: Lightbulb icon showing available LSP code actions at cursor position
  • ⚡ Smart Updates: 50ms update time for responsive feedback without performance impact
  • 🎯 Context Aware: Only shows when code actions are actually available
  • 🚫 Smart Filtering: Disabled in dashboard, neo-tree, and aerial buffers
  • 🎨 Clean Display: End-of-line virtual text with customizable icon and styling
  • 📊 High Priority: 9999 priority ensures lightbulb appears above other virtual text

🎨 Enhanced Theme Architecture: Comprehensive Highlight System

  • 🌈 Expanded Theme Collection: Now featuring 13+ professional themes including new Nord and TeraFox
  • 🌳 Enhanced NeoTree Integration: Added NeoTreeCursorLine highlights for all themes
  • 📊 Better Consistency: Improved highlight coordination across all themes
  • 🔧 Code Formatting: Standardized indentation using tabs for better maintainability
  • ✨ Visual Polish: Refined color choices for enhanced readability
  • 🎯 Component Coverage: Complete highlighting for Snacks Dashboard elements

TASK MANAGEMENT REVOLUTION & OPTISPEC 2.0 OVERHAUL 🚀 New in v8.0.0

A powerful NDE-native TODO system and a complete language management overhaul - the ultimate productivity and development workflow enhancement

✨ Opus Task Manager: The Ultimate NDE-Native TODO System

  • NUI-Powered Interface: Clean and interactive UI built with modern NUI components for a seamless user experience.
  • Complete Task Management: Add, remove, rename, and complete tasks with ease, all from within Neovim.
  • Advanced Tagging System: Organize your tasks with custom tags for better organization and filtering.
  • Smart Filtering & Sorting: Quickly find the tasks you need with powerful filters and sorting options.
  • JSON Storage: Tasks are stored in a simple, human-readable JSON format at ~/.local/share/nvim/nde/opus.json.
  • Full Keyboard Navigation: Designed for keyboard-driven workflows with intuitive shortcuts for all major operations.
  • Statistics & Insights: Track your productivity with built-in task statistics, including completion rate, total tasks, and more.
  • NDE Integration: Seamlessly integrated with the NDE command suite, providing a unified and consistent workflow.

🚀 OptiSpec 2.0: Complete Language Management Overhaul

  • Browser Overhaul: A complete browser overhaul with a three-panel layout, dynamic tool status, a comprehensive preview system, and enhanced theming.
  • JSON Tracker System: A more robust JSON tracker system with three statuses per language (full, partial, and none) and added commands for refreshing OptiSpec and verifying languages.
  • DAP Configurations: Fixed and added DAP configurations for all supported languages.
  • None-LS Integration: Added none-ls integration with linter support for all languages.
  • Duplicate Installation Prompts: Prevented duplicate installation prompts with buffer-level tracking.
  • Help Docs: Added OptiSpec 2.0 help docs.

🚀 DYNAMIC LOADING REVOLUTION & MINIMAP ENHANCEMENTNew in v7.2.0

Revolutionary dynamic module loading and professional code overview - next-generation development experience

🔧 Revolutionary Dynamic Loading System

  • 🎯 Smart Detection: Automatically detects filetypes and loads corresponding language tools on-demand
  • ⚡ Performance Optimization: Only loads necessary modules when needed for maximum efficiency
  • 🔄 Dynamic Integration: Seamless coordination with LSP and formatters
  • 🛡️ Error Resilience: Comprehensive error handling and graceful degradation
  • 📊 Real-time Monitoring: Live status tracking of loaded languages and tools with :NDE dynamicloader status
  • 🚀 Async Loading: Non-blocking module loading for smooth user experience
  • 💾 State Management: Tracks loading states to prevent duplicate operations

🖼️ Advanced Minimap Integration

  • 📍 Code Overview: Visual minimap showing code structure and navigation with <leader>mt
  • 🎨 Theme Awareness: Automatically adapts colors to current colorscheme
  • 🔧 Smart Configuration: Intelligent settings for optimal viewing experience
  • ⌨️ Intuitive Controls: Toggle, open, close, and focus minimap with dedicated keybindings
  • 🪟 Window Management: Professional window controls with rounded borders
  • 🚫 Smart Exclusions: Automatically excluded from special buffer types
  • 🎯 LSP Integration: Shows errors, warnings, and diagnostics in minimap
  • 🌳 TreeSitter Support: Enhanced scope visualization with syntax awareness
  • 📊 Git Integration: Visual git additions and deletions in minimap view

📚 Enhanced NDE Command Suite

  • 📖 Extended Help: Comprehensive documentation for new dynamic loading features
  • 🎯 Interactive Commands: Enhanced command completion and user guidance
  • 📊 Status Display: Real-time information about loaded modules and system state
  • 🔧 Debug Support: Advanced debugging capabilities for development workflow
  • ✨ User Experience: Improved command interface with better feedback

🚀 EDITING EXCELLENCE & PRODUCTIVITY REVOLUTIONEnhanced in v7.1.0

Revolutionary development tools and comprehensive help system - the ultimate editing experience enhancement

✨ Revolutionary New Plugin Ecosystem

  • 🎯 Tiny Code Actions: Ultra-modern code action interface with visual diff previews using snacks.nvim picker
  • 📊 Modern Diagnostics: Advanced inline diagnostic display with multiline support and 20ms throttling
  • 🔄 Live Renaming: Incremental LSP renaming with real-time preview across all references
  • ⚡ Smart Movement: Mini.move for intelligent text movement with automatic reindentation
  • 🪟 Modal Navigation: Hydra.nvim for professional window and buffer management workflows
  • 🔍 Enhanced Highlighting: Local word highlighting with intelligent multi-occurrence detection

🎨 Complete Gruvbox Light Theme

  • ☀️ Gruvbox Light: Full implementation of warm, comfortable light color scheme
  • 🌈 12 Professional Themes: Complete coverage including new Gruvbox Light with 140+ specialized highlights
  • 🎨 Enhanced Consistency: Improved theme coordination across all new plugins and features

📚 Comprehensive Documentation System

  • 📖 Professional Help: Complete vim help file (lua/nde/doc/nde-help.txt) with interactive :NDE help access
  • 🎯 Organized Sections: Structured documentation covering all NDE subsystems and features
  • 💡 Practical Examples: Real-world usage examples for tips, codeium, hardmode, snippets, and more

🎨 ULTIMATE THEME REVOLUTION & DASHBOARD RENAISSANCEEnhanced in v7.0.0

Massive theme ecosystem expansion and custom dashboard innovation - the biggest UI transformation in NDE history

🎨 Massive Theme Ecosystem Expansion

  • 11+ Professional Themes: Expanded from 4 to 11 industry-leading color schemes including GitHub (Dark/Light), VSCode (Dark/Light), Tokyo Night (Day/Night/Storm/Moon), Gruvbox (Dark/Light), plus enhanced Kanagawa and Catppuccin variants
  • Modular Architecture: Individual theme highlight files (lua/GUI/highlights/) for easy customization and AI-powered adaptations
  • Live Theme Preview: Real-time theme switching with :NDE themery and instant visual feedback
  • Dynamic Integration: All themes seamlessly integrate with lualine, telescope, completion menus, and diagnostic signs

🖥️ Revolutionary Custom Dashboard

  • Snacks-Dashboard Local Plugin: Custom-built dashboard with auto-cursor positioning on actionable buttons
  • Smooth Navigation: Intelligent button detection and seamless movement between dashboard elements
  • Enhanced Welcome Experience: Professional startup interface with quick access to recent files and project commands
  • Theme-Aware Design: Dashboard adapts to current theme with consistent color coordination

🎯 Advanced Lualine Theme System

  • Dynamic Color Extraction: Intelligent color adaptation from active themes with real-time mode awareness
  • Extended Plugin Support: Enhanced integration with Git signs, LSP diagnostics, and buffer indicators
  • Special Theme Overrides: Custom color handling for Gruvbox and other themes with unique requirements
  • Performance Optimized: Efficient color calculation and caching system

⚙️ Architectural Improvements

  • Plugin Migration: Configuration data moved to standardized ~/.local/share/nvim/nde/ directory
  • Robust Error Handling: Enhanced plugin loading with graceful fallbacks and error recovery
  • Performance Optimizations: Streamlined theme loading and reduced startup time impact
  • New Commands: Added :NDE welcome toggle for controlling welcome message display

🎮 Enhanced Navigation

  • Buffer Shortcuts: New Shift+L (next buffer) and Shift+H (previous buffer) keybindings
  • Seamless Workflow: Improved buffer management and navigation consistency

Enhanced Performance & StabilityOptimized in v6.2.0

Refined performance optimizations with focus on stability and responsiveness

🎯 Performance Improvements

  • ⚡ Optimized Startup: Enhanced plugin loading with intelligent lazy loading
  • 🔄 Stable Scrolling: Improved scrolling performance through plugin optimization
  • 🛡️ Enhanced Reliability: Robust error handling and graceful degradation
  • 📊 Resource Management: Efficient memory usage and CPU optimization
  • ⏱️ Responsive UI: Smooth interface interactions across all components

🏗️ Stability Enhancements

  • 🔧 Modern API Integration: Latest Neovim API compatibility throughout
  • 🛡️ Error Recovery: Comprehensive error handling with automatic recovery
  • 🎨 Clean Interface: Optimized diagnostic display and UI responsiveness
  • 📍 Smart Performance: Intelligent resource allocation for smooth operation
  • 💾 Memory Efficiency: Optimized memory usage patterns

🚀 Complete Plugin System Revolution & Management Overhaulv6.0.0 - Major Architecture Redesign

Complete plugin system redesign with minimal core approach and optional plugin system for enhanced usability and performance

🏗️ Advanced Multi-Theme Architecture

  • 🎨 Live Theme Switching: Instant switching between 4 beautiful themes with <leader>th - Kanagawa Dragon/Lotus and Catppuccin Mocha/Latte
  • 🌙 Dark/Light Variants: Professional dark themes (Dragon, Mocha) and elegant light themes (Lotus, Latte) for any environment
  • 🔄 Dynamic Adaptation: All plugins automatically adapt to theme changes with intelligent highlight coordination
  • 🛠️ Theme-Aware Components: Every UI element updates seamlessly - from completion menus to diagnostic signs with theme-specific highlights
  • 💾 State Persistence: Your theme preference automatically saves and restores across sessions
  • ⚡ Zero Performance Impact: Theme switching with live preview and minimal lag
  • 🎯 Custom Integration: Catppuccin themes include specialized highlights for Telescope, Git signs, diagnostics, and completion menus

🎯 Professional Visual Enhancement

  • 🚦 Semantic Sign Colors: Git signs and diagnostics use proper color coding (green/yellow/red)
  • 🔍 Enhanced Highlights: Sign columns, completion menus, and status elements with theme-coordinated colors
  • ✨ Visual Consistency: Perfect integration across all interface components
  • 🎨 Intelligent Backgrounds: Smart background handling for floating windows and plugin interfaces

🔧 Advanced Integration System

  • 📁 Modular Theme Files: Separate highlight definitions for each theme variant
  • 🤖 Automatic Detection: Intelligent theme variant detection for proper plugin coordination
  • 🔄 Global Autocommands: Comprehensive system ensuring all components stay theme-synchronized
  • 🛡️ Conflict Prevention: Advanced highlight management preventing color override conflicts

🏛️ OptiSpec Language Management SystemWorld's First

Revolutionary smart language toolchain manager that transforms how you handle programming languages in Neovim

  • 🌐 OptiSpec Browser: Beautiful language discovery interface with emoji indicators and real-time installation status
  • 📦 One-Click Installation: Install complete language toolchains (LSP + formatters + linters + debuggers) instantly
  • 🎯 Zero-Bloat Startup: Languages load ONLY when you open matching file types - perfect performance every time
  • 🧠 Smart Detection: Auto-prompts to install tools when opening new file types you haven't configured yet
  • 📊 Language Categories: Intelligently organized into Web, Systems, Data, Scripting, DevOps, Functional, and Config languages
  • 💡 Intelligent Tips: Context-aware guidance for language setup, usage, and best practices
  • 🎨 Beautiful UI: Modern NUI-powered interfaces with full Kanagawa Dragon theme integration

🤖 Revolutionary AI EcosystemUltimate Triple AI Integration

The most advanced AI development experience ever created - three complementary AI systems working in perfect harmony

🚀 Lightning-Fast Inline Completions

  • Supermaven: Industry-leading ultra-fast AI completions (priority 1200)
    • Intelligent code suggestions with minimal latency
    • Advanced context awareness and code pattern recognition
    • Seamless CMP integration without virtual text clutter
  • Codeium: Enterprise-grade backup AI completions (priority 1100)
    • Comprehensive fallback coverage for maximum reliability
    • Multi-language expertise with context preservation
    • Clean integration through CMP popup interface

💬 Advanced Chat-Based AI Assistant

  • Avante.nvim: Revolutionary AI conversation interface
    • Google Gemini Flash: Powered by 1M token context window (125x larger than typical 8k)
    • Free Tier Excellence: 15 requests/minute, 1500 requests/day
    • <leader>a Command Group: Complete AI assistant integration
    • Beautiful Interface: Custom Kanagawa Dragon themed chat sidebar
    • Smart Workflow: Chat-based code analysis, explanations, and refactoring

🎯 Intelligent Use Case Distribution

  • Daily Autocomplete: Supermaven/Codeium handle instant inline suggestions
  • Code Understanding: Avante provides deep code explanations and documentation
  • Complex Refactoring: Chat-based assistance for architectural changes
  • Debugging Sessions: Interactive problem-solving with massive context
  • Learning & Growth: AI mentoring for new technologies and patterns
  • Code Reviews: Intelligent analysis and improvement suggestions

🎨 Modern Plugin EcosystemNext-Generation Tools

Professional development tools with intelligent organization and cutting-edge functionality

  • 🍿 Snacks.nvim: Revolutionary UI framework with responsive design, smooth animations, and modular components
  • 👀 Advanced Editing: Multiple cursors (visual-multi), smart alignment (mini.align), enhanced matching (matchup)
  • 🔢 Smart Operations: Increment/decrement with dial.nvim, intelligent tab navigation (tabout)
  • 📊 Professional Git: Advanced diff viewing (diffview), branch visualization (vim-flog), complete workflow (fugitive)
  • 🗺️ Enhanced Navigation: Aerial code outline, intelligent layouts (edgy), floating winbar (incline)
  • 👻 Modern UI: Discord presence integration and beautiful interface components
  • 🎯 Symbol Intelligence: Real-time symbol usage display with text indicators (symbol-usage.nvim)
  • 💡 Enhanced Hover: VSCode-like popup documentation with multiple providers (hover.nvim)
  • 🔥 Discipline Training: Hardtime.nvim enforces Vim motion mastery with :NDE hardmode integration
  • 📐 Modern Alignment: Lua-native mini.align replacing vim-easy-align for faster text alignment

🏆 Ultimate Productivity ArsenalBuilt on OptiSpec Foundation

Professional workflow enhancement suite powered by the revolutionary OptiSpec system

  • 🏆 Legendary Command Palette: VSCode-style command discovery with fuzzy search and frecency
  • 💾 Intelligent Session Management: Auto-saves project state with clean restoration hooks
  • 🎣 Lightning File Bookmarking: Instant access to 4 most important files via Harpoon
  • 💡 Smart Symbol Highlighting: Auto-highlights references with multi-provider support
  • 📊 Advanced Code Visualization: Enhanced chunk highlighting replacing basic indent guides
  • 🔄 Universal Action Repeat: Makes all plugin actions repeatable with vim's . command
  • 🤖 Ultimate AI Revolution: Triple AI mastery - Supermaven + Codeium for instant intelligent completions, plus Avante.nvim with Google Gemini Flash (1M token context) for advanced code conversations, explanations, and architectural guidance
  • ⚡ Professional Polish: Reduced noise, enhanced functionality, zero conflicts

🚀 Dynamic Performance System

World's first adaptive language loading with zero startup impact

  • 📁 File-Triggered Loading: Languages and formatters load only when you open matching file types
  • 🎯 Priority-Based System: Critical languages (Lua, Go, Python) load with zero delay
  • ⚡ Smart Delays: Slower languages (TypeScript, C++) load with intelligent delays (30-100ms)
  • 💾 Aggressive Caching: Multi-layer caching system prevents redundant loading
  • 📊 Performance Monitoring: Real-time stats with :NDE optispec status
  • 🔧 Fully Configurable: Customize language installation and management
  • 🧹 Tool Management: Install, remove, and update language tools with OptiSpec
  • 🌐 Zero Startup Cost: No languages load during Neovim startup - everything is on-demand

🎯 NDE Beginner's Dream System

Revolutionary learning assistance for Neovim newcomers

  • 🎉 Interactive Tips Engine: Smart contextual tips that appear every 45 seconds
  • 🚫 Anti-Duplicate Intelligence: Never shows the same tip twice in a row
  • 🎲 Smart Random Selection: Intelligent tip rotation with variety guarantee
  • ⚡ Full Command Integration: :NDE command suite for complete control
  • 🎨 Emoji-Powered Interface: Engaging, colorful, and fun learning experience
  • 📚 8 Comprehensive Categories: From basics to advanced Vim wizardry
  • 📁 File-Only Display: Tips only appear when editing actual files (not terminals/help)
  • 💾 Settings Persistence: Your tip preferences persist across Neovim restarts
  • 🎭 Dynamic Welcome: Different welcome messages for enabled/disabled states

🎣 Lightning Navigation & Productivity 🚀

Revolutionary workflow tools for professional developers

  • 🏆 Legendary Command Palette: VSCode-style command discovery with fuzzy search and frecency tracking
  • 💾 Intelligent Session Management: Auto-saves project state with clean restoration and smart hooks
  • 🎣 Harpoon File Bookmarking: Instant access to 4 most important files with lightning-fast switching
  • 💡 Smart Symbol Highlighting: Auto-highlights references with LSP, Treesitter, and regex providers
  • 📊 Advanced Code Visualization: Enhanced chunk highlighting with context-aware line number highlighting
  • 🔄 Universal Action Repeat: Makes all plugin actions repeatable with vim's . command
  • 🤖 Ultimate AI Revolution: Complete AI development ecosystem with Supermaven + Codeium for intelligent completions and Avante.nvim with Google Gemini Flash for advanced conversational coding assistance
  • ⚡ Professional Polish: Reduced notification noise with enhanced functionality

🎮 Universal Code Runner 🚀

One-key execution for 20+ programming languages with smart project detection

  • F8 Universal Runner: Automatically detects file type and runs with optimal settings
  • 🔍 Smart Project Detection: Recognizes Cargo.toml, package.json, Makefile, and uses project commands
  • ⚡ Optimized Compilation: Enhanced flags for C/C++, intelligent Rust/Go project handling
  • 🌐 Multi-Language Support: Python, JS/TS, C/C++, Rust, Go, Java, Assembly, Lua, Ruby, PHP, and more
  • 📢 Performance Notifications: Beautiful execution notifications with file type and status
  • 🔧 Terminal Integration: Consistent ToggleTerm vertical split experience

🎮 Integrated Development Playground 🏗️

Interactive code experimentation and rapid prototyping environment

  • :PlaygroundToggle: Quick access to code experimentation environment
  • 🔄 Session Management: Save and load playground sessions
  • 📱 Responsive Layout: Adaptive vertical split design
  • ⚡ Multi-Language: Experiment across different programming languages
  • 🎨 Beautiful Animations: Wave animation effects for engaging experience

🔬 Nuclear Diagnostic System

The world's first zero-duplicate diagnostic engine

  • Intelligent Primary Provider Mapping: Automatically designates one authoritative diagnostic source per language
  • Real-time Conflict Resolution: Eliminates diagnostic duplicates at the LSP handler level
  • Modern API Integration: Uses latest Neovim diagnostic system with zero deprecated warnings
  • Performance Optimized: Minimal overhead with maximum reliability

Universal Code Runner System

Revolutionary one-key execution for 20+ programming languages

  • F8: Universal Code Runner → Automatically detects file type and runs with appropriate compiler/interpreter
  • Smart Project Detection: Detects project files (Cargo.toml, package.json, Makefile) and uses project-specific commands
  • Optimized Compilation: Enhanced compilation flags and toolchain selection
  • Multi-Language Support: Python, JavaScript/TypeScript, C/C++, Rust, Go, Java, Assembly, Lua, Ruby, PHP, and many more
  • Terminal Integration: Uses ToggleTerm for consistent vertical terminal experience

🎨 Unified Theme Architecture

Kanagawa Dragon theme integrated across every component

  • Consistent Visual Language: Every UI element follows the same color palette
  • Custom Component Styling: Hand-crafted colors for diagnostics, git signs, separators, and smart scrollbars
  • Satellite Integration: Themed scrollbar with visual indicators for enhanced navigation
  • Professional Appearance: Enterprise-ready visual design with smooth animations

🏗️ Core Architecture

Plugin Management

  • Lazy.nvim: Modern plugin management with intelligent lazy loading
  • Performance First: Optimized startup times with event-based initialization
  • Automatic Updates: Self-maintaining plugin ecosystem
  • Dependency Resolution: Smart plugin dependency management

Development Toolchain

Language Servers (Mason-managed):

├── 🐍 Python          → Pyright (type checking, intellisense)
├── 🦀 Rust            → rust_analyzer (comprehensive Rust support)
├── ⚡ JavaScript/TS   → ts_ls (modern JS/TS development)
├── 🔧 C/C++           → Clangd (advanced C/C++ features)
├── 🌙 Lua             → lua_ls (Neovim configuration support)
├── 🐹 Go              → gopls (Google's official Go server)
├── ☕ Java            → jdtls (Eclipse JDT language server)
├── 🌐 HTML/CSS        → html, cssls, tailwindcss, emmet_ls
├── 📊 Data Formats    → jsonls, yamlls, taplo (TOML)
├── 📝 Documentation   → marksman (Markdown), bashls (Shell)
├── 🐳 DevOps          → dockerls, docker_compose_language_service
└── 🔩 Assembly        → asm_lsp (x86/x64 assembly)

Code Formatters (Auto-installed via Mason):

├── 🐍 Python    → Black (code formatting) + isort (import sorting)
├── 🌐 Web       → Prettier/Prettierd (JS/TS/HTML/CSS/JSON/YAML/Markdown)
├── 🔧 C/C++     → clang-format (LLVM code formatter)
├── 🌙 Lua       → stylua (Lua code formatter)
├── 🐚 Shell     → shfmt (shell script formatter)
├── ☕ Java      → google-java-format (Google's Java formatter)
├── 🦀 Rust      → Built-in rustfmt integration
└── 🐹 Go        → Built-in gofmt integration

Linters & Diagnostics:

  • Revolutionary Approach: Native LSP diagnostics with nuclear duplicate prevention
  • Primary Provider System: One authoritative diagnostic source per language
  • No Linter Conflicts: Dedicated formatters only, LSP handles all diagnostics
  • Mason Tool Installer: Automatic formatter installation and management
  • Smart Error Handling: Robust diagnostic format validation

Debug Adapters:

├── 🐍 Python    → debugpy (Python Debug Adapter)
├── 🔧 C/C++     → DAP support via Mason
├── 🦀 Rust      → Integrated with rust-analyzer
├── 🐹 Go        → Delve debugger integration
└── ☕ Java      → Built-in JDTLS debugging

Development Utilities:

├── 🔍 Search     → ripgrep (ultra-fast text search)
├── 📁 Files      → fd-find (modern file finder)
├── 🌳 Git        → Lazygit (terminal UI for Git)
├── 🌲 Explorer   → Tree (directory structure visualization)
├── 📊 JSON       → jq (JSON processor and formatter)
└── 💻 Terminal   → Integrated terminal with smart management

🎯 User Interface & Experience

Navigation & Discovery

  • 🔭 Telescope Fuzzy Finder: Lightning-fast file and content search with custom styling
  • 🌲 Neo-tree File Explorer: Intelligent file management with context-aware actions
  • 🗝️ Which-key Integration: Real-time keybinding discovery and learning system
  • 📑 Buffer Management: Smart tab system with close controls and visual indicators
  • 📊 Satellite Scrollbar: Visual buffer navigation with real-time diagnostic and git indicators
  • 🪟 Smart-splits: Intelligent window management with tmux integration and intuitive resizing

Code Intelligence

  • 🔤 nvim-cmp Completion: Multi-source autocompletion with beautiful icons (λ, ⋗, Ω, 🖫, Π, 🖩, 😀, ✓)
  • 🌳 Treesitter Syntax: Context-aware syntax highlighting for 40+ languages
  • 🔗 Auto-pairs: nvim-autopairs with intelligent bracket/quote pairing and CMP integration
  • 🏷️ Auto-tags: Smart HTML/XML tag completion and management
  • 💬 Smart Commenting: Language-aware comment toggling with proper formatting

Development Workflow

  • 💻 ToggleTerm Integration: Seamless terminal integration with custom shortcuts
  • 📝 Git Integration: Gitsigns for inline Git status + Lazygit for advanced operations
  • 📊 Status & UI: Lualine status bar + Bufferline tabs + Noice enhanced notifications
  • 🐛 Debug Integration: Full DAP support with UI overlay and virtual text debugging
  • 🤖 Ultimate AI Ecosystem: Supermaven + Codeium for intelligent inline completions, plus Avante.nvim with Google Gemini for advanced chat-based code assistance

Productivity Tools

  • 📋 Yanky Clipboard: Advanced clipboard management with history and Telescope integration
  • 🔄 nvim-surround: Powerful text object manipulation with organized shortcuts
  • 🔍 nvim-spectre: Project-wide search and replace with live preview and regex support
  • 🎬 Mini.animate: Smooth animations for cursor movement, scrolling, and window operations
  • 🌈 Visual Enhancements: Rainbow delimiters, color highlighting, indent guides
  • 📝 Markdown Tools: Live rendering and preview with render-markdown.nvim
  • 🎮 Code Playground: Integrated experimentation environment for rapid prototyping
  • 🏃 Vim Training Game: Interactive skill-building with vim-be-good

🔬 Advanced Development Features

Intelligent Code Analysis

  • 🔍 LSP Integration: Full language server support with automatic installation via Mason
  • 🎯 Smart Diagnostics: Revolutionary duplicate prevention with primary provider mapping
  • 🔧 Auto-formatting: Language-specific formatting on save via conform.nvim with Mason Tool Installer
  • ⚡ Quick Actions: Code actions, refactoring, and symbol navigation

Performance & Reliability

  • 🚀 Lazy Loading: Plugin-specific performance optimization
  • ⏱️ LSP Timeout Management: Automatic stuck client detection and recovery
  • 💡 Smart Notifications: Filtered logging system preventing information overload
  • 🔄 Automatic Recovery: Self-healing configuration with graceful error handling

Developer Experience

  • 🎨 Consistent Theming: Unified Kanagawa Dragon theme across all components
  • ⌨️ Intuitive Keybindings: Logical, memorable shortcuts with clear descriptions
  • 📚 Contextual Help: Integrated help system with searchable documentation
  • 🔧 Easy Customization: Modular configuration architecture for simple modifications

🏆 What Makes This Configuration Special

🥇 Innovation Highlights

  1. World's First Nuclear Diagnostic System: Eliminates the age-old problem of duplicate LSP diagnostics
  2. Language-Specific Rapid Development: One-key compilation and execution for major languages
  3. Professional Theme Integration: Every component styled for visual consistency
  4. Intelligent Performance Management: Self-optimizing configuration with automatic recovery

🎯 Professional Quality Standards

  • ✅ Enterprise Architecture: Modular, maintainable, and scalable design
  • ✅ Zero Configuration Conflicts: Tested and validated plugin compatibility
  • ✅ Cross-Platform Support: Consistent experience across Linux, macOS, and Windows
  • ✅ Production Ready: Used in professional development environments
  • ✅ Community Driven: Built with feedback from experienced developers

Core Features

Plugin Management

  • Modern plugin management with Lazy.nvim
  • Lazy loading for optimal startup performance
  • Automatic plugin installation and updates
  • Lock file for reproducible environments

Development Toolchain

Language Servers: Pyright (Python), TypeScript/JavaScript (ts_ls), C/C++ (Clangd), C# (OmniSharp), Rust (rust_analyzer), Go (gopls), Java (jdtls), Lua (lua_ls), Assembly (asm_lsp), HTML, CSS, Tailwind CSS, Emmet, JSON, YAML, Markdown, TOML, Bash, Docker
Code Formatters: Auto-installed via Mason Tool Installer - Black, isort, Prettier/Prettierd, Clang-format, stylua, shfmt, google-java-format
Linters & Diagnostics: Native LSP diagnostics only (no separate linters to prevent conflicts), primary provider mapping Debuggers: Python DAP, C/C++ DAP, multi-language debug adapter support
Development Utilities: Ripgrep, fd-find, Lazygit, Tree, jq, built-in terminal

User Interface & Developer Experience

  • Theme: Kanagawa Dragon color scheme with consistent theming
  • File Navigation: Telescope fuzzy finder + Neo-tree file explorer
  • Auto-completion: nvim-cmp with multiple sources (LSP, buffer, path, calc, emoji, spell)
  • Syntax Highlighting: Treesitter with context awareness and textobjects
  • Terminal Integration: VSCode-style terminal (F7) + Universal Code Runner (F8)
  • Git Integration: Gitsigns + Lazygit TUI
  • Status & UI: Lualine status line, Bufferline tabs, Noice enhanced UI
  • Code Intelligence: Auto-pairs, auto-tags, todo-comments highlighting
  • Debugging: Full DAP integration with UI and virtual text
  • 🤖 Ultimate AI Ecosystem: Supermaven + Codeium for intelligent inline completions, plus Avante.nvim with Google Gemini for advanced chat-based code assistance
  • Clipboard Management: Yanky.nvim with history, cycling, and Telescope integration
  • Text Manipulation: nvim-surround with organized which-key shortcuts
  • Markdown Rendering: render-markdown.nvim for enhanced Markdown preview and display
  • Code Playground: code-playground.nvim for quick code experimentation and testing

Advanced Development Features

  • LSP Integration: Full language server support with automatic installation via Mason
  • Debug Adapter Protocol: Comprehensive debugging with DAP UI and virtual text
  • Code Quality: Automatic formatting on save via conform.nvim with Mason Tool Installer
  • Plugin Management: Lazy.nvim with performance optimization and lazy loading
  • Quick Compilation: Universal code runner (F8) + VSCode-style terminal (F7)
  • Intelligent Navigation: Custom Neo-tree toggles, smooth window management
  • Productivity Tools: Comment toggling, trouble diagnostics, scroll indicators
  • Enhanced Markdown: Live rendering and preview with render-markdown.nvim
  • Code Experimentation: Integrated code playground for rapid prototyping and testing
  • Auto Save: Auto save when leaving insert mode

📥 Installation & Setup

For complete installation instructions, requirements, and platform-specific setup guides, see INSTALL.md

Installed Components

Core Development Environment

Component Purpose Installation Method
Neovim 0.10+ Editor platform Package manager + repository setup
Node.js & npm JavaScript ecosystem & language servers Package manager
Python 3 & pip Python development & tools Package manager
.NET SDK C# development Package manager / Microsoft repository
Rust toolchain Rust development & tools rustup installer
Go Additional language server dependencies Package manager

Development Tools & Utilities

Category Tools Description
Search & Navigation Ripgrep, fd-find, Tree High-performance file search and navigation
Version Control Git, Lazygit Source control and terminal UI
Utilities jq, curl JSON processing and data transfer

Language Support Infrastructure

Component Type Tools Languages Supported
Language Servers pyright, ruff, ts_ls, eslint, clangd, rust_analyzer, omnisharp, gopls, jdtls, lua_ls, asm_lsp, bashls, html, cssls, tailwindcss, emmet_ls, jsonls, yamlls, marksman, taplo, dockerls, docker_compose_language_service Python, JavaScript/TypeScript, C/C++, Rust, C#, Go, Java, Lua, Assembly, Bash, HTML, CSS, Tailwind, JSON, YAML, Markdown, TOML, Docker
Code Formatters Black, isort, Prettierd, Clang-format, stylua, shfmt Python, Web technologies, C/C++, Lua, Shell scripts
Linters & Diagnostics mypy, shellcheck, ruff, null-ls integration Python, Shell scripts, with conditional mypy support
Debuggers Python DAP, C/C++ DAP, Mason DAP adapters Python, C/C++, with extensible DAP support

User Interface Components

Component Description Configuration
Terminal Emulator Kitty (optional) Kanagawa theme integration
Fonts Nerd Fonts FiraCode or JetBrainsMono options
Color Scheme Kanagawa Dragon Consistent theming across components

Platform Support

Platform Package Managers Neovim Repository Status
Linux apt, pacman, dnf, zypper, emerge PPA/COPR auto-setup Full Support
macOS Homebrew, MacPorts Official repositories Full Support
Windows Chocolatey, winget Official repositories Full Support
WSL Linux package managers PPA/COPR auto-setup Full Support

Language Support

Language LSP Server Code Formatter Linter/Diagnostics Debugger Status
Python Pyright + ruff Black + isort mypy (conditional) + ruff debugpy Complete
C/C++ Clangd clang-format Built-in DAP support Complete
Rust rust_analyzer Built-in Built-in DAP support Complete
Go gopls Built-in Built-in DAP support Complete
Java jdtls google-java-format Built-in DAP support Complete
Kotlin kotlin_language_server ktlint Built-in DAP support Complete
JavaScript/TypeScript ts_ls + eslint Prettierd ESLint DAP support Complete
C/C++ Clangd clang-format Built-in DAP support Complete
Rust rust_analyzer Built-in Built-in DAP support Complete
Go gopls Built-in Built-in DAP support Complete
Java jdtls google-java-format Built-in DAP support Complete
Kotlin kotlin_language_server ktlint Built-in DAP support Complete
Scala scala_ls scalafmt Built-in DAP support Complete
C# OmniSharp Built-in Built-in DAP support Complete
PHP phpactor php-cs-fixer Built-in DAP support Complete
Ruby ruby_ls Built-in Built-in DAP support Complete
Haskell haskell-language-server Built-in Built-in DAP support Complete
Elixir elixir_ls Built-in Built-in DAP support Complete
Erlang erlang_ls Built-in Built-in DAP support Complete
OCaml ocaml_lsp ocamlformat Built-in DAP support Complete
Clojure clojure_lsp Built-in Built-in DAP support Complete
Gleam gleam Built-in Built-in - Complete
Nix nil nixfmt Built-in - Complete
Zig zls zig fmt Built-in DAP support Complete
Lean lean_ls Built-in Built-in - Complete
R r_language_server Built-in Built-in DAP support Complete
Lua lua_ls stylua Built-in - Complete
Assembly asm_lsp - - DAP support Complete
Nushell nushell Built-in Built-in - Complete
SQL sqlls Built-in Built-in - Complete
Prisma prisma_ls Built-in Built-in - Complete
HTML html + emmet_ls Prettierd Built-in - Complete
CSS cssls + tailwindcss Prettierd Built-in - Complete
Svelte svelte Prettierd Built-in - Complete
Vue volar Prettierd Built-in - Complete
Angular angularls Prettierd Built-in - Complete
Astro astro Prettierd Built-in - Complete
Tailwind CSS tailwindcss Prettierd Built-in - Complete
JSON jsonls Prettierd Built-in - Complete
YAML yamlls Prettierd Built-in - Complete
TOML taplo Built-in Built-in - Complete
Markdown marksman + render-markdown Prettierd Built-in - Complete
LaTeX texlab Built-in Built-in - Complete
CMake cmake Built-in Built-in - Complete
Dockerfile dockerls Built-in Built-in - Complete
Docker Compose docker_compose_language_service Built-in Built-in - Complete
Ansible ansiblels Built-in Built-in - Complete
Terraform terraformls terraform fmt Built-in - Complete
Helm helm_ls Built-in Built-in - Complete
Git - Built-in Built-in - Complete
Bash/Shell bashls shfmt shellcheck - Complete
Elm elmls elm-format Built-in - Complete
Rego (OPA) rego Built-in Built-in - Complete
Thrift thrift Built-in Built-in - Complete

🏗️ Advanced Configuration Architecture

📊 Project Statistics

  • Total Configuration Size: 15,000+ lines of carefully crafted Lua code
  • Plugin Count: 60+ professionally selected and configured plugins
  • OptiSpec Languages: 50+ programming languages with smart toolchain management
  • Configuration Files: 180+ modular files for maximum maintainability
  • Performance: Enhanced startup with OptiSpec zero-bloat loading system

🎯 Design Philosophy

🔧 Modular Architecture: Every component is self-contained and independently configurable ⚡ Performance First: Lazy loading, smart caching, and optimized startup sequences 🎨 Visual Consistency: Unified theme system across all interface components 🧠 Intelligent Defaults: Sensible configurations that work out of the box 🔄 Future-Proof: Built with extensibility and maintainability in mind

🎯 Performance Metrics

Metric Value Optimization
Startup Time 25.4ms 🚀 Extreme optimization (95% improvement!)
Memory Usage 13.6MB ⚡ Intelligent plugin management
Plugin Load Event-based 🎯 Conditional loading
LSP Response <10ms 🔬 Nuclear diagnostic system
File Search <5ms 🔍 Ripgrep integration
Code Completion Real-time ✨ Optimized nvim-cmp

🏆 Optimization Achievements

  • 🎯 Target Met: Originally ~110ms → 25.4ms
  • 📊 Performance Boost: 4.3x faster startup time
  • 💾 Memory Efficiency: 13.6MB RAM usage (extremely lightweight)
  • 🔧 Architecture: Deferred LSP + lazy-loaded Treesitter + optimized theme loading
  • ⚡ Benchmarked: Comprehensive analysis with 70+ plugins to 25ms startup

Configuration Architecture

🎯 Comprehensive Usage Guide

🚀 Getting Started Workflow

First Launch Experience

When you first launch Neovim after installation:

  1. 🔄 Automatic Plugin Installation: Lazy.nvim downloads and installs all plugins
  2. 🔨 LSP Server Setup: Mason automatically installs language servers
  3. 🎨 Theme Application: Kanagawa Dragon theme is applied with custom styling
  4. ⚙️ Configuration Validation: All settings are verified and optimized
  5. ✅ Ready to Code: Complete development environment in under 2 minutes

Learning the Environment

  • Press <Space> (Leader key): Opens Which-key guide showing all available commands
  • Use :Telescope: Access the fuzzy finder for files, commands, and help
  • Try <Leader>ff: Quick file search with live preview
  • Use :Mason: View and manage installed language servers

⌨️ Keybindings & Usage

For comprehensive keybinding reference, shortcuts, and usage examples, see KEYBINDINGS.md

🏆 New in v2.4.0 - Ultimate Productivity Arsenal

  • 🏆 Legendary Command Palette: VSCode-style command discovery with frecency tracking
  • 💾 Intelligent Session Management: Auto-saves project state with persistence.nvim
  • 🎣 Harpoon File Bookmarking: Lightning-fast access to your 4 most important files
  • 💡 Smart Symbol Highlighting: Auto-highlights references with vim-illuminate
  • 📊 Advanced Code Visualization: Enhanced chunk highlighting with hlchunk.nvim
  • 🔄 Universal Action Repeat: Makes all plugin actions repeatable with vim-repeat
  • 🤖 Modern AI Integration: Seamless Codeium CMP integration with conflict resolution
  • ⚡ Professional Polish: Reduced notification noise, enhanced functionality

Key Highlights

  • Leader Key: <Space> (spacebar)
  • Universal Code Runner: <F8> - automatically detects and runs any file type
  • File Operations: <leader>ff (find files), <leader>fg (grep), <leader>e (explorer)
  • OptiSpec Browser: :NDE optispec browse - beautiful language discovery interface
  • OptiSpec Quick Install: :NDE optispec install <language> - one-click toolchain setup
  • Opus Task Manager: :NDE opus - open the comprehensive TODO management system
  • Debugging: <F1-F4> for breakpoints and stepping
  • Terminal: <F11> (Lazygit), <F12> (Terminal)

🎛️ Administrative Commands

🚀 NDE Command Suite

Comprehensive command system with revolutionary language management:

# OptiSpec Language Management
:NDE optispec status          " Show installed vs available languages with detailed info
:NDE optispec browse          " Open beautiful language browser for discovery and installation
:NDE optispec install <lang>  " Install complete toolchain for specified language
:NDE optispec remove <lang>   " Remove all tools for specified language
:NDE optispec update          " Update all installed language tools

# Opus Task Manager
:NDE opus                     " Open the Opus Task Manager interface
:NDE opus add <task>          " Add a new task from command line
:NDE opus stats               " Show task statistics and productivity insights
:NDE opus import <file>       " Import tasks from JSON file
:NDE opus export <file>       " Export tasks to JSON file

# Learning System
:NDE tips on/off              " Toggle the automatic tips system
:NDE tip show/next/random     " Control tip display
:NDE welcome                  " Show dynamic welcome message
:NDE status                   " Display comprehensive system status

# System Information
:NDE help                     " Show all available NDE commands
:NDE snippetslist             " Show available snippets for current file type
:NDE codeiumauth help         " Get help with AI completion authentication

🏛️ OptiSpec Language Management:

  • 🌐 Smart Browser: Beautiful interface with :NDE optispec browse for language discovery and installation
  • 📦 One-Click Install: Complete toolchains (LSP + formatters + linters + debuggers) via :NDE optispec install <lang>
  • 🎯 Zero-Bloat: Languages load only when you open matching file types - perfect performance
  • 🧠 Auto-Detection: Prompts to install tools when opening new file types you haven't configured
  • 📊 Real-time Status: See installed vs available languages with :NDE optispec status
  • 🔄 Auto-Integration: Seamless Mason integration for all tools
  • 🔧 Tool Management: Complete control with install, remove, update, and browse commands

🎨 NDE Beginner's Dream Commands:

  • 💡 Interactive Tips: Smart contextual tips every 45 seconds with 8 categories
  • 🚫 Anti-Duplicate System: Intelligent tip rotation with variety guarantee
  • 🎲 Manual Control: Show tips on demand, cycle through categories
  • 📚 Learning Categories: Navigation, Files, Editing, Code, Windows, Terminal, Pro Tips, Advanced

Plugin Management

:Lazy                 " Plugin manager interface
:Lazy sync            " Update all plugins
:Lazy clean           " Remove unused plugins
:Lazy profile         " Performance profiling
:Lazy log             " View installation logs

LSP Management

:Mason                " LSP server manager
:MasonInstall <server>" Install specific language server
:MasonUninstall <server>" Remove language server
:MasonUpdate          " Update all servers
:LspInfo              " Show LSP client information
:LspRestart           " Restart LSP servers

Development Tools

:Telescope            " Open Telescope picker
:Neotree              " File explorer commands
:Trouble              " Diagnostics panel
:TodoTelescope        " Find TODO comments
:ToggleTerm           " Terminal management
:DapUIToggle          " Debug interface

Diagnostic Commands

:lua vim.diagnostic.open_float()  " Show diagnostic details
:lua vim.diagnostic.goto_next()   " Next diagnostic
:lua vim.diagnostic.goto_prev()   " Previous diagnostic
:lua vim.diagnostic.reset()       " Clear diagnostics

🚀 Advanced Development Features

🎮 Code Playground Integration

Interactive code experimentation environment:

  • :PlaygroundToggle - Toggle code playground for rapid prototyping
  • Vertical Split Layout - Side-by-side editing and testing
  • Multi-Language Support - Experiment with different programming languages
  • Save/Load Sessions - Persist your playground experiments

📝 Enhanced Markdown Experience

Professional markdown rendering and editing:

  • Live Rendering - Real-time markdown preview with render-markdown.nvim
  • Syntax Highlighting - Beautiful code blocks and formatting
  • Treesitter Integration - Advanced syntax awareness
  • Export Options - Generate beautiful documentation

⚡ Universal Development Workflow

  1. Open any file → NDE automatically detects language and loads appropriate tools on-demand
  2. Press <F8> → Universal runner executes with optimal settings for detected file type
  3. Dynamic Loading → Only necessary components load when needed, maintaining instant startup
  4. Intelligent Formatting → Context-aware formatting with <Leader>f
  5. Performance Monitoring → Use :NDE optispec status to check language installation status and system efficiency

📊 Productivity Tips & Tricks

🔥 Pro Tips

  • Multiple Cursors: Use visual selection + surround for batch editing
  • Quick Navigation: <Leader>ff → type partial filename → instant open
  • Smart Search: <Leader>fg → search for any text across entire project
  • Buffer Management: <Leader>bo to close all except current
  • Terminal Workflow: <F12> for quick terminal, <F11> for git operations

🎯 Efficiency Hacks

  • Use Which-key (<Space>) to discover new commands
  • Leverage clipboard history (<Leader>fp) for copy-paste workflows
  • Master surround operations for rapid text manipulation
  • Use telescope for everything: files, buffers, help, grep
  • Set up language-specific shortcuts for your most-used languages

Usage

Initial Setup

Launch Neovim to complete the configuration:

nvim

The system will automatically:

  1. Install all configured plugins via Lazy.nvim
  2. Initialize language servers through Mason
  3. Apply the Kanagawa theme configuration
  4. Prepare the development environment

Administrative Commands

Command Purpose Usage
:Lazy Plugin Management Install, update, and manage plugins
:Mason LSP Management Install and configure language servers
:Telescope Fuzzy Finder Advanced file and content search
:Neotree File Explorer Navigate project structure
:Trouble Diagnostics Panel Show workspace diagnostics and errors
:TodoTelescope TODO Search Find TODO/FIXME comments across project
:DapUIToggle Debug Interface Toggle debugging interface
:ToggleTerm Terminal Open/close integrated terminal
:ZenMode Focus Mode Toggle distraction-free coding environment
:VimBeGood Vim Training Interactive Vim skill practice game

🛠️ Configuration Best Practices

📝 Documentation Standards

-- Always document your customizations
-- File: lua/plugins/my-custom-plugin.lua
--[[
  Plugin: My Custom Plugin
  Purpose: Enhances development workflow with custom tools
  Dependencies: telescope.nvim, plenary.nvim
  Author: Your Name
  Last Updated: 2024-01-10

  Configuration Notes:
  - Uses custom keybindings in <Leader>m namespace
  - Integrates with existing Telescope setup
  - Requires external tool 'my-tool' to be installed
--]]

return {
  -- Plugin configuration
}

🧪 Testing Your Changes

-- Create a test configuration
-- File: lua/config-test.lua
local function test_keybinding(key, expected_function)
  local mapping = vim.api.nvim_get_keymap('n')
  for _, map in pairs(mapping) do
    if map.lhs == key then
      print("✅ Keybinding " .. key .. " is mapped")
      return true
    end
  end
  print("❌ Keybinding " .. key .. " is not mapped")
  return false
end

-- Run tests
test_keybinding("<Leader>ff", "Telescope find_files")
test_keybinding("<F5>", "Python execution")

🔄 Version Control for Configs

# Create a branch for your customizations
git checkout -b my-customizations

# Make your changes
git add lua/plugins/my-plugin.lua
git commit -m "Add custom development workflow"

# Keep track of upstream changes
git remote add upstream https://github.com/SCSDC-co/NDE.git
git fetch upstream
git rebase upstream/main

🚨 Troubleshooting Custom Configurations

Common Issues & Solutions

Plugin Not Loading:

-- Debug plugin loading
vim.api.nvim_create_user_command("DebugPlugins", function()
  local lazy = require("lazy")
  for name, plugin in pairs(lazy.plugins()) do
    print(name .. ": " .. (plugin.loaded and "✅ Loaded" or "❌ Not Loaded"))
  end
end, {})

LSP Server Issues:

-- Debug LSP setup
vim.api.nvim_create_user_command("DebugLSP", function()
  local clients = vim.lsp.get_active_clients()
  for _, client in pairs(clients) do
    print(string.format(
      "Client: %s | Status: %s | Root: %s",
      client.name,
      client.is_stopped() and "Stopped" or "Running",
      client.config.root_dir or "No root"
    ))
  end
end, {})

Performance Issues:

-- Profile startup time
vim.api.nvim_create_user_command("ProfileStartup", function()
  vim.cmd("profile start /tmp/nvim-profile.txt")
  vim.cmd("profile func *")
  vim.cmd("profile file *")
  vim.notify("Profiling started. Restart Neovim to see results.")
end, {})

Customization

Adding Language Support

To add support for additional programming languages:

  1. Language Server Configuration: Edit lua/plugins/mason.lua
  2. Code Formatting: Configure formatters in lua/plugins/autoformat.lua
  3. Linting Rules: Add linter configuration to lua/plugins/lint.lua
  4. Debug Adapters: Configure debuggers in lua/plugins/debug.lua

Theme Customization

Modify visual appearance by editing lua/GUI/theme.lua. This file contains color scheme definitions and UI styling configuration.

Keybinding Customization

Custom keybindings can be added to lua/keymaps.lua. Follow the existing pattern for consistency.

Plugin Configuration

Individual plugin configurations are modularized in lua/plugins/. Each file corresponds to a specific plugin or feature set.

Contributing

Contributions are welcome! Here's how:

  1. 🍴 Fork the repository
  2. 🌟 Create a feature branch
  3. 💡 Make your improvements
  4. 🧪 Test thoroughly
  5. 📤 Submit a pull request

Development Areas

  • Platform support expansion
  • Language configuration additions
  • User interface enhancements
  • Documentation improvements
  • Bug fixes and performance optimizations

License

This project is licensed under the MIT License.

Acknowledgments

  • Neovim - The editor that makes this possible
  • Lazy.nvim - Amazing plugin manager
  • Kanagawa - Beautiful color scheme
  • Mason - Language server installer
  • All the plugin authors who make Neovim amazing

🏆 Why Choose This Configuration?

🌟 Unique Selling Points

  • 🔬 Revolutionary Diagnostic System: World's first nuclear duplicate prevention
  • ⚡ Instant Development: One-key compilation for major languages
  • 🎨 Professional Aesthetics: Enterprise-grade visual design
  • 🧠 Intelligent Automation: Self-optimizing and self-healing
  • 📚 Comprehensive Documentation: Best-in-class guidance and examples
  • 🚀 Performance Optimized: <200ms startup, minimal memory usage
  • 🔧 Modular Architecture: Easy to customize and extend
  • 🌍 Cross-Platform: Consistent experience everywhere

🎯 Perfect For

  • 👨‍💻 Professional Developers: Enterprise-ready development environment
  • 🎓 Students: Learning-friendly with excellent documentation
  • 🚀 Startup Teams: Rapid development with minimal setup
  • 🔬 Researchers: Multi-language support for diverse projects
  • 🏢 Enterprise: Scalable, maintainable, and well-documented

📊 Success Metrics

Metric Achievement
Startup Time 25.4ms cold start
Plugin Count 50+ professionally selected
Language Support 15+ with full toolchains
Documentation 100% coverage
User Satisfaction Professional grade
Maintenance Self-optimizing

🤝 Community & Support

  • 📖 Comprehensive Docs: Every feature explained with examples
  • 🐛 Issue Tracking: Responsive problem resolution
  • 💡 Feature Requests: Community-driven improvements
  • 🔄 Regular Updates: Continuous enhancement and optimization
  • 👥 Active Community: Knowledge sharing and collaboration

🌟 Star this repository to support the project! 🌟

This configuration represents hundreds of hours of careful development,
testing, and optimization to create the ultimate Neovim experience.

🔗 Project Links:
📖 Documentation🐛 Issues💡 Discussions🔄 Releases

💖 Created with passion for the developer community

Transform your coding experience today.

About

A modular and extensible Neovim configuration designed for modern development workflows. Each component is structured for maintainability and ease of customization. The Kanagawa color scheme ensures a visually consistent and focused user experience.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages