# ksksrbiz-arch/walking-dead-universe-atlas architecture

> Architecture diagram of the GitHub repository ksksrbiz-arch/walking-dead-universe-atlas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ksksrbiz-arch/walking-dead-universe-atlas
- Repository: https://github.com/ksksrbiz-arch/walking-dead-universe-atlas
- Video tour (about a minute): https://gitdiagram.com/ksksrbiz-arch/walking-dead-universe-atlas/video

## Overview

The Walking Dead Universe Atlas is a React reference application for exploring canon data across map, timeline, people, watch-order, journey, detail, and search experiences. The main user flow is selecting an atlas view or searching, then navigating related entities; journey tools add story-order routes, evidence episodes, comparisons, and spoiler-safe playback. Checked-in registries feed chronology, lookup, and relationship-graph logic. The README documents AI answers and shareable preview links, while the sampled sources show only some wiring; those capabilities are included without guessing unshown runtime connections.

Main entry points: [`src/App.tsx`](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/App.tsx) (App shell), [`src/data.ts`](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/data.ts) (Canon registries), [`src/components/SearchOverlay.tsx`](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/components/SearchOverlay.tsx) (Search overlay), [`src/views/details`](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/tree/main/src/views/details) (Entity details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Atlas experience"]
  node_app["App shell<br/>[App.tsx]"]
  node_map["Map view<br/>[MapOverview.tsx]"]
  node_timeline["Timeline view<br/>[TimelineView.tsx]"]
  node_people["People view<br/>[PeopleView.tsx]"]
  node_watch["Watch view<br/>[WatchView.tsx]"]
  node_journey["Journey panel<br/>[JourneyPanel.tsx]"]
  node_search["Search overlay<br/>[SearchOverlay.tsx]"]
  node_ask["Ask Atlas<br/>[AskAtlas.tsx]"]
  node_details["Entity details"]
end

subgraph group_domain["Atlas domain"]
  node_registries[("Canon registries<br/>[data.ts]")]
  node_chronology["Chronology engine<br/>[chronology.ts]"]
  node_lookup["Entity lookup<br/>[lookup.ts]"]
  node_relationships["Entity graph<br/>[entityGraph.ts]"]
  node_journeylogic["Journey model<br/>[journeys.ts]"]
  node_progress["Watch progress<br/>[watchProgress.ts]"]
end

subgraph group_content["Content services"]
  node_media["Media resolution<br/>[media.ts]"]
  node_share["Share previews<br/>[share.ts]"]
  node_og["Preview rendering<br/>[og.ts]"]
end

subgraph group_platform["Platform services"]
  node_aiworker["Atlas AI worker<br/>[index.mjs]"]
  node_corpus["AI corpus<br/>[corpus.mjs]"]
  node_mediaapi["Media API<br/>[&#91;...path&#93;.ts]"]
  node_mediaproxy["Media proxy<br/>[index.ts]"]
end

node_visitor(("Atlas visitor"))

node_visitor -->|"opens atlas"| node_app
node_app -->|"shows map"| node_map
node_app -->|"shows timeline"| node_timeline
node_app -->|"shows people"| node_people
node_app -->|"shows watch"| node_watch
node_app -->|"opens journey"| node_journey
node_app -.->|"opens search"| node_search
node_search -->|"embeds ask"| node_ask
node_visitor -->|"searches atlas"| node_search
node_app -->|"loads data"| node_registries
node_registries -->|"supplies records"| node_chronology
node_registries -->|"indexes records"| node_lookup
node_registries -->|"builds graph"| node_relationships
node_registries -->|"builds journeys"| node_journeylogic
node_journey -->|"uses journeys"| node_journeylogic
node_timeline -->|"uses chronology"| node_chronology
node_watch -->|"uses chronology"| node_chronology
node_watch -->|"backs up progress"| node_progress
node_details -->|"resolves entities"| node_lookup
node_details -->|"shows connections"| node_relationships
node_search -->|"finds entities"| node_lookup
node_details -->|"resolves images"| node_media
node_visitor -->|"opens shared link"| node_share
node_share -.->|"generates preview"| node_og
node_aiworker -->|"loads corpus"| node_corpus
node_mediaapi -.->|"forwards media"| node_mediaproxy

click node_app "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/App.tsx"
click node_map "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/views/MapOverview.tsx"
click node_timeline "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/views/TimelineView.tsx"
click node_people "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/views/PeopleView.tsx"
click node_watch "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/views/WatchView.tsx"
click node_journey "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/views/JourneyPanel.tsx"
click node_search "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/components/SearchOverlay.tsx"
click node_ask "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/components/AskAtlas.tsx"
click node_details "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/tree/main/src/views/details"
click node_registries "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/data.ts"
click node_chronology "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/chronology.ts"
click node_lookup "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/lookup.ts"
click node_relationships "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/entityGraph.ts"
click node_journeylogic "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/journeys.ts"
click node_progress "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/watchProgress.ts"
click node_media "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/media.ts"
click node_share "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/api/share.ts"
click node_og "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/api/og.ts"
click node_aiworker "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/workers/atlas-ai/src/index.mjs"
click node_corpus "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/workers/atlas-ai/src/corpus.mjs"
click node_mediaapi "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/api/media/%5B...path%5D.ts"
click node_mediaproxy "https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/workers/atlas-media-proxy/src/index.ts"

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_app,node_map,node_timeline,node_people,node_watch,node_journey,node_search,node_ask,node_details toneBlue
class node_registries,node_chronology,node_lookup,node_relationships,node_journeylogic,node_progress toneAmber
class node_media,node_share,node_og toneMint
class node_aiworker,node_corpus,node_mediaapi,node_mediaproxy toneRose
class node_visitor toneIndigo
```

## Components

### Atlas experience

- [App shell](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/App.tsx): `src/App.tsx`
- [Map view](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/views/MapOverview.tsx): `src/views/MapOverview.tsx`
- [Timeline view](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/views/TimelineView.tsx): `src/views/TimelineView.tsx`
- [People view](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/views/PeopleView.tsx): `src/views/PeopleView.tsx`
- [Watch view](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/views/WatchView.tsx): `src/views/WatchView.tsx`
- [Journey panel](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/views/JourneyPanel.tsx): `src/views/JourneyPanel.tsx`
- [Search overlay](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/components/SearchOverlay.tsx): `src/components/SearchOverlay.tsx`
- [Ask Atlas](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/components/AskAtlas.tsx): `src/components/AskAtlas.tsx`
- [Entity details](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/tree/main/src/views/details): `src/views/details`

### Atlas domain

- [Canon registries](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/data.ts): `src/data.ts`
- [Chronology engine](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/chronology.ts): `src/lib/chronology.ts`
- [Entity lookup](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/lookup.ts): `src/lib/lookup.ts`
- [Entity graph](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/entityGraph.ts): `src/lib/entityGraph.ts`
- [Journey model](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/journeys.ts): `src/lib/journeys.ts`
- [Watch progress](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/watchProgress.ts): `src/lib/watchProgress.ts`

### Content services

- [Media resolution](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/src/lib/media.ts): `src/lib/media.ts`
- [Share previews](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/api/share.ts): `api/share.ts`
- [Preview rendering](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/api/og.ts): `api/og.ts`

### Platform services

- [Atlas AI worker](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/workers/atlas-ai/src/index.mjs): `workers/atlas-ai/src/index.mjs`
- [AI corpus](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/workers/atlas-ai/src/corpus.mjs): `workers/atlas-ai/src/corpus.mjs`
- [Media API](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/api/media/%5B...path%5D.ts): `api/media/[...path].ts`
- [Media proxy](https://github.com/ksksrbiz-arch/walking-dead-universe-atlas/blob/main/workers/atlas-media-proxy/src/index.ts): `workers/atlas-media-proxy/src/index.ts`

### Other components

- **Atlas visitor**

## Connections

- Atlas visitor → App shell: opens atlas (evidence: `README.md`)
- App shell → Map view: shows map (evidence: `src/App.tsx`)
- App shell → Timeline view: shows timeline (evidence: `src/App.tsx`)
- App shell → People view: shows people (evidence: `README.md`)
- App shell → Watch view: shows watch (evidence: `src/App.tsx`)
- App shell → Journey panel: opens journey (evidence: `src/App.tsx`)
- App shell → Search overlay: opens search (evidence: `src/App.tsx`)
- Search overlay → Ask Atlas: embeds ask (evidence: `src/components/SearchOverlay.tsx`)
- Atlas visitor → Search overlay: searches atlas (evidence: `README.md`)
- App shell → Canon registries: loads data (evidence: `src/App.tsx`)
- Canon registries → Chronology engine: supplies records (evidence: `src/lib/chronology.ts`)
- Canon registries → Entity lookup: indexes records (evidence: `src/lib/lookup.ts`)
- Canon registries → Entity graph: builds graph (evidence: `src/lib/entityGraph.ts`)
- Canon registries → Journey model: builds journeys (evidence: `src/lib/journeys.ts`)
- Journey panel → Journey model: uses journeys (evidence: `src/views/JourneyPanel.tsx`)
- Timeline view → Chronology engine: uses chronology (evidence: `src/views/TimelineView.tsx`)
- Watch view → Chronology engine: uses chronology (evidence: `src/views/WatchView.tsx`)
- Watch view → Watch progress: backs up progress (evidence: `src/views/WatchView.tsx`)
- Entity details → Entity lookup: resolves entities (evidence: `src/views/details/shared.tsx`)
- Entity details → Entity graph: shows connections (evidence: `src/views/details/shared.tsx`)
- Search overlay → Entity lookup: finds entities (evidence: `src/components/SearchOverlay.tsx`)
- Entity details → Media resolution: resolves images
- Atlas visitor → Share previews: opens shared link (evidence: `README.md`)
- Share previews → Preview rendering: generates preview
- Atlas AI worker → AI corpus: loads corpus (evidence: `workers/atlas-ai/src/index.mjs`)
- Media API → Media proxy: forwards media
