DEV Community

ViewGit
ViewGit

Posted on

Visualize Your Git Repository as a 3D City

What if you could walk through your codebase like a city?

I built ViewGit, a CLI tool that transforms any Git repository into an interactive 3D visualization. Each file becomes a building — taller buildings mean more complex code, and colors represent different programming languages.

How it works

Install ViewGit with a single command:

curl -fsSL https://viewgit.com/install.sh | bash
Enter fullscreen mode Exit fullscreen mode

Then navigate to any Git repo and run:

viewgit .
Enter fullscreen mode Exit fullscreen mode

That's it. ViewGit analyzes the entire repository and opens a web dashboard at localhost:8880 with the 3D visualization and 38 other analysis modules.

What the 3D city tells you

  • Tall buildings = files with high complexity (cyclomatic complexity, lines of code)
  • Colors = programming language (JavaScript = yellow, TypeScript = blue, etc.)
  • Neighborhoods = directory structure
  • Outliers = files that tower over everything else are candidates for refactoring

Beyond 3D: What else ViewGit shows you

The 3D city is just one of 39 analysis modules. You also get:

  • Dashboard with commit activity, stats, and commit calendar
  • Contributors analysis with bus factor and knowledge distribution
  • Hotspots — files that change most often AND are most complex
  • Language distribution with code vs comments ratio
  • Timeline showing how the codebase evolved
  • AI Chat — ask questions about your code using OpenAI, Anthropic, or Gemini

Try it on your repo

ViewGit is free to download and works on macOS, Linux, and Windows.

curl -fsSL https://viewgit.com/install.sh | bash
cd /path/to/your/repo
viewgit .
Enter fullscreen mode Exit fullscreen mode

Share what your codebase city looks like in the comments!

Website: viewgit.com

Top comments (0)