How hsu-isaac/tripmap works
TripMap is a map-based trip-planning application. Users create trips, search for places, organize points into layers and categories, plan routes, and view the result on an interactive map; they can share trips with different visibility settings. The graph includes documented collaboration, cloning, and mobile capabilities. Source excerpts show API, authentication, and persistence behavior, but not most client-to-API wiring, so those links are omitted or marked unverified.
Main entry points: middleware.ts Authentication · helpers.ts API access and validation · TripDetailClient.tsx Trip detail client · route.ts Trip management API
Components 24
Trip experience
- Trip pages
src/app/trips/[tripId]/page.tsx - Trip detail client
src/app/trips/[tripId]/TripDetailClient.tsx - Interactive map
src/components/map/TripMap.tsx - Trip listing
src/app/trips/TripsClient.tsx - Mobile views
src/components/trip-detail/MobileTripContent.tsx
Trip planning
- Trip editing controls
src/components/trip-detail/TripSidebar.tsx - Drag-and-drop logic
src/hooks/useDragHandlers.ts - Location search
src/components/trip-detail/LocationSearch.tsx - Route planning
src/components/trip-detail/AddRouteModal.tsx - Sharing controls
src/components/trip-detail/ShareModal.tsx
API workflows
- Trip management API
src/app/api/trips/route.ts - Trip detail API
src/app/api/trips/[tripId]/route.ts - Point API
src/app/api/trips/[tripId]/points/route.ts - Route API
src/app/api/trips/[tripId]/routes/route.ts - Place search API
src/app/api/geocode/route.ts - Trip cloning API
src/app/api/trips/[tripId]/clone/route.ts - Invitations API
src/app/api/trips/[tripId]/invitations/route.ts
Identity and access
- Authentication
src/lib/auth/middleware.ts - API access and validation
src/lib/api/helpers.ts - Supabase client
src/lib/supabase/server.ts - Trip data store
External services
- Google Places
- Google Maps
Other components
- Traveler
Connections 38
- Traveler → Trip listing: browses trips
README.md - Traveler → Trip pages: plans a trip
README.md - Trip pages → Trip detail client: renders
- Trip detail client → Trip editing controls: uses controls
- Trip detail client → Interactive map: shows locations
README.md - Trip detail client → Mobile views: adapts for mobile
README.md - Trip detail client → Trip detail API: loads trip
- Trip listing → Trip management API: loads and creates trips
- Trip editing controls → Drag-and-drop logic: handles rearrangement
- Drag-and-drop logic → Trip editing controls: invokes reorder or move
src/hooks/useDragHandlers.ts - Trip editing controls → Point API: updates points
- Location search → Place search API: searches places
- Place search API → Google Places: requests suggestions
src/app/api/geocode/route.ts - Trip editing controls → Route planning: opens route planning
- Route planning → Route API: saves routes
- Sharing controls → Invitations API: manages invitations
- Sharing controls → Trip detail API: sets visibility
- Trip management API → Authentication: requires authentication
src/app/api/trips/route.ts - Trip management API → Trip data store: reads and writes trips
src/app/api/trips/route.ts - Trip management API → Trip data store: creates default layer
src/app/api/trips/route.ts - Trip management API → API access and validation: validates and formats errors
src/app/api/trips/route.ts - Trip detail API → Supabase client: creates client
src/app/api/trips/[tripId]/route.ts - Trip detail API → Trip data store: reads trip and contents
src/app/api/trips/[tripId]/route.ts - Trip detail API → API access and validation: checks access
src/app/api/trips/[tripId]/route.ts - Point API → Authentication: requires authentication
src/app/api/trips/[tripId]/points/route.ts - Point API → API access and validation: checks access and validates
src/app/api/trips/[tripId]/points/route.ts - Point API → Trip data store: reads and writes points
src/app/api/trips/[tripId]/points/route.ts - Route API → Authentication: requires authentication
src/app/api/trips/[tripId]/routes/route.ts - Route API → Trip data store: reads and writes routes
src/app/api/trips/[tripId]/routes/route.ts - Route API → API access and validation: validates requests
src/app/api/trips/[tripId]/routes/route.ts - Place search API → Authentication: requires authentication
src/app/api/geocode/route.ts - Place search API → API access and validation: formats errors
src/app/api/geocode/route.ts - Trip cloning API → Authentication: requires authentication
src/app/api/trips/[tripId]/clone/route.ts - Trip cloning API → API access and validation: checks access and validates
src/app/api/trips/[tripId]/clone/route.ts - Trip cloning API → Trip data store: copies trip content
src/app/api/trips/[tripId]/clone/route.ts - Authentication → Supabase client: creates client
src/lib/auth/middleware.ts - Supabase client → Trip data store: connects to
src/lib/supabase/server.ts - Interactive map → Google Maps: renders map
README.md