# tomdevtech/exofinder architecture

> Architecture diagram of the GitHub repository tomdevtech/exofinder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tomdevtech/exofinder
- Repository: https://github.com/tomdevtech/exofinder

## Overview

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: [`src/app/planets/[slug]/page.tsx`](https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/%5Bslug%5D/page.tsx) (Planet details), [`src/app/map/payload.ts`](https://github.com/tomdevtech/exofinder/blob/main/src/app/map/payload.ts) (Map payload), [`src/app/planets/queries.ts`](https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/queries.ts) (Planet queries), [`src/app/search/query.ts`](https://github.com/tomdevtech/exofinder/blob/main/src/app/search/query.ts) (Search matching)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalogue and search"]
  node_home["Home and catalogue<br/>[page.tsx]"]
  node_searchbox["Search box<br/>[SearchBox.tsx]"]
  node_suggestions["Search suggestions<br/>[route.ts]"]
  node_searchlogic["Search matching<br/>[query.ts]"]
  node_planetlist["Planet catalogue<br/>[page.tsx]"]
  node_planetdetail["Planet details<br/>[page.tsx]"]
end

subgraph group_visual["3D and galaxy map"]
  node_appearance["Planet appearance<br/>[appearance.ts]"]
  node_globe["Planet 3D viewer<br/>[PlanetViewer.tsx]"]
  node_maproutes["Map data routes<br/>[route.ts]"]
  node_mapqueries["Map queries<br/>[queries.ts]"]
  node_mappayload["Map payload<br/>[payload.ts]"]
  node_mapengine["Map renderer<br/>[engine.ts]"]
end

subgraph group_solar["Solar system"]
  node_solardetail["Solar-system details<br/>[page.tsx]"]
  node_solarbodydata["Solar body data<br/>[bodies.ts]"]
end

subgraph group_data["Data services"]
  node_planetqueries["Planet queries<br/>[queries.ts]"]
  node_database[("PostgreSQL catalogue<br/>[schema.ts]")]
  node_dbclient["Database client<br/>[client.ts]"]
end

subgraph group_sync["Catalogue sync"]
  node_syncjob["Nightly sync"]
end

node_visitor(("Visitor"))
node_nasa["NASA Exoplanet Archive"]

node_visitor -->|"opens"| node_home
node_visitor -->|"searches"| node_searchbox
node_searchbox -->|"requests suggestions"| node_suggestions
node_suggestions -->|"calls search"| node_searchlogic
node_searchlogic -->|"queries"| node_dbclient
node_dbclient -->|"connects to"| node_database
node_searchlogic -->|"matches bodies"| node_solarbodydata
node_visitor -->|"browses"| node_planetlist
node_planetlist -->|"loads catalogue"| node_planetqueries
node_planetqueries -->|"queries"| node_dbclient
node_visitor -->|"opens planet"| node_planetdetail
node_planetdetail -->|"loads planet data"| node_planetqueries
node_planetdetail -->|"builds appearance"| node_appearance
node_planetdetail -->|"renders 3D"| node_globe
node_visitor -->|"explores map"| node_maproutes
node_maproutes -->|"calls queries"| node_mapqueries
node_mapqueries -->|"builds response"| node_mappayload
node_mappayload -->|"computes planet look"| node_appearance
node_mappayload -->|"uses body data"| node_solarbodydata
node_visitor -->|"opens solar body"| node_solardetail
node_solardetail -->|"loads body data"| node_solarbodydata
node_solardetail -->|"renders 3D"| node_globe
node_mappayload -.->|"supplies map data"| node_mapengine
node_mapengine -->|"renders interactive map"| node_visitor
node_nasa -->|"provides catalogue"| node_syncjob
node_syncjob -->|"updates data"| node_database
node_database -->|"serves read queries"| node_planetqueries

click node_home "https://github.com/tomdevtech/exofinder/blob/main/src/app/page.tsx"
click node_searchbox "https://github.com/tomdevtech/exofinder/blob/main/src/app/search/SearchBox.tsx"
click node_suggestions "https://github.com/tomdevtech/exofinder/blob/main/src/app/search/suggest/route.ts"
click node_searchlogic "https://github.com/tomdevtech/exofinder/blob/main/src/app/search/query.ts"
click node_planetlist "https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/page.tsx"
click node_planetqueries "https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/queries.ts"
click node_planetdetail "https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/%5Bslug%5D/page.tsx"
click node_appearance "https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/appearance.ts"
click node_globe "https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/globe/PlanetViewer.tsx"
click node_maproutes "https://github.com/tomdevtech/exofinder/blob/main/src/app/map/systems/%5Bslug%5D/route.ts"
click node_mapqueries "https://github.com/tomdevtech/exofinder/blob/main/src/app/map/queries.ts"
click node_mappayload "https://github.com/tomdevtech/exofinder/blob/main/src/app/map/payload.ts"
click node_mapengine "https://github.com/tomdevtech/exofinder/blob/main/src/app/map/scene/engine.ts"
click node_solardetail "https://github.com/tomdevtech/exofinder/blob/main/src/app/solar-system/%5Bslug%5D/page.tsx"
click node_solarbodydata "https://github.com/tomdevtech/exofinder/blob/main/src/app/solar-system/bodies.ts"
click node_database "https://github.com/tomdevtech/exofinder/blob/main/src/db/schema.ts"
click node_dbclient "https://github.com/tomdevtech/exofinder/blob/main/src/db/client.ts"
click node_syncjob "https://github.com/tomdevtech/exofinder/tree/main/src/app/sync"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_searchbox,node_suggestions,node_searchlogic,node_planetlist,node_planetdetail toneBlue
class node_appearance,node_globe,node_maproutes,node_mapqueries,node_mappayload,node_mapengine toneAmber
class node_solardetail,node_solarbodydata toneMint
class node_planetqueries,node_database,node_dbclient toneRose
class node_syncjob,node_visitor,node_nasa toneIndigo
```

## Components

### Catalogue and search

- [Home and catalogue](https://github.com/tomdevtech/exofinder/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Search box](https://github.com/tomdevtech/exofinder/blob/main/src/app/search/SearchBox.tsx): `src/app/search/SearchBox.tsx`
- [Search suggestions](https://github.com/tomdevtech/exofinder/blob/main/src/app/search/suggest/route.ts): `src/app/search/suggest/route.ts`
- [Search matching](https://github.com/tomdevtech/exofinder/blob/main/src/app/search/query.ts): `src/app/search/query.ts`
- [Planet catalogue](https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/page.tsx): `src/app/planets/page.tsx`
- [Planet details](https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/%5Bslug%5D/page.tsx): `src/app/planets/[slug]/page.tsx`

### 3D and galaxy map

- [Planet appearance](https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/appearance.ts): `src/app/planets/appearance.ts`
- [Planet 3D viewer](https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/globe/PlanetViewer.tsx): `src/app/planets/globe/PlanetViewer.tsx`
- [Map data routes](https://github.com/tomdevtech/exofinder/blob/main/src/app/map/systems/%5Bslug%5D/route.ts): `src/app/map/systems/[slug]/route.ts`
- [Map queries](https://github.com/tomdevtech/exofinder/blob/main/src/app/map/queries.ts): `src/app/map/queries.ts`
- [Map payload](https://github.com/tomdevtech/exofinder/blob/main/src/app/map/payload.ts): `src/app/map/payload.ts`
- [Map renderer](https://github.com/tomdevtech/exofinder/blob/main/src/app/map/scene/engine.ts): `src/app/map/scene/engine.ts`

### Solar system

- [Solar-system details](https://github.com/tomdevtech/exofinder/blob/main/src/app/solar-system/%5Bslug%5D/page.tsx): `src/app/solar-system/[slug]/page.tsx`
- [Solar body data](https://github.com/tomdevtech/exofinder/blob/main/src/app/solar-system/bodies.ts): `src/app/solar-system/bodies.ts`

### Data services

- [Planet queries](https://github.com/tomdevtech/exofinder/blob/main/src/app/planets/queries.ts): `src/app/planets/queries.ts`
- [PostgreSQL catalogue](https://github.com/tomdevtech/exofinder/blob/main/src/db/schema.ts): `src/db/schema.ts`
- [Database client](https://github.com/tomdevtech/exofinder/blob/main/src/db/client.ts): `src/db/client.ts`

### Catalogue sync

- [Nightly sync](https://github.com/tomdevtech/exofinder/tree/main/src/app/sync): `src/app/sync`

### Other components

- **Visitor**
- **NASA Exoplanet Archive**

## Connections

- Visitor → Home and catalogue: opens (evidence: `README.md`)
- Visitor → Search box: searches (evidence: `README.md`)
- Search box → Search suggestions: requests suggestions (evidence: `src/app/search/suggest/route.ts`)
- Search suggestions → Search matching: calls search (evidence: `src/app/search/suggest/route.ts`)
- Search matching → Database client: queries (evidence: `src/app/search/query.ts`)
- Database client → PostgreSQL catalogue: connects to (evidence: `src/db/client.ts`)
- Search matching → Solar body data: matches bodies (evidence: `src/app/search/query.ts`)
- Visitor → Planet catalogue: browses (evidence: `README.md`)
- Planet catalogue → Planet queries: loads catalogue (evidence: `src/app/planets/page.tsx`)
- Planet queries → Database client: queries (evidence: `src/app/planets/queries.ts`)
- Visitor → Planet details: opens planet (evidence: `README.md`)
- Planet details → Planet queries: loads planet data
- Planet details → Planet appearance: builds appearance
- Planet details → Planet 3D viewer: renders 3D (evidence: `README.md`)
- Visitor → Map data routes: explores map (evidence: `README.md`)
- Map data routes → Map queries: calls queries (evidence: `src/app/map/systems/[slug]/route.ts`)
- Map queries → Map payload: builds response (evidence: `src/app/map/queries.ts`)
- Map payload → Planet appearance: computes planet look (evidence: `src/app/map/payload.ts`)
- Map payload → Solar body data: uses body data (evidence: `src/app/map/payload.ts`)
- Visitor → Solar-system details: opens solar body (evidence: `README.md`)
- Solar-system details → Solar body data: loads body data (evidence: `src/app/solar-system/[slug]/page.tsx`)
- Solar-system details → Planet 3D viewer: renders 3D (evidence: `src/app/solar-system/[slug]/page.tsx`)
- Map payload → Map renderer: supplies map data (evidence: `src/app/map/scene/engine.ts`)
- Map renderer → Visitor: renders interactive map (evidence: `README.md`)
- NASA Exoplanet Archive → Nightly sync: provides catalogue (evidence: `README.md`)
- Nightly sync → PostgreSQL catalogue: updates data (evidence: `README.md`)
- PostgreSQL catalogue → Planet queries: serves read queries (evidence: `README.md`)
