How killy10o10/yenko works
Yɛnkɔ is a Ghana-focused, offline-first neighbourhood discovery PWA. A user chooses a city, starting point, interests, travel mode and time budget; the app generates three route options, displays a selected route on a map, tracks checked-off stops, and awards hood-familiarity progress on completion. The graph separates the app’s orchestration, user-facing journey, route and familiarity logic, and city/map data. Some data and routing details come from the README; unsampled implementation connections are omitted or marked unverified.
Main entry points: App.tsx App orchestrator · SetupScreen.tsx Route setup · generator.ts Route generator · MapView.tsx Interactive map
Components 28
User journey
- App orchestrator
src/App.tsx - Route setup
src/features/setup/SetupScreen.tsx - Interest picker
src/features/setup/InterestGrid.tsx - Start location
src/features/setup/LocationControl.tsx - Travel mode
src/features/setup/ModePicker.tsx - Time budget
src/features/setup/TimeSlider.tsx - Route options
src/features/routes/RoutesScreen.tsx - Route detail
src/features/routes/RouteCard.tsx - Walk checklist
src/features/walk/WalkScreen.tsx - Route completion
src/features/walk/CompletionDialog.tsx - Hood passport
src/features/passport/PassportDialog.tsx
Route and familiarity engine
- Route generator
src/core/generator.ts - POI scoring
src/core/scoring.ts - Geo calculations
src/core/geo.ts - Mode estimates
src/core/modes.ts - Familiarity ranks
src/core/familiarity.ts - Hood resolution
src/core/hoods.ts
City and map data
- City POI data
src/data/city.ts - Place categories
src/data/categories.ts - Saved progress
src/data/progress.ts - Street routing
src/data/routing.ts - Interactive map
src/map/MapView.tsx
App presentation
- App header
src/features/layout/AppHeader.tsx - Responsive panel
src/features/layout/Panel.tsx - Theme settings
src/lib/theme.ts - Palette settings
src/lib/palette.ts
Other components
- Traveller
- Vector tile host
Connections 32
- Traveller → Route setup: sets preferences
- App orchestrator → Route setup: renders
src/App.tsx - Route setup → Interest picker: renders
src/features/setup/SetupScreen.tsx - Route setup → Start location: renders
src/features/setup/SetupScreen.tsx - Route setup → Travel mode: renders
src/features/setup/SetupScreen.tsx - Route setup → Time budget: renders
src/features/setup/SetupScreen.tsx - App orchestrator → City POI data: loads city
src/App.tsx - App orchestrator → Saved progress: loads and saves
src/App.tsx - App orchestrator → Route generator: generates routes
src/App.tsx - Route generator → POI scoring: scores places
src/core/index.ts - Route generator → Geo calculations: uses geo math
src/core/index.ts - Route generator → Mode estimates: uses mode estimates
src/core/index.ts - App orchestrator → Route options: renders
src/App.tsx - Route options → Route detail: renders options
src/features/routes/RoutesScreen.tsx - App orchestrator → Street routing: requests street paths
src/App.tsx - Street routing → Vector tile host: uses routing service
- App orchestrator → Interactive map: renders route state
src/App.tsx - Interactive map → Vector tile host: loads map tiles
src/map/MapView.tsx - App orchestrator → Walk checklist: renders checklist
src/App.tsx - Traveller → Walk checklist: checks off stops
src/features/walk/WalkScreen.tsx - App orchestrator → Familiarity ranks: completes route
src/App.tsx - Familiarity ranks → Hood resolution: resolves hood
src/core/index.ts - App orchestrator → Route completion: shows completion
src/App.tsx - App orchestrator → Hood passport: shows progress
- App orchestrator → App header: renders
src/App.tsx - App orchestrator → Responsive panel: hosts screens
src/App.tsx - App header → Theme settings: toggles theme
src/features/layout/AppHeader.tsx - Theme settings → Palette settings: reads palette
src/lib/theme.ts - Interactive map → Palette settings: styles route line
src/map/MapView.tsx - Route setup → Place categories: shows choices
src/features/setup/SetupScreen.tsx - Route detail → Place categories: labels stops
src/features/routes/RouteCard.tsx - Walk checklist → Place categories: labels stops
src/features/walk/WalkScreen.tsx