How ksksrbiz-arch/walking-dead-universe-atlas works
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: App.tsx App shell · data.ts Canon registries · SearchOverlay.tsx Search overlay · details Entity details
Components 23
Atlas experience
- App shell
src/App.tsx - Map view
src/views/MapOverview.tsx - Timeline view
src/views/TimelineView.tsx - People view
src/views/PeopleView.tsx - Watch view
src/views/WatchView.tsx - Journey panel
src/views/JourneyPanel.tsx - Search overlay
src/components/SearchOverlay.tsx - Ask Atlas
src/components/AskAtlas.tsx - Entity details
src/views/details
Atlas domain
- Canon registries
src/data.ts - Chronology engine
src/lib/chronology.ts - Entity lookup
src/lib/lookup.ts - Entity graph
src/lib/entityGraph.ts - Journey model
src/lib/journeys.ts - Watch progress
src/lib/watchProgress.ts
Content services
- Media resolution
src/lib/media.ts - Share previews
api/share.ts - Preview rendering
api/og.ts
Platform services
- Atlas AI worker
workers/atlas-ai/src/index.mjs - AI corpus
workers/atlas-ai/src/corpus.mjs - Media API
api/media/[...path].ts - Media proxy
workers/atlas-media-proxy/src/index.ts
Other components
- Atlas visitor
Connections 26
- Atlas visitor → App shell: opens atlas
README.md - App shell → Map view: shows map
src/App.tsx - App shell → Timeline view: shows timeline
src/App.tsx - App shell → People view: shows people
README.md - App shell → Watch view: shows watch
src/App.tsx - App shell → Journey panel: opens journey
src/App.tsx - App shell → Search overlay: opens search
src/App.tsx - Search overlay → Ask Atlas: embeds ask
src/components/SearchOverlay.tsx - Atlas visitor → Search overlay: searches atlas
README.md - App shell → Canon registries: loads data
src/App.tsx - Canon registries → Chronology engine: supplies records
src/lib/chronology.ts - Canon registries → Entity lookup: indexes records
src/lib/lookup.ts - Canon registries → Entity graph: builds graph
src/lib/entityGraph.ts - Canon registries → Journey model: builds journeys
src/lib/journeys.ts - Journey panel → Journey model: uses journeys
src/views/JourneyPanel.tsx - Timeline view → Chronology engine: uses chronology
src/views/TimelineView.tsx - Watch view → Chronology engine: uses chronology
src/views/WatchView.tsx - Watch view → Watch progress: backs up progress
src/views/WatchView.tsx - Entity details → Entity lookup: resolves entities
src/views/details/shared.tsx - Entity details → Entity graph: shows connections
src/views/details/shared.tsx - Search overlay → Entity lookup: finds entities
src/components/SearchOverlay.tsx - Entity details → Media resolution: resolves images
- Atlas visitor → Share previews: opens shared link
README.md - Share previews → Preview rendering: generates preview
- Atlas AI worker → AI corpus: loads corpus
workers/atlas-ai/src/index.mjs - Media API → Media proxy: forwards media