How alaaeddine20/pet-rescue works
This is a React Native animal-rescue reporting app with separate citizen and organization experiences. The main workflow is sign-in or onboarding, submitting a located and photographed animal report, then viewing its status; organization members can browse relevant reports and claim pending cases. Authentication/profile state and Supabase-backed services form the key internal layer. The README is empty, and several routes and services were not excerpted, so those relationships are included only where the SOURCE INDEX supports them; the RUNTS external integration remains unverified.
Main entry points: useAuthContext.ts Auth hook · supabase.ts Supabase client · new.tsx New report screen · report.ts Report service
Components 28
Access and onboarding
- App shell
src/app/_layout.tsx - Sign-in screen
src/app/(auth)/NoAuthScreen.tsx - Sign-in form
src/components/SignInForm.tsx - Sign-up form
src/components/SignUpForm.tsx - Auth provider
src/providers/AuthProvider.tsx - Auth context
src/context/AuthContext.ts - Auth hook
src/hooks/useAuthContext.ts - Auth errors
src/mappers/authErrorMapper.ts - Organization onboarding
src/app/onboarding/organization.tsx - Onboarding hook
src/hooks/useOnboarding.ts - RUNTS lookup hook
src/hooks/useRuntsEntityByTaxCode.ts
Citizen reporting
- Citizen home
src/app/(app)/CitizenHomeScreen.tsx - New report screen
src/app/(app)/report/new.tsx - Current location
src/hooks/useCurrentLocation.ts - Photo picker
src/components/PhotoPicker.tsx - Citizen reports hook
src/hooks/useReports.ts - Report list
src/components/ReportList.tsx
Organization response
- Organization home
src/app/(app)/OrganizationHomeScreen.tsx - Organization reports hook
src/hooks/useOrganizationReports.ts - Claim reports hook
src/hooks/useClaimReports.ts
Identity and data
- Onboarding service
src/services/onboarding.ts - RUNTS service
src/services/runts.ts - Report service
src/services/report.ts - Profile service
src/services/profile.ts - Supabase client
src/lib/supabase.ts
Other components
- App user
- RUNTS registry
- Supabase
Connections 40
- App user → App shell: opens
- App shell → Auth provider: provides auth
src/app/_layout.tsx - App shell → Auth hook: reads auth
src/app/_layout.tsx - App user → Sign-in screen: signs in
- Sign-in screen → Sign-in form: renders
src/app/(auth)/NoAuthScreen.tsx - Sign-in screen → Sign-up form: renders
src/app/(auth)/NoAuthScreen.tsx - Sign-in form → Auth hook: uses auth
src/components/SignInForm.tsx - Sign-up form → Auth hook: uses auth
src/components/SignUpForm.tsx - Sign-in form → Auth errors: maps errors
src/components/SignInForm.tsx - Sign-up form → Auth errors: maps errors
src/components/SignUpForm.tsx - Auth provider → Auth context: provides state
src/providers/AuthProvider.tsx - Auth hook → Auth context: reads context
src/hooks/useAuthContext.ts - Auth provider → Profile service: loads profile
src/providers/AuthProvider.tsx - Auth provider → Supabase client: auth operations
src/providers/AuthProvider.tsx - App user → Organization onboarding: enters details
- Organization onboarding → Onboarding hook: submits onboarding
src/app/onboarding/organization.tsx - Organization onboarding → RUNTS lookup hook: checks tax code
src/app/onboarding/organization.tsx - Onboarding hook → Onboarding service: saves profile
src/hooks/useOnboarding.ts - RUNTS lookup hook → RUNTS service: looks up entity
src/hooks/useRuntsEntityByTaxCode.ts - RUNTS service → Supabase client: queries data
src/services/runts.ts - RUNTS service → RUNTS registry: registry lookup
- Onboarding service → Supabase client: writes data
src/services/onboarding.ts - App user → Citizen home: views reports
- Citizen home → Citizen reports hook: loads reports
src/app/(app)/CitizenHomeScreen.tsx - Citizen home → Report list: renders
src/app/(app)/CitizenHomeScreen.tsx - App user → New report screen: creates report
- New report screen → Auth hook: gets user
src/app/(app)/report/new.tsx - New report screen → Current location: gets location
src/app/(app)/report/new.tsx - New report screen → Photo picker: captures photo
src/app/(app)/report/new.tsx - New report screen → Report service: creates report
src/app/(app)/report/new.tsx - Citizen reports hook → Report service: loads reports
- App user → Organization home: views cases
- Organization home → Organization reports hook: loads cases
src/app/(app)/OrganizationHomeScreen.tsx - Organization home → Claim reports hook: claims case
src/app/(app)/OrganizationHomeScreen.tsx - Organization reports hook → Report service: fetches cases
src/hooks/useOrganizationReports.ts - Claim reports hook → Report service: claims report
src/hooks/useClaimReports.ts - Claim reports hook → Auth hook: gets responder
src/hooks/useClaimReports.ts - Report service → Supabase client: reads and writes
src/services/report.ts - Profile service → Supabase client: loads profile
src/services/profile.ts - Supabase client → Supabase: connects
src/lib/supabase.ts