I rebuilt the archived repo-visualizer as a zero-dependency, theme-aware codebase map

Описание и применение

repocarto – это инструмент, генерирующий SVG‑карты репозитория без зависимостей, автоматически адаптирующиеся к светлой и тёмной теме GitHub.

Задача

The original repo-visualizer was archived, leaving a gap for a lightweight, theme-aware codebase map tool that could be easily integrated into README files without external dependencies.

Результат

repocarto delivers a deterministic, theme-aware SVG codebase map with zero dependencies, reducing git diff noise and simplifying README integration.

Рабочий процесс

• 1. Run npx repocarto (optionally with -o to specify output path).
• 2. The tool walks the repository respecting .gitignore.
• 3. It generates a single SVG where each file is a circle sized by lines of code, colored by language, and nested by folder structure.
• 4. The SVG uses @media (prefers-color-scheme) to switch background and text colors for light/dark themes.
• 5. Optionally use the provided GitHub Action to regenerate and commit the map only when the code changes.

Доказательства

repocarto is built and maintained by me — I read and act on its issues and PRs myself.

Источник

It walks your repo (respecting .gitignore), and writes a single SVG where every file is a circle — size = lines of code, color = language, nesting = folders.

Источник