🚀 CodeBoarding – Abstract Code Visualization

CodeBoarding helps you visualize and navigate your codebase effortlessly. Gain instant clarity with interactive, abstract visual maps generated directly from your code.

Note: CodeBoarding is actively in development. We'd love your suggestions or feedback! Connect with us at contact@codeboarding.org or submit via our feedback form.

🤝 Join Our Community

🌟 Features

• Abstract Code Map: Get a high-level, easy-to-understand overview of your entire codebase.
• Interactive Exploration: Click and dive deeper into your components to understand relationships and structures.
• Clear Descriptions: Automatically generated, concise explanations of your components.
• Direct Code Links: Seamlessly jump from visual nodes to your source code for ultimate clarity.
• Context for AI Tools: Enhance your AI coding assistants with rich context from your codebase, by copying components or entire maps to your clipboard.
• Realtime Component Change tracking: Monitor your agent's actions by seeing which components have file edits in them.

🔒 Data Privacy

Your security and privacy matter.

• Local Processing: Code analysis and graph creation occur locally on your machine.
• Secure API Calls: Data sent directly to Gemini API; we never see or store your information.

✅ Requirements

• VSCode
• A codebase you want to analyze
• For Java projects: Java 21 or later must be installed (Download here)

📌 Release Notes

Stay updated as we continuously improve CodeBoarding.

0.9.5 (Current version)

• Cancel Button Restored - The cancel button is back — you can now stop a running analysis at any time.
• Reliable Logging - Fixed an issue where logs could be incomplete or missing during analysis.
• Subcomponent Expansion After Analysis - Expanding components after running a new analysis now works correctly without requiring a reload.
• Binary Download Flexibility - Fixed binary downloads so you can continue using an older version of CodeBoarding without being forced to update.
• Smoother Setup Without NPM - If npm isn't installed, CodeBoarding now attempts to install it automatically and provides a clear error if it can't, instead of failing silently.

0.9.4

• Live Warning Updates - Code quality warnings now refresh automatically when you save files or make changes, so your health indicators always stay current.
• Fit to Screen for Components - Expanded components can now be fitted to your screen for a focused, distraction-free view.
• OpenRouter API Support - Access 100+ models (Claude, GPT, Gemini, Mistral, and more) through a single OpenRouter API key.
• More Windows Fixes - Resolved an issue where analysis on Windows hangs .
• Smarter Run Button — The run button now shows which analysis depth is selected (e.g. "Overview"). Pick a depth from the dropdown and it becomes the new default and runs immediately — no extra click needed.
• Redesigned Toolbar Layout — Run and Refresh are now in the top-left, zoom controls in the top-right, and the Help hint in the bottom-left for a cleaner, less cluttered diagram view.
• Improved Help Overlay — Press H to see a quick reference for all toolbar buttons and diagram interactions, with the actual icons shown inline.

0.9.3

• Windows Fix - Resolved an issue where analysis could fail on Windows due to character encoding errors.

0.9.2

• Copy as Mermaid - Export your diagram as Mermaid code directly from the context menu for easy sharing and documentation.
• Modifications Tab - New dedicated tab in the side panel showing all file modifications mapped to components, with modification icons on nodes.
• Save Annotations with Ctrl/Cmd+S - Save component annotations instantly with a keyboard shortcut.
• In-Webview Analysis Controls - Run and refresh buttons are now embedded directly in the diagram view for quicker access, and automatically disabled while analysis is running.

0.9.1

• Help Key Interference - Pressing "H" while typing in text fields no longer accidentally opens the help overlay.
• Smoother Diagram Updates - When expanding components or making changes, only the affected parts of your diagram update instead of redrawing everything. This means less visual disruption and faster interactions.

0.9.0

• Major UI Refactor - Complete frontend architecture redesign with smoother user experience, faster refreshes and more flexible panel placement. You can now move the panel to any side of the editor.
• Unified Analysis Output - All analysis results now consolidated into a single analysis.json file for easier management and portability
• Diagram Precision Improvements: The diagrams have a higher quality thanks to a better default model.
• Analyzed Files Summary: The analysis overview now documents which files are part of the analysis and which ones are ignored.
• Modifications Summary: You can now see a summary of all modifications made to the codebase and how they map to your architecture diagram.
• Warnings Summary: Explore and fix all warnings in all components via the new warnings overview panel.

0.8.1

• Export Diagram as Image - Export your current diagram as a PNG image directly from the toolbar or context menu.
• Component Annotations - Add personal notes to any component in the details panel. Annotations persist across sessions.
• Smarter Context Copying - Granular control over what gets copied: description, annotation, highlighted code, and source files with line-range awareness.
• Improved Unused Code Detection - Categorized unused code findings (variables, imports, functions, parameters) replacing generic orphan code detection, powered by LSP diagnostics.
• Faster & Parallelized Analysis - Static analysis steps now run in parallel with improved caching for significantly faster results.
• Expanded LLM Support - Added prompt templates for DeepSeek, GLM, and Kimi model families.
• Windows Stability - Uses VSCode's own Node.js process for reliable binary execution across platforms.

0.8.0

• Iterative/Incremental Analysis - Expand components in-place to explore subgraphs while keeping the high-level view. Dramatically faster updates by analyzing only impacted flows.
• Health Checks & Code Quality Warnings - Automatic detection of code quality issues including:
  • Dead/orphan code (unreachable functions)
  • Oversized functions (god functions)
  • Circular dependencies between packages
• Interactive Component Expansion - Click to expand components directly in the diagram or use the "Full View" button for deeper analysis.
• Health Warning Indicators - Visual badges on nodes showing warning counts with detailed findings in the details panel.
• Improved Static Analysis - Fixed bugs in clustering algorithms (Leiden), performance optimizations, and better reference validation.

0.7.1

• Improved accuracy - added a validation step with the static analysis.
• Static analysis caching - avoids recalculating the CFG.

0.7.0

• Added support for Java - Full support for visualizing Java projects
• .codeboardingignore support - Filter out unwanted files and directories with a simple ignore file
• Improved Generation - Faster and higher quality in-depth component analysis
• CodeBoarding Pro - Unlimited generation plan available

0.6.1

• Vercel API Integration - Added support for Vercel API key configuration for enhanced AI model access
• Improved Diagram Accuracy - Enhanced diagram generation algorithm for more precise component relationships and visualization
• Faster Generation - Optimized analysis pipeline for significantly reduced diagram generation time

0.6.0

• Detailed Analysis Mode - New option to run comprehensive three-level analysis for deeper insights
• Configurable Analysis Depth - Control the depth of analysis to balance detail and execution time
• Advanced Clustering - Smarter code organization using multiple clustering algorithms (Louvain, Leiden, greedy modularity) for better component grouping, especially for small codebases
• Faster Static Analysis - Reduced single file analysis time from 6 minutes to 1 minute for quicker feedback
• Updated AI Models - Upgraded to Claude 3.0 Flash and 2.5 Flash for better analysis quality
• Analysis Timeouts - Set timeout limits for LLM calls to prevent unbounded execution and hours-long hangs
• Proper node_modules exclusion - Fixed issue where node_modules were being analyzed, significantly reducing analysis time and improving accuracy
• Ignore Derivative Files - Now properly excludes minified and bundled files (.min.js, .bundle.js) from analysis
• Enhanced Logging - Cleaner, more organized logs with reduced redundancy

0.5.0

• Wait view during analysis - Added a loading view with progress indication while analysis is running
• Maximize button - New button to maximize the diagram view for better visualization
• Improved logs - Enhanced logging for better debugging and troubleshooting
• Theme colors fix - Fixed theme color issues for better consistency with VSCode themes

0.4.0

• Added extension settings - Configure your preferred API keys and model directly in VSCode settings
• Current component highlighting - The active component is now highlighted based on the currently open file
• UI improvements: Fixed the "Fit to Screen" button for better diagram navigation

0.3.3

• Fixed handling of modified files with non-unique names
• Improved file matching algorithm for better accuracy

0.3.2

• Added support for PHP - Now supporting PHP projects in addition to Python, JavaScript/TypeScript, and Go
• Stability updates

0.3.1

• Improved Python dependency handling (pyright is now a VSCode dependency)
• Enhanced analytics with version/platform metadata
• Added lifecycle events tracking (start/cancel/success/fail)

0.3.0

• Local development configuration improvements
• Enhanced debugging capabilities for extension development

0.2.10

• Improved UI clarity — diagram edges no longer overlap with nodes or other edges
• General UI refinements to improve readability during diagram navigation

0.2.9

• Enhanced Static Analysis algorithm
• Stabilized and made diagram generation more deterministic
• Updated on-boarding information for new users in our UI
• Now built for Visual Studio Code 1.99+ (Cursor compatible)

0.2.8

• Stability updates.
• Minimal anonymized analytics: we collect only non-identifying metadata (timestamp, anonymized user_id and repo, language, lines, file extension, exit_code, short stdout/stderr previews and lengths, platform) to help us fix issues. No source code or file contents are sent, nor any sort of personal information.

0.2.7

• Added support for GO
• Fully anonymous analytics which send us number of lines analyzed in what programming stack with an annoynmoys id.

0.2.4

• Stability updates and bug fixes for Windows and TypeScript
• Better error handling for missing/not-found TypeScript configuration files.

0.2.2

• Stability updates and bug fixes around state selection
• Fixed bug for TypeScript on MacOS

0.2.0

• Initial release featuring core abstract visualization capabilities
• Support for Python and JavaScript/TypeScript projects
• Supported on Windows, Linux, and macOS.
• Integrated with and using Gemini 2.5-flash

🎉 Enjoy exploring your code with CodeBoarding!