How yonz-git/natureplore works
Natureplore is a no-account nature-discovery prototype: people find nearby or seasonal routes, explore mapped route details and organisms, learn about conservation claims and actions, then save routes and learning content on their device. Its principal flow runs from the welcome screen to route suggestions, route detail and an optional walk; search and map views provide alternate discovery paths. Learn and Saved are distinct product branches. The README documents the wider screen flows, while sampled source and the SOURCE INDEX support only some implementation links; unsampled subsystems are represented without guessed internal calls.
Main entry points: layout.tsx Tabbed app · LearnScreen.tsx Learn overview · SavedScreen.tsx Saved overview · SuggestionsScreen.tsx Route suggestions
Components 24
Route discovery
- Welcome
components/Welcome.tsx - Tabbed app
app/(app)/layout.tsx - Route suggestions
components/SuggestionsScreen.tsx - Region map
components/RegionMap.tsx - Map search
components/SearchScreen.tsx - Route detail
components/RouteCardScreen.tsx - Walk mode
components/WalkScreen.tsx
Nature learning
- Learn overview
components/LearnScreen.tsx - Claims and sources
components/ClaimScreen.tsx - Conservation actions
components/ActionScreen.tsx - Documentaries
components/DocsScreen.tsx - Organism detail
components/OrganismPage.tsx
Saved on device
- Saved overview
components/SavedScreen.tsx - Saved lists
components/SavedPages.tsx
Domain data
- Device saves
lib/saved.ts - Seasonal catalogue
lib/suggestions.ts - Route definitions
lib/routes.ts - Route spot details
lib/spots.ts - Claim content
lib/claims.ts - Action content
lib/actions.ts - Documentary catalogue
lib/docs.ts - Recent searches
lib/recent.ts - Base map geometry
public/base-geo.js
Other components
- Visitor
Connections 34
- Visitor → Welcome: opens
- Welcome → Tabbed app: continues to
- Visitor → Tabbed app: enters
- Tabbed app → Route suggestions: opens Routes
- Route suggestions → Seasonal catalogue: loads seasons
components/SuggestionsScreen.tsx - Route suggestions → Route definitions: uses routes
components/SuggestionsScreen.tsx - Route suggestions → Region map: shows routes on
components/SuggestionsScreen.tsx - Tabbed app → Map search: opens search
- Map search → Seasonal catalogue: searches catalogue
components/SearchScreen.tsx - Map search → Region map: renders map
components/SearchScreen.tsx - Map search → Recent searches: records opened results
components/SearchScreen.tsx - Region map → Base map geometry: loads geometry
- Route suggestions → Route detail: opens route
- Route detail → Route definitions: reads route
lib/routes.ts - Route detail → Route spot details: shows route spots
- Route detail → Walk mode: starts walk
- Visitor → Tabbed app: opens Learn
- Tabbed app → Learn overview: opens Learn tab
- Learn overview → Claims and sources: opens claim
- Learn overview → Conservation actions: opens action
- Learn overview → Documentaries: opens films
- Learn overview → Claim content: reads claims
components/LearnScreen.tsx - Learn overview → Action content: reads actions
components/LearnScreen.tsx - Learn overview → Documentary catalogue: reads documentaries
components/LearnScreen.tsx - Map search → Organism detail: opens organism
- Visitor → Tabbed app: opens Saved
- Tabbed app → Saved overview: opens Saved tab
- Saved overview → Saved lists: opens sections
- Saved overview → Device saves: reads saved items
components/SavedScreen.tsx - Saved lists → Device saves: updates saved items
components/SavedPages.tsx - Saved overview → Seasonal catalogue: shows saved routes
components/SavedScreen.tsx - Saved lists → Recent searches: shows recent searches
components/SavedPages.tsx - Saved overview → Action content: lists saved actions
components/SavedScreen.tsx - Saved overview → Documentary catalogue: lists saved films
components/SavedScreen.tsx