ProjectAtlas
## What's New in ## What's New in v0.2.6
Git Integration • Test Coverage • Quality Trends • Team Analytics • CI/CD • Custom Metrics
The Enterprise Analytics Update - Professional-grade insights for development teams!
Git Integration • Test Coverage • Quality Trends • Team Analytics • CI/CD • Custom Metrics
The Enterprise Analytics Update - Professional-grade insights for development teams!
src="media/icon.png" alt="ProjectAtlas Logo" width="120" height="120" />
The Ultimate Workspace Navigator
**Unified, offl## Changelog
For detailed release notes, version history, and feature updates, please see:
ce atlas for VS Code — documents, diagrams, workflows, directories, symbols & call graphs in one interactive panel.**
What is ProjectAtlas?
ProjectAtlas transforms your VS Code into a powerful workspace navigator that consolidates multiple tools into one seamless experience. No more juggling between different extensions for documentation, diagrams, and code analysis!
🆕 What's New in v0.2.6!
� Git Integration • 📊 Test Coverage • 📈 Quality Trends • 👥 Team Analytics • 🚀 CI/CD • � Custom Metrics
The Enterprise Analytics Update - Professional-grade insights for development teams!
Key Features
Git Integration New in 0.2.6
- Branch analysis with detailed statistics
- Commit history parsing and visualization
- Merge conflict detection and tracking
- Team collaboration insights
- Repository health monitoring
|
Test Coverage New in 0.2.6
- LCOV & Jest report parsing
- Interactive coverage reports
- File-level analysis with recommendations
- Threshold monitoring and alerts
- Coverage improvement suggestions
|
Quality Trends New in 0.2.6
- Historical tracking of code metrics
- Technical debt monitoring
- Quality scoring with alerts
- Trend analysis over time
- Automated quality recommendations
|
Team Collaboration New in 0.2.6
- Multi-developer workspace insights
- Code ownership analysis
- Specialization tracking by developer
- Collaboration patterns visualization
- Team productivity metrics
|
CI/CD Integration New in 0.2.6
- Pipeline analysis (GitHub Actions, GitLab CI, Jenkins)
- Build success rate monitoring
- Deployment tracking and metrics
- Health scoring for pipelines
- Multi-platform CI/CD support
|
Custom Metrics New in 0.2.6
- User-defined metrics framework
- Built-in templates for common patterns
- Threshold alerts and notifications
- Dashboard configuration tools
- Extensible analysis system
|
Smart Documentation
- Markdown rendering with syntax highlighting
- Live Mermaid diagram support
- GitHub Actions workflow visualization
- Real-time preview with theme sync
|
Enhanced UI & Search Updated in 0.2.6
- Tabbed interface with 6 analytics views
- Keyboard shortcuts (7-9, 0, -, = keys)
- Real-time updates with auto-refresh
- Export functionality (JSON/CSV formats)
- Professional dashboard design
|
Interactive Graphs
- Directory trees with click-to-navigate
- Symbol extraction for TypeScript/JavaScript
- Call graphs and dependency mapping
- Force-directed graph layouts
|
Analytics & Metrics Enhanced in 0.2.6
- Code quality metrics across languages
- Performance monitoring with memory tracking
- Dependency analysis with visualization
- Enhanced diagnostics with severity levels
- Multi-language support for symbol analysis
|
Enterprise Analytics Suite
ProjectAtlas v0.2.6 introduces a comprehensive analytics suite designed for professional development teams:
Professional Dashboard
- 6 specialized tabs for different analytics views
- Real-time data updates with configurable refresh
- Interactive visualizations with drill-down capabilities
- Export functionality for reporting and analysis
Deep Code Insights
- Historical quality tracking with trend analysis
- Technical debt monitoring and recommendations
- Coverage gap identification with improvement paths
- Team productivity metrics and collaboration insights
DevOps Integration
- Multi-platform CI/CD support (GitHub Actions, GitLab CI, Jenkins, Azure DevOps)
- Build pipeline health scoring and optimization
- Deployment frequency and success rate tracking
- Custom metrics framework for organization-specific KPIs
Navigation Shortcuts
Access any analytics view instantly with keyboard shortcuts:
Ctrl/Cmd + 7
: Git Integration
Ctrl/Cmd + 8
: Test Coverage
Ctrl/Cmd + 9
: Quality Trends
Ctrl/Cmd + 0
: Team Collaboration
Ctrl/Cmd + -
: CI/CD Integration
Ctrl/Cmd + =
: Custom Metrics
Quick Start
Installation
Install from VS Code Marketplace
Ctrl+P → ext install MantejSingh.projectatlas
Or install from Command Line
code --install-extension MantejSingh.projectatlas
Launch ProjectAtlas
Ctrl+Shift+P → "ProjectAtlas: Open"
That's it! ProjectAtlas will automatically analyze your workspace and present an interactive overview.
Supported File Types & Features
Content Type |
Capability |
Details |
Markdown |
Live Preview + Mermaid |
Syntax highlighting, fenced code blocks, inline diagrams |
Mermaid |
Theme-aware Rendering |
Flowcharts, sequence diagrams, automatic light/dark mode |
GitHub Actions |
Workflow Visualization |
Job dependency graphs, YAML parsing, live monitoring |
TypeScript/JS |
Symbol Extraction |
Functions, classes, imports, call graphs via ts-morph |
Python |
Symbol Analysis ⭐ New |
Classes, functions, imports with enhanced metrics |
JSON/YAML |
Structure Analysis |
Configuration files, workflow definitions, data validation |
Directories |
Interactive Trees |
Folder/file navigation, search filtering, click-to-open |
All Files |
Search & Export ⭐ New |
Real-time search, CSV/JSON export, analytics |
Usage Examples
Visualize Your Codebase
// ProjectAtlas automatically detects and maps:
export class DataProcessor {
process(data: UserData): ProcessedData {
return this.transform(data);
}
}
// → Creates interactive symbol graph with call relationships
Advanced Search & Filtering New in 0.2.5
# Search across your entire workspace:
"function getData" # Find all functions containing "getData"
"*.test.ts" # Filter to test files only
"TODO" # Find all TODO comments
"import React" # Locate React imports
Export Your Data New in 0.2.5
// Export workspace analysis to JSON
{
"files": 147,
"symbols": 523,
"dependencies": 34,
"metrics": {
"codeQuality": 8.7,
"testCoverage": 85.2,
"complexity": "low"
}
}
// → Perfect for CI/CD integration and reporting
GitHub Actions Workflows
# .github/workflows/ci.yml
name: CI
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
# → Automatically visualized as dependency graph
Live Mermaid Diagrams
```mermaid
graph TD
A[Start] --> B{Decision}
B -->|Yes| C[Action 1]
B -->|No| D[Action 2]
```
# → Renders immediately with theme sync
Configuration
ProjectAtlas works out of the box, but you can customize it:
{
"projectAtlas.enableStatusBar": true,
"projectAtlas.showWelcomeOnStartup": true,
"projectAtlas.autoRefresh": true,
"projectAtlas.refreshInterval": 30000,
"projectAtlas.enableNotifications": true,
"projectAtlas.exportFormat": "json"
}
Configuration Options Enhanced in 0.2.5
Setting |
Default |
Description |
enableStatusBar |
true |
Show ProjectAtlas in status bar |
showWelcomeOnStartup |
true |
Display welcome screen on first use |
autoRefresh |
false |
Enable automatic data refresh ⭐ New |
refreshInterval |
30000 |
Auto-refresh interval in milliseconds ⭐ New |
enableNotifications |
true |
Show status notifications ⭐ New |
exportFormat |
"json" |
Default export format (json/csv) ⭐ New |
Commands
Command |
Description |
Shortcut |
ProjectAtlas: Open |
Launch the main panel |
Ctrl+Shift+P |
New in Version 0.2.5
Advanced Search & Filtering
- Real-time search across all workspace data
- Smart filtering by file types, symbols, and content
- Instant results with highlight matching
Export & Analytics
- Export to JSON/CSV for external analysis
- Code metrics dashboard with quality indicators
- Performance monitoring with memory and timing data
- Dependency graphs with interactive visualization
Enhanced User Experience
- Auto-refresh functionality with customizable intervals
- Keyboard shortcuts for power users:
Ctrl/Cmd+R
- Refresh data
Ctrl/Cmd+E
- Quick export
Ctrl/Cmd+1-6
- Switch between tabs
- Loading progress indicators for better feedback
- Notification system for status updates
- Modern design with smooth animations
UI Improvements
- Responsive design that adapts to all screen sizes
- Enhanced color scheme with better contrast
- Interactive elements with hover effects
- Status indicators for real-time data freshness
Pro Tip: Add ProjectAtlas to your activity bar or create a custom keybinding for instant access!
Keyboard Shortcuts New in 0.2.5
ProjectAtlas now supports powerful keyboard shortcuts for enhanced productivity:
Shortcut |
Action |
Description |
Ctrl/Cmd+R |
Refresh |
Instantly refresh all workspace data |
Ctrl/Cmd+E |
Export |
Quick export current view to JSON/CSV |
Ctrl/Cmd+F |
Search |
Focus on search input for filtering |
Ctrl/Cmd+1 |
Overview |
Switch to overview tab |
Ctrl/Cmd+2 |
Analysis |
Switch to analysis tab |
Ctrl/Cmd+3 |
Performance |
Switch to performance tab |
Ctrl/Cmd+4 |
Diagnostics |
Switch to diagnostics tab |
Ctrl/Cmd+5 |
Dependencies |
Switch to dependencies tab |
Ctrl/Cmd+6 |
Export |
Switch to export tab |
Tips:
- Use
Ctrl+R
for quick data refresh without mouse clicks
- Combine
Ctrl+E
with tab switching for rapid exports
Ctrl+F
+ search terms for lightning-fast filtering
Architecture
**Technical Details**
ProjectAtlas uses a modern architecture:
- Extension Host (Node.js) - File watching, symbol extraction, VS Code API
- Webview (React + Vite) - Interactive UI, graph rendering, live updates
- Message Bridge - Type-safe communication between host and webview
- Incremental Updates - Patch-based system for performance
Symbol Providers:
- TypeScript/JavaScript:
ts-morph
AST parsing
- Future: Python, Go, Java, C# providers planned
Requirements
- VS Code 1.85.0 or higher
- Node.js 18.x or 20.x (for development)
- Operating System: Windows, macOS, or Linux
Themes & Customization
ProjectAtlas automatically adapts to your VS Code theme:
- Light themes → Clean, minimal interface
- Dark themes → Sleek, modern appearance
- Custom themes → Automatic color scheme detection
Metric |
Value |
Description |
Bundle Size |
~10MB |
All dependencies included (offline) |
Startup Time |
<2s |
Cold start to interactive |
Memory Usage |
<50MB |
Typical workspace analysis |
Update Speed |
<100ms |
Incremental symbol updates |
Search Speed |
<50ms |
Real-time filtering results ⭐ New |
Export Speed |
<1s |
JSON/CSV generation ⭐ New |
📋 Changelog
For detailed release notes, version history, and feature updates, please see:
Contributing
We welcome contributions!
Quick Development Setup
git clone https://github.com/Drago-03/ProjectAtlas.git
cd ProjectAtlas
npm install && npm run build
# Press F5 in VS Code to launch Extension Development Host
License
This project is licensed under the MIT License - see the LICENSE file for details.
Star us on GitHub | Report Issues | Request Features