How tomdevtech/exofinder works
ExoFinder is a public exoplanet catalogue and interactive astronomy explorer. Visitors search for planets, stars, and solar-system bodies; browse catalogue and detail pages; view modelled planets in 3D; and explore systems in a Milky Way map. Nightly synchronization fetches NASA catalogue data and updates the database, while the website reads from it. The README documents these product flows; several map, rendering, and sync implementations were not sampled, so their internal connections are not inferred.
Main entry points: page.tsx Planet details · payload.ts Map payload · queries.ts Planet queries · query.ts Search matching
Components 20
Catalogue and search
- Home and catalogue
src/app/page.tsx - Search box
src/app/search/SearchBox.tsx - Search suggestions
src/app/search/suggest/route.ts - Search matching
src/app/search/query.ts - Planet catalogue
src/app/planets/page.tsx - Planet details
src/app/planets/[slug]/page.tsx
3D and galaxy map
- Planet appearance
src/app/planets/appearance.ts - Planet 3D viewer
src/app/planets/globe/PlanetViewer.tsx - Map data routes
src/app/map/systems/[slug]/route.ts - Map queries
src/app/map/queries.ts - Map payload
src/app/map/payload.ts - Map renderer
src/app/map/scene/engine.ts
Solar system
- Solar-system details
src/app/solar-system/[slug]/page.tsx - Solar body data
src/app/solar-system/bodies.ts
Data services
- Planet queries
src/app/planets/queries.ts - PostgreSQL catalogue
src/db/schema.ts - Database client
src/db/client.ts
Catalogue sync
- Nightly sync
src/app/sync
Other components
- Visitor
- NASA Exoplanet Archive
Connections 27
- Visitor → Home and catalogue: opens
README.md - Visitor → Search box: searches
README.md - Search box → Search suggestions: requests suggestions
src/app/search/suggest/route.ts - Search suggestions → Search matching: calls search
src/app/search/suggest/route.ts - Search matching → Database client: queries
src/app/search/query.ts - Database client → PostgreSQL catalogue: connects to
src/db/client.ts - Search matching → Solar body data: matches bodies
src/app/search/query.ts - Visitor → Planet catalogue: browses
README.md - Planet catalogue → Planet queries: loads catalogue
src/app/planets/page.tsx - Planet queries → Database client: queries
src/app/planets/queries.ts - Visitor → Planet details: opens planet
README.md - Planet details → Planet queries: loads planet data
- Planet details → Planet appearance: builds appearance
- Planet details → Planet 3D viewer: renders 3D
README.md - Visitor → Map data routes: explores map
README.md - Map data routes → Map queries: calls queries
src/app/map/systems/[slug]/route.ts - Map queries → Map payload: builds response
src/app/map/queries.ts - Map payload → Planet appearance: computes planet look
src/app/map/payload.ts - Map payload → Solar body data: uses body data
src/app/map/payload.ts - Visitor → Solar-system details: opens solar body
README.md - Solar-system details → Solar body data: loads body data
src/app/solar-system/[slug]/page.tsx - Solar-system details → Planet 3D viewer: renders 3D
src/app/solar-system/[slug]/page.tsx - Map payload → Map renderer: supplies map data
src/app/map/scene/engine.ts - Map renderer → Visitor: renders interactive map
README.md - NASA Exoplanet Archive → Nightly sync: provides catalogue
README.md - Nightly sync → PostgreSQL catalogue: updates data
README.md - PostgreSQL catalogue → Planet queries: serves read queries
README.md