How saptarshi-mandal-1234/spotland works
SPOTLAND is an India-focused travel PWA. Users explore nearby places, then can get directions, view events and venues, plan trips, save favorites, read or submit reviews, and use safety, SOS, and live-sharing tools. The browser app calls a same-origin API routed to a Cloudflare Worker; the Worker handles domain APIs and provider access, with D1-backed persistence and private R2 photo storage. The README and source index establish capabilities and some module links, but many feature implementations were not excerpted, so uncertain internal connections are omitted.
Main entry points: App.tsx App shell · index.ts API router · routing.ts Routing service · review-photos.ts Review photos
Components 28
Travel app
- App shell
web/src/App.tsx - Nearby explore
web/src/Explore.tsx - Account & favorites
web/src/Account.tsx - Trip planner
web/src/TripPlanner.tsx - Events & calendar
web/src/Events.tsx - Venue discovery
web/src/Venues.tsx - Reviews & photos
web/src/Reviews.tsx - Safety tools
web/src/Safety.tsx - SOS
web/src/SOS.tsx - Live sharing
web/src/LiveShare.tsx
Shared domain
- Place model
shared/places.ts - Route model
shared/routes.ts - Review model
shared/reviews.ts - SOS model
shared/sos.ts
Worker services
- API router
worker/src/index.ts - Place providers
worker/src/providers.ts - Routing service
worker/src/routing.ts - Account service
worker/src/accounts.ts - Events service
worker/src/events.ts - Review photos
worker/src/review-photos.ts - SOS service
worker/src/sos.ts
Persistence
- D1 helpers
worker/src/db.ts - Cloudflare D1
- Private R2
External services
- Map & place providers
- OSRM
- Google sign-in
Other components
- Traveler
Connections 30
- Traveler → App shell: uses
README.md - App shell → Nearby explore: opens
web/src/App.tsx - App shell → Account & favorites: opens
web/src/App.tsx - App shell → Trip planner: opens
web/src/App.tsx - App shell → Events & calendar: opens
web/src/App.tsx - App shell → Venue discovery: opens
web/src/App.tsx - App shell → Safety tools: opens
web/src/App.tsx - App shell → SOS: opens
web/src/App.tsx - App shell → Live sharing: opens
web/src/App.tsx - Traveler → Reviews & photos: submits
README.md - Nearby explore → API router: requests places
- Trip planner → API router: requests routes
- Reviews & photos → Review photos: uploads photos
web/src/Reviews.tsx - SOS → Live sharing: uses sharing
web/src/SOS.tsx - API router → Place providers: dispatches
worker/src/index.ts - API router → Routing service: dispatches
worker/src/index.ts - API router → Events service: dispatches
worker/src/index.ts - API router → Review photos: dispatches
worker/src/index.ts - API router → SOS service: dispatches
worker/src/index.ts - Place providers → D1 helpers: reads cache
worker/src/providers.ts - Routing service → D1 helpers: reads cache
worker/src/routing.ts - D1 helpers → Cloudflare D1: reads and writes
README.md - Review photos → Private R2: stores photos
- Place providers → Map & place providers: queries
- Routing service → OSRM: requests routes
worker/src/routing.ts - Account service → Google sign-in: verifies sign-in
worker/src/accounts.ts - Nearby explore → Place model: uses place data
- Routing service → Route model: returns route
worker/src/routing.ts - Review photos → Review model: validates reviews
worker/src/review-photos.ts - SOS service → SOS model: uses SOS rules
worker/src/sos.ts