How garyqian/starmap works
Starmap turns a selected local repository into an interactive 3D dependency map: it reads Git-tracked files, parses and links their structure, clusters and lays out the result, then reveals it in the browser. Users can explore with search, selections, file reading and overlays; optional AI adds summaries, points of interest, tours and chat. The README documents the principal stages and capabilities. Some internal wiring is unsampled, so those connections are omitted rather than inferred.
Main entry points: coordinator.worker.ts Pipeline coordinator · store.ts Map data model · ingest Manifest and parsing · analysis Dependency analysis
Components 21
Browser experience
- App shell
src/app/App.tsx - Folder selection
src/app/landing/Landing.tsx - 3D renderer
src/render/core/renderer.ts
Repository pipeline
- Manifest and parsing
src/ingest - Git reader
src/git - Language parsers
src/lang - Dependency analysis
src/analysis - Cross-language links
src/bridges/index.ts - Git history
src/history - Pipeline coordinator
src/pipeline/coordinator.worker.ts
Map model and layout
- Map data model
src/model/store.ts - Tiered layout
src/physics/engine.ts - Local persistence
src/persist/index.ts
Exploration and state
- File search
src/search/searchIndex.ts - Map overlays
src/overlays/view.ts - File reader
src/app/sidebar/Reader.tsx - Repository content
src/content/index.ts
Optional AI
- AI digest and client
src/ai/index.ts - AI API handlers
src/ai/server/handlers.ts
Other components
- Repository user
- Model provider
Connections 21
- Repository user → Folder selection: chooses folder
README.md - Folder selection → Pipeline coordinator: starts mapping
- Pipeline coordinator → Manifest and parsing: runs pipeline
README.md - Manifest and parsing → Git reader: reads manifest
README.md - Manifest and parsing → Language parsers: parses files
README.md - Language parsers → Dependency analysis: extracts references
README.md - Dependency analysis → Cross-language links: adds bridge links
src/analysis/index.ts - Dependency analysis → Map data model: builds map
README.md - Pipeline coordinator → Map data model: streams patches
src/pipeline/coordinator.worker.ts - Pipeline coordinator → Tiered layout: coordinates layout
- Tiered layout → 3D renderer: supplies positions
- Pipeline coordinator → Local persistence: saves locally
README.md - Pipeline coordinator → Git history: walks history
README.md - Map data model → Map overlays: supports overlays
README.md - Map data model → File search: enables search
README.md - Repository user → File reader: opens file
README.md - File reader → Repository content: reads content
- Pipeline coordinator → AI digest and client: prepares AI notes
- AI digest and client → AI API handlers: sends requests
README.md - AI API handlers → Model provider: calls provider
README.md - AI API handlers → AI digest and client: returns results