ProjectAtlas

# 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:

View Complete Changelog

Stay updated with the latest features, improvements, and bug fixes

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

1. Install from VS Code Marketplace

   Ctrl+P → ext install MantejSingh.projectatlas
   

2. Or install from Command Line

   code --install-extension MantejSingh.projectatlas

3. 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.0+ (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

Performance

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:

� View Complete Changelog

Stay updated with the latest features, improvements, and bug fixes

Contributing

We welcome contributions!

Read the Contributing Guide | Basic Instructions | Architecture Docs

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

---