# 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
