How mina-gerguis/qareeb works
Cairo Map is a Next.js application for discovering places and navigating transit in Egypt, with supporting community, account, editorial, and administrative features. The likely user journey is to choose a travel mode or destination, consult route or location information, and use related place details; the tree also shows dedicated airport, BRT, and AI-planner experiences. The graph preserves these major product areas, but excerpts do not establish most page-to-page calls or data flows, so those links are omitted rather than inferred. Admin management is represented as a subsystem because its detailed runtime wiring was not sampled.
Main entry points: AuthContext.tsx Authentication · supabase.ts Supabase Client · RouteSearchCard.tsx Route Search · ReviewSection.tsx Place Reviews
Components 18
Place Discovery
- Map Experience
src/app/map/hooks/useMapData.ts - Place Catalog
src/data/places.ts - Place Reviews
src/components/ReviewSection.tsx - Review Data Hook
src/app/places/[id]/reviews/hooks/usePlaceReviews.ts
Transit Navigation
- Route Search
src/components/common/RouteSearchCard/RouteSearchCard.tsx - Directions
src/app/directions/components/RouteSearchCard.tsx - Popular Routes
src/app/directions/components/PopularRoutesSlider.tsx - Route Data
src/data/directions_routes.ts - Airport Guide
src/app/airports/page.tsx - BRT Guide
src/app/brt/page.tsx
Accounts And Community
- Authentication
src/context/AuthContext.tsx - Supabase Client
src/lib/supabase.ts - Notifications
src/context/NotificationContext.tsx
Content And Assistance
- Blog Browser
src/components/blog/useBlogArticles.ts - AI Chat API
src/app/api/ai-chat/route.ts
Operations
- Application Shell
src/components/ClientLayoutWrapper.tsx - Admin Console
src/app/admin
Other components
- Traveler
Connections 17
- Traveler → Route Search: chooses route
- Route Search → Directions: submits search
- Directions → Route Data: uses route data
- Traveler → Airport Guide: browses airports
- Traveler → BRT Guide: browses BRT
- Traveler → Map Experience: explores map
- Place Reviews → Authentication: reads user
src/components/ReviewSection.tsx - Place Reviews → Supabase Client: reads and writes reviews
src/components/ReviewSection.tsx - Review Data Hook → Supabase Client: fetches reviews
src/app/places/[id]/reviews/hooks/usePlaceReviews.ts - Review Data Hook → Place Catalog: uses place type
src/app/places/[id]/reviews/hooks/usePlaceReviews.ts - Authentication → Supabase Client: uses client
src/context/AuthContext.tsx - Authentication → Application Shell: provides session
src/components/ClientLayoutWrapper.tsx - Application Shell → Authentication: reads account state
src/components/ClientLayoutWrapper.tsx - Blog Browser → Authentication: reads user
src/components/blog/useBlogArticles.ts - Blog Browser → Supabase Client: loads articles
src/components/blog/useBlogArticles.ts - Traveler → AI Chat API: requests assistance
- Route Search → Traveler: accepts voice input