CodeCohesion

Visualize code cohesion and architectural evolution

Open-source 3D visualization tool for analyzing code structure, detecting bounded contexts, and watching your codebase evolve over time

View Live Demo

Interactive 3D timeline showing repository evolution with cohesion analysis

What Makes CodeCohesion Unique?

3D Spatial Visualization

Solar system metaphor for intuitive architecture understanding

Live Timeline Playback

Watch your codebase evolve commit-by-commit

Cohesion Analysis

Detect bounded contexts through temporal coupling

DDD-Focused

Built for Domain-Driven Design and monolith decomposition

Open Source

Free, transparent, extensible

Browser-Based

No installation, runs anywhere

Why Use CodeCohesion?

The Problem

Understanding code architecture and cohesion is hard. Where are your bounded contexts? Which files are tightly coupled? How did your architecture evolve to its current state?

The Solution

CodeCohesion turns git history into an interactive 3D visualization that reveals:

Cohesion Patterns - Which files belong together (bounded contexts)
Coupling Hotspots - Files that change together frequently
Architecture - Hierarchical structure at a glance
Evolution - How your codebase grew and changed over time
Ownership - Who works on what parts of the code

Use Cases

DDD & Bounded Contexts

Discover natural domain boundaries through cohesion analysis

Monolith Decomposition

Identify where to split based on temporal coupling

Developer Onboarding

Give new team members a visual architectural tour

Retrospectives

Watch timeline playback of how features evolved

Technical Debt

Find legacy hotspots and coupling issues

Features

Core Visualization

Solar System Layout - Directories as planets, files as moons
Hierarchical Focus Mode - Drill down while maintaining context
Adaptive Sizing - File size represents lines of code
Smart Spacing - Automatic layout prevents overlap

Interactive Exploration

Orbit Controls - Drag to rotate, scroll to zoom
Click Navigation - Click directories to focus
Hover Highlighting - See file relationships
Smooth Camera - Stable framing without resets

Git Metadata

File Type color mode - 50+ extensions
Last Modified mode - Adaptive time buckets
Author mode - Consistent colors per contributor
Timeline playback with speed controls
Filter by author, file type, date range

Technology

TypeScript 5.0 + React + Three.js
Node.js ≥18 required
Browser-based, no backend
MIT licensed, fully open source

Getting Started

Visit the GitHub repository for detailed installation instructions and documentation

Try Live Demo GitHub

License: MIT - Free to use, modify, and distribute

Inspired by Gource for evolution visualization and CodeScene for behavioral code analysis