How pompomiiiii/cafe-scout works
Café Scout is a location-based café discovery web app. Its main workflow is to obtain the user's location, retrieve and rank nearby cafés, then present them in a filterable list and interactive Google Map with synchronized selection. A separate chat workflow sends café context and a request to Gemini, then displays suggested cafés that can be selected in the app. The README documents the product capabilities; edges are limited to relationships visible in excerpts or explicitly documented.
Main entry points: App.jsx App coordinator · useCafes.js Cafe data hook · ChatPanel.jsx Chat panel · geminiApi.js Gemini service
Components 16
Café discovery
- Location hook
cafe-scout/src/hooks/useLocation.js - Places search
cafe-scout/src/services/placesApi.js - Cafe data hook
cafe-scout/src/hooks/useCafes.js - Search filters
cafe-scout/src/components/FilterBar.jsx
Browse and map
- Café list
cafe-scout/src/components/CafeList.jsx - Café card
cafe-scout/src/components/CafeCard.jsx - Interactive map
cafe-scout/src/components/MapView.jsx
AI assistant
- Chat panel
cafe-scout/src/components/ChatPanel.jsx - Gemini service
cafe-scout/src/services/geminiApi.js - Café prompt
cafe-scout/src/services/prompts/cafePrompt.js
App experience
- App coordinator
cafe-scout/src/App.jsx - Bean character
cafe-scout/src/components/BeanCharacter.jsx
Other components
- User
- Google Places
- Google Maps
- Gemini API
Connections 21
- User → App coordinator: uses
- App coordinator → Location hook: reads location
cafe-scout/src/App.jsx - Location hook → User: requests GPS
cafe-scout/src/hooks/useLocation.js - App coordinator → Cafe data hook: loads cafés
cafe-scout/src/App.jsx - Cafe data hook → Places search: fetches nearby
cafe-scout/src/hooks/useCafes.js - Places search → Google Places: searches cafés
cafe-scout/src/services/placesApi.js - Cafe data hook → Search filters: applies preferences
- App coordinator → Search filters: renders
cafe-scout/src/App.jsx - App coordinator → Café list: renders
cafe-scout/src/App.jsx - Café list → Café card: renders cards
cafe-scout/src/components/CafeList.jsx - App coordinator → Interactive map: renders
cafe-scout/src/App.jsx - Interactive map → Google Maps: loads map
cafe-scout/src/components/MapView.jsx - App coordinator → Chat panel: renders
cafe-scout/src/App.jsx - App coordinator → Bean character: renders
cafe-scout/src/App.jsx - Bean character → App coordinator: toggles chat
cafe-scout/src/App.jsx - Chat panel → Gemini service: asks
cafe-scout/src/components/ChatPanel.jsx - Gemini service → Café prompt: builds prompt
cafe-scout/src/services/geminiApi.js - Gemini service → Gemini API: generates response
cafe-scout/src/services/geminiApi.js - Chat panel → App coordinator: selects suggestion
cafe-scout/src/App.jsx - App coordinator → Interactive map: passes selection
cafe-scout/src/App.jsx - App coordinator → Café list: passes selection
cafe-scout/src/App.jsx