RepoAtlas v0.2.1 Released on npm•Explore v0.2.1 Specs

Transform Any Repository Into Visual Art

The standard developer platform for repo structure visualization. Generate interactive tree diagrams, Markdown docs, Mermaid charts, and LLM context summaries in milliseconds.

npm i -g @repoatlasdev/cli

Try Live Playground GitHub

100,000+

Files Scanned / sec

13+

Export Formats

Theme Renderers

100%

Open Source

bash — repo-atlas-cli

➜~/my-repo$repo-atlas generate --theme vscode --sort size

Generate VSCode-styled tree sorted by file size

my-awesome-app
├── 📁 apps
│   ├── 📁 docs
│   │   ├── 📋 package.json (1.3 KB)
│   │   └── 📘 next.config.mjs (850 B)
│   └── 📁 web (4.2 MB)
├── 📁 packages
│   ├── 🔷 core (1.8 MB)
│   └── 🎨 renderers (950 KB)
└── 📝 README.md (3.4 KB)

Engineered For Enterprise Repositories

Built according to strict SOLID principles, pure functions, zero mutable global state, and maximum performance.

High-Throughput Engine

Asynchronous recursive scanner capable of processing repositories with over 100,000+ files in sub-millisecond execution times.

Multi-Theme Renderers

Render tree structures in VSCode, Material, Unicode, Nerd Font, ASCII, Markdown, JSON, and Mermaid formats out of the box.

13+ Exporter Plugins

Export repository trees to Markdown, HTML, JSON, YAML, XML, CSV, DOCX, PDF, SVG, PNG, Mermaid, and PlantUML diagrams.

AI Context Compression

Compress repo structures into token-optimized LLM prompts for ChatGPT, Claude 3.5, and Gemini Pro architecture analysis.

Smart .gitignore Parsing

Automatically respects `.gitignore` rules, `.ignore` patterns, node_modules, and custom exclusion filters.

VSCode & GitHub Actions

Seamlessly generate and auto-commit `PROJECT_STRUCTURE.md` in CI/CD pipelines or visualize in VS Code Explorer context menus.

High Precision Themes

Visual Aesthetics That Impress

Choose from curated presets matching your terminal, documentation site, or IDE setup.

VSCode Theme

Popular

Icon Pack: VSCode Icons

my-project
├─ 📁 apps
│  ├─ 📋 package.json
│  └─ 🌐 index.html
└─ 📁 packages
   └─ 🔷 core.ts

Material Design

Vibrant

Icon Pack: Material Theme

my-project
├── 📁 apps
│   ├── 📋 package.json
│   └── 🌐 index.html
└── 📁 packages
    └── 🔷 core.ts

Unicode Tree

Default

Icon Pack: Emoji Pack

my-project
├── 📂 apps
│   ├── 📋 package.json
│   └── 🌐 index.html
└── 📂 packages
    └── 🔷 core.ts

Nerd Fonts

Terminal Pro

Icon Pack: Nerd Font Glyphs

my-project
├── 📁 apps
│   ├──  package.json
│   └──  index.html
└── 📁 packages
    └──  core.ts

Markdown Doc

Docs Ready

Icon Pack: Clean Text

- 📁 **my-project**
  - 📂 **apps**
    - 📋 **package.json**
  - 📂 **packages**
    - 🔷 **core.ts**

Mermaid Diagram

Diagrams

Icon Pack: Flowchart

graph TD
  my_project["my-project"] --> apps["apps"]
  apps --> package_json["package.json"]
  my_project --> packages["packages"]
  packages --> core_ts["core.ts"]

Interactive Generator

CLI Command & Config Builder

Customize options visually and instantly generate CLI flag combinations or `repo-atlas.config.json` specifications.

Options & Flags

Theme Preset

Icon Pack

Max Scan Depth (4)

Sorting Strategy

Display File Sizes (`--show-size`)Respect .gitignore (`--gitignore`)

CLI Command Line

$ repo-atlas generate --theme vscode --icons emoji --depth 4 --sort name -o PROJECT_STRUCTURE.md

📄 repo-atlas.config.json

{
  "theme": "vscode",
  "iconPack": "emoji",
  "maxDepth": 4,
  "sort": "name",
  "only": "all",
  "showSize": false,
  "respectGitIgnore": true,
  "outputFile": "PROJECT_STRUCTURE.md"
}

Live Interactive Playground

Test RepoAtlas Engine Live

Change themes, icon packs, exporters, and view instant live rendering updates powered by the core TypeScript engine.

Preset Repository

Theme Preset

Icon Pack

Mode / Exporter

Display File Sizes

Live Preview•RepoAtlas Monorepo

└─ 📁 RepoAtlas
   ├─ 📁 apps
   │  ├─ 📁 cli
   │  │  ├─  package.json
   │  │  └─ 📁 src
   │  ├─ 📁 docs
   │  │  ├─  package.json
   │  │  └─ 📄 next.config.mjs
   │  └─ 📁 vscode
   │     └─  package.json
   ├─ 📁 packages
   │  ├─ 📁 core
   │  ├─ 📁 renderers
   │  ├─ 📁 exporters
   │  └─ 📁 icons
   ├─  package.json
   ├─  README.md
   └─ 📄 pnpm-workspace.yaml

IDE & CI Integration

VSCode Extension & GitHub Action

Generate structures directly inside VS Code Explorer context menus or automatically update `PROJECT_STRUCTURE.md` in CI workflows on every git push.

Install VSCode Extension GitHub Action Setup

# .github/workflows/structure.yml

name: Update Project Structure
on:
  push:
    branches: [ main ]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: repoatlasdev/github-action@v0.2.1
        with:
          auto_commit: true
          generate_mermaid: true

Open Source & Community Driven

RepoAtlas is an open-source standard for codebase visualization.

Phase 1 (Completed)

Core Engine & Exporters

100,000+ files scanner, 13 exporter plugins, 8 theme renderers, CLI, and VS Code extension.

Phase 2 (Active)

Interactive Web App & Docs

Next.js App Router live playground, command builder, and interactive documentation suite.

Phase 3 (Upcoming)

AI Architecture Summarizer

Automated repository architecture diagrams, folder explanations, and vector context embeddings.

Ready to Visualize Your Codebase?

Get started in under 10 seconds. Install the CLI or try out the live web playground.

Open Live Playground View GitHub Repository