How keerthipatil600/coastal-side-wanderer works
CoastWise AI is a Coastal Karnataka trip-planning application. A traveler submits trip preferences through the planning flow; the server-side engine retrieves curated knowledge, ranks and routes options, fits costs to budget, and can use an LLM for itinerary narrative. Users can explore itinerary details, save trips offline, manage favorites, and submit feedback. The README also describes admin knowledge-base ingestion and booking/map integrations; links for unsampled implementation details are omitted or marked optional.
Main entry points: ItineraryView.tsx Itinerary view · engine.server.ts Trip engine · plan.functions.ts Plan functions · dashboard.tsx Trip dashboard
Components 20
Trip planning
- CoastWise home
src/routes/index.tsx - Trip preferences
src/components/coastwise/TripForm.tsx - Plan route
src/routes/plan.tsx - Plan functions
src/lib/coastwise/plan.functions.ts
Planning engine
- Trip engine
src/lib/coastwise/engine.server.ts - Knowledge retrieval
src/lib/coastwise/kb.server.ts - LLM narrative
src/lib/coastwise/ai.server.ts
Trip experience
- Itinerary view
src/components/coastwise/ItineraryView.tsx - Budget breakdown
src/components/coastwise/BudgetPanel.tsx - Trip assistant
src/components/coastwise/Assistant.tsx - Route maps
src/lib/coastwise/maps.functions.ts - Trip map
src/components/coastwise/TripMap.tsx - Booking links
src/lib/coastwise/booking.ts - Trip dashboard
src/routes/dashboard.tsx
Persistence and integrations
- Local trip storage
src/lib/coastwise/storage.ts - Offline cache
public/sw.js - Admin tools
src/routes/admin.tsx
Other components
- Traveler
- LLM service
- Supabase
Connections 21
- Traveler → CoastWise home: opens
- CoastWise home → Plan route: starts planning
- Plan route → Trip preferences: collects input
- Trip preferences → Plan functions: submits trip
- Plan functions → Trip engine: builds plan
- Trip engine → Knowledge retrieval: retrieves records
- Trip engine → Knowledge retrieval: loads feedback signal
- Trip engine → LLM narrative: requests narrative
- LLM narrative → LLM service: generates copy
- Plan functions → Itinerary view: returns plan
- Itinerary view → Budget breakdown: shows costs
- Itinerary view → Trip map: shows route
- Trip map → Route maps: requests map data
- Itinerary view → Booking links: offers booking links
- Trip assistant → Plan functions: requests trip changes
- Traveler → Trip dashboard: manages trips
- Trip dashboard → Local trip storage: reads and saves
- Itinerary view → Local trip storage: saves trip and feedback
- Offline cache → Trip dashboard: serves cached shell
- Admin tools → Knowledge retrieval: manages knowledge base
- Admin tools → Supabase: admin data access