How aaravkalia-88/wanderers works
Wanderer is a travel-discovery and personal travel-journal product centered on finding Indian destinations, planning trips, recording visits, and building a passport. The React app presents discovery, maps, weather, trip planning, community stories, and passport features; its API client connects to FastAPI, which serves authentication, destination, travel, export, community, and chat routes. The backend persists user, destination, travel, and community records. The README documents external weather, map, and routing integrations. Some route-to-handler and UI-to-feature wiring is inferred only where explicitly documented; unsampled source limits further call-level detail.
Main entry points: App.tsx App shell · main.py API application · api.py API route registry · session.py Database sessions
Components 32
Travel experience
- App shell
frontend/src/App.tsx - Destination discovery
frontend/src/components/DestinationCard.tsx - Passport journal
frontend/src/components/PassportPage.tsx - Trip planning
frontend/src/components/TripPlanner.tsx - Community stories
frontend/src/components/Community.tsx - Atlas maps
frontend/src/components/atlas/Atlas.tsx - Destination weather
frontend/src/components/Weather.tsx - Sign-in form
frontend/src/components/AuthForm.tsx
Client services
- User preferences
frontend/src/preferences.tsx - Travel API client
frontend/src/api/travel.ts - Destination catalog client
frontend/src/api/destinations.ts - Route and city lookup
frontend/src/api/routes.ts
API and identity
- API application
backend/app/main.py - API route registry
backend/app/api/v1/api.py - Authentication routes
backend/app/api/v1/auth.py - Destination routes
backend/app/api/v1/destinations.py - Travel routes
backend/app/api/v1/travel.py - Community routes
backend/app/api/v1/community.py - Journal export
backend/app/api/v1/export.py - AI chat routes
backend/app/api/v1/ai_chat.py
Travel domain
- Travel progression rules
backend/app/services/travel.py - Destination records
backend/app/models/destination.py - Travel records
backend/app/models/travel.py - User records
backend/app/models/user.py - Community records
backend/app/models/community.py
Runtime and persistence
- Database sessions
backend/app/db/session.py - Cache and rate limits
backend/app/core/cache.py - Runtime configuration
backend/app/core/config.py
Other components
- Traveler
- Open-Meteo services
- OSRM routing
- Google Maps directions
Connections 40
- Traveler → App shell: uses
frontend/src/App.tsx - App shell → Destination discovery: renders
frontend/src/App.tsx - App shell → Passport journal: renders
frontend/src/App.tsx - App shell → Trip planning: renders
frontend/src/App.tsx - App shell → Community stories: renders
frontend/src/App.tsx - App shell → Atlas maps: renders
frontend/src/App.tsx - App shell → Destination weather: renders
frontend/src/App.tsx - App shell → Sign-in form: renders
frontend/src/App.tsx - App shell → User preferences: uses
frontend/src/App.tsx - App shell → Travel API client: loads passport
frontend/src/App.tsx - Sign-in form → Travel API client: signs in
frontend/src/components/AuthForm.tsx - App shell → Destination catalog client: uses catalog
frontend/src/App.tsx - Atlas maps → Destination catalog client: loads destinations
frontend/src/components/atlas/Atlas.tsx - Passport journal → Travel API client: loads journal
frontend/src/components/PassportPage.tsx - Community stories → Travel API client: requests stories
frontend/src/components/Community.tsx - Trip planning → Route and city lookup: uses routing
- Route and city lookup → Open-Meteo services: geocodes city
frontend/src/api/routes.ts - Route and city lookup → OSRM routing: requests road route
frontend/src/api/routes.ts - Route and city lookup → Google Maps directions: builds directions link
frontend/src/api/routes.ts - Destination weather → Open-Meteo services: gets forecasts
- Travel API client → API application: calls API
- API application → API route registry: mounts routes
backend/app/main.py - API route registry → Authentication routes: registers
backend/app/api/v1/api.py - API route registry → Destination routes: registers
backend/app/api/v1/api.py - API route registry → Travel routes: registers
backend/app/api/v1/api.py - API route registry → Community routes: registers
backend/app/api/v1/api.py - API route registry → Journal export: registers
backend/app/api/v1/api.py - API route registry → AI chat routes: registers
backend/app/api/v1/api.py - API application → Database sessions: opens sessions
backend/app/main.py - API application → Cache and rate limits: initializes cache
backend/app/main.py - API application → Runtime configuration: reads settings
backend/app/main.py - Authentication routes → Database sessions: uses sessions
backend/app/api/v1/auth.py - Authentication routes → Cache and rate limits: rate limits
backend/app/api/v1/auth.py - Authentication routes → Runtime configuration: uses security settings
backend/app/api/v1/auth.py - Database sessions → Destination records: stores
backend/app/models/destination.py - Database sessions → Travel records: stores
backend/app/models/travel.py - Database sessions → User records: stores
backend/app/models/user.py - Database sessions → Community records: stores
backend/app/models/community.py - API application → Travel progression rules: loads progression rules
backend/app/main.py - API application → Destination records: seeds catalog
backend/app/main.py