MapMyRepo: Any Codebase as an Interactive Knowledge Graph

AI products · Creator, sole engineer · live

Understanding an unfamiliar repository means reading a file tree that tells you nothing about relationships, then opening files one at a time. Neither the structure nor the purpose of a codebase is visible from a directory listing.

Open: https://mapmyrepo.siddhvasudev.com

How it works

A file explodes into its functions and classes; an optional token lifts GitHub’s rate limit.

  • GitHub URL → Repo tree
  • Repo tree → D3 force graph
  • Repo tree → Gemini
  • D3 force graph → Ask a node
  • Gemini → Ask a node

The detail

MapMyRepo turns a repository or an entire profile into an interactive force-directed graph where every file and folder is a node. A force layout rather than a tree is deliberate: a tree shows hierarchy, a force layout shows coupling, which is the more useful signal when assessing architecture.

Each node gets an AI-generated architectural summary on demand rather than for the whole repository up front, which is what makes it affordable on a large codebase. A per-node chat panel answers questions with that file's context and its neighbours supplied, so answers are specific rather than generic.

Public repositories load with no authentication at all; an optional token raises rate limits and unlocks private repositories.

React 19, TypeScript, D3.js, Google Gemini, Vite.

What I did

  • Built the repository parser, noise filter and force-directed graph renderer
  • Chose a force layout over a tree deliberately to surface coupling rather than hierarchy
  • Implemented on-demand per-node AI summarisation to keep cost viable on large repositories
  • Built the contextual chat panel supplying node metadata and neighbours
  • Made public repositories work with no authentication, with an optional token for private access

Stack

React, TypeScript, D3.js, AI Agent Development, Gemini, Graph Visualization, GitHub API

Case study: https://www.siddhvasudev.com/projects/mapmyrepo