Atlas

Google Maps for Software Architecture

Atlas is a VS Code extension for exploring modern codebases through interactive architecture maps, dependency visualization, route discovery, and generated documentation.

Features

• Architecture graph for pages, APIs, services, repositories, databases, external services, and supporting modules.
• Dependency visualization powered by static import analysis.
• Route discovery for supported web frameworks.
• Database detection for Prisma and common database access patterns.
• Documentation generation to .atlas/docs/ARCHITECTURE.md.
• Insights for circular dependencies, orphan modules, and highly coupled files.
• Optional AI explanations through the configured provider.

Screenshots

Architecture Overview

Dependency Graph

Routes

Activity Bar

Installation

Install Atlas from the VS Code Marketplace after publishing, or package it locally:

npm run package

Then install the generated .vsix file with VS Code's "Install from VSIX..." command.

Commands

• Atlas: Analyze Repository scans the current workspace and saves .atlas/architecture.json.
• Atlas: Open Architecture Map opens the interactive architecture map.
• Atlas: Generate Documentation writes .atlas/docs/ARCHITECTURE.md.
• Atlas: Trace User Flow opens the map focused on inferred flow data.
• Atlas: Show Dependency Graph opens the dependency graph view.
• Atlas: Export Architecture JSON exports the current architecture graph.
• Atlas: Export Diagram exposes diagram-ready graph data.

Configuration

{
  "atlas.aiProvider": "mock",
  "atlas.moonshotApiKey": "",
  "atlas.moonshotModel": "moonshot-v1-8k",
  "atlas.privacy.enableAI": false,
  "atlas.excludePatterns": [
    "**/node_modules/**",
    "**/.next/**",
    "**/dist/**"
  ]
}

• atlas.aiProvider: AI provider used for optional explanations. Defaults to mock.
• atlas.moonshotApiKey: Moonshot API key when Moonshot is enabled.
• atlas.moonshotModel: Moonshot model name.
• atlas.privacy.enableAI: allows summarized architecture context to be sent to the configured AI provider.
• atlas.excludePatterns: additional glob patterns excluded from analysis.

Privacy

Atlas static analysis runs locally. Repository files are scanned on your machine to build the architecture graph. No code leaves your machine unless atlas.privacy.enableAI is enabled and a non-mock AI provider is configured.

Read the full privacy policy at PRIVACY.md.

Supported Frameworks

• Next.js
• React
• NestJS
• Express
• Prisma

Roadmap

• Architecture Diff
• Timeline View
• Monorepo support
• Software City (3D mode)