How aryan1718/git-map works
GIT-MAP turns a public GitHub repository into an interactive code knowledge graph. A user opens a repository URL; the backend fetches a commit’s supported files, extracts and normalizes symbols and references, builds graph data, and serves graph views. The React frontend provides the landing and repository-view experience, while the API also exposes chunked Discovermap responses. The main analysis path is visible in the sampled routes and services; the wiring of the unsampled static visualization is not shown, so that connection is omitted.
Main entry points: routes.py Repository analysis · Graph.jsx Repository view · github.py GitHub client · Home.jsx Landing page
Components 16
User experience
- Landing page
frontend/src/pages/Home.jsx - GitHub URL parser
frontend/src/utils/parseGithubUrl.js - Repository view
frontend/src/pages/Graph.jsx - Graph canvas
frontend/src/components/RepoGraphCanvas.jsx
API and orchestration
- FastAPI app
app/main.py - API routes
app/api/routes.py - Repository analysis
app/api/routes.py - Memory cache
app/core/cache.py
Repository analysis
- GitHub client
app/services/github.py - Symbol extraction
app/services/repomap.py - Symbol normalization
app/services/semantic_normalizer.py - Graph builder
app/services/graph_builder.py
Graph representations
- Discovermap adapter
app/services/discovermap_adapter.py - Embedded graph view
app/static/index.html
Other components
- Repository explorer
- GitHub API
Connections 17
- Repository explorer → Landing page: opens
- Landing page → GitHub URL parser: parses URL
- Repository explorer → Repository view: opens repo
- Repository view → FastAPI app: loads repo view
- FastAPI app → API routes: mounts routes
- API routes → Embedded graph view: serves HTML
- API routes → Repository analysis: dispatches analysis
- Repository analysis → GitHub client: fetches repo
- GitHub client → GitHub API: requests files
- GitHub API → GitHub client: returns repo data
- Repository analysis → Memory cache: reads cache
- Repository analysis → Memory cache: writes graph
- Repository analysis → Symbol extraction: extracts tags
- Repository analysis → Graph builder: builds graph
- Graph builder → Symbol normalization: normalizes symbols
- API routes → Discovermap adapter: formats discover data
- Repository view → Graph canvas: renders graph