How jksurampudi5/findlostpuppy works
FindLostPuppy helps pet owners create missing-dog listings and coordinate reunions with neighbors who can search listings and submit sightings. Its main journey moves through consent and sign-in, owner/location and dog setup, a lost report, then community discovery and owner follow-up. The README documents approximate public locations, photo sightings, reunion status changes, and dashboards. The graph uses the documented routes and sampled service relationships; wiring among unsampled feature pages is intentionally not inferred.
Main entry points: App.tsx App Router · AuthContext.tsx Auth Context · firebaseSyncService.ts Firebase Sync · EmailAuthPage.tsx Sign In
Components 25
Owner Journey
- App Router
src/App.tsx - Consent
src/pages/ConsentPage.tsx - Sign In
src/pages/EmailAuthPage.tsx - Owner Profile
src/pages/PetParentContactPage.tsx - Location Setup
src/pages/LocationOnboardingPage.tsx - Dog Profile
src/pages/DogOnboardingPage.tsx - Lost Report
src/pages/ReportWizardPage.tsx
Community Response
- Discovery
src/pages/DiscoveryPage.tsx - Dog Details
src/pages/DogDetailPage.tsx - Guest Sighting
src/pages/GuestSightingPage.tsx - Owner Dashboard
src/pages/DashboardPage.tsx - Admin Tools
src/pages/AdminDashboardPage.tsx
Application Services
- Auth Context
src/context/AuthContext.tsx - Authentication
src/services/authService.ts - Consent State
src/services/consentService.ts - Location Services
src/services/locationService.ts - Storage Service
src/services/storageService.ts - Firebase Sync
src/services/firebaseSyncService.ts - Media Storage
src/services/storageBucketService.ts
Persistence & Integrations
- Local Storage
- Firestore
- Firebase Auth
- Firebase Storage
Other components
- Pet Owner
- Community Member
Connections 23
- Pet Owner → App Router: uses
- Community Member → App Router: uses
- App Router → Consent: routes
- App Router → Sign In: routes
- App Router → Owner Profile: routes
- App Router → Location Setup: routes
- App Router → Dog Profile: routes
- App Router → Lost Report: routes
- App Router → Discovery: routes
- App Router → Dog Details: routes
- App Router → Guest Sighting: routes
- App Router → Owner Dashboard: routes
- App Router → Admin Tools: routes
- Sign In → Auth Context: signs in
- Auth Context → Authentication: authenticates
- Authentication → Firebase Auth: calls
- Auth Context → Consent State: checks consent
- Auth Context → Storage Service: loads data
- Auth Context → Firebase Sync: pulls data
- Storage Service → Local Storage: reads/writes
- Firebase Sync → Firestore: reads/writes
- Firebase Sync → Media Storage: deletes media
- Media Storage → Firebase Storage: uploads/deletes