How azurezephyry/wildfinds-next works
WildFinds is a campus lost-and-found platform. The main user flow is browse/filter active item reports, open details, and submit lost/found reports; authenticated users can review their reports and resolved-item history. Signup/login and a prototype claim/match flow are additional capabilities. Live item and report persistence use Supabase, while README-described claim/match routes remain mock/local-state prototypes. The graph reflects documented capabilities and indexed call references; some unsampled implementation links are omitted rather than inferred.
Main entry points: page.tsx Claim route · ItemCatalog.tsx Item catalog · submitItemReport.ts Create report workflow · browserSupabaseClient.ts Browser Supabase client
Components 24
App experience
- Browse home
src/app/page.tsx - Item details route
src/app/item/[id]/page.tsx - Claim route
src/app/item/[id]/claim/page.tsx - Lost/found report routes
src/app/report/lost/page.tsx - Signup and login
src/features/authentication/signup/components/SignupScreen.tsx
Item discovery
- Item catalog
src/features/items/browsing/components/ItemCatalog.tsx - Load public items
src/features/items/browsing/hooks/usePublicItems.ts - Search and filter
src/features/items/browsing/hooks/useFilteredItems.ts - Item detail screen
src/features/items/details/components/ItemDetailsScreen.tsx
Reporting
- Report submission screen
src/features/reports/submission/components/ReportSubmissionScreen.tsx - Report form
src/features/reports/submission/components/ReportSubmissionForm.tsx - Form state and validation
src/features/reports/submission/hooks/useReportSubmissionForm.ts - Create report workflow
src/features/reports/submission/workflows/submitItemReport.ts - Image upload
src/features/reports/submission/storage/uploadReportImage.ts - My reports
src/features/reports/personal/hooks/usePersonalReports.ts - Resolved-item history
src/features/items/history/queries/fetchResolvedItems.ts
Identity and claims
- Claim eligibility context
src/features/claims/submission/queries/fetchClaimSubmissionContext.ts - Claim submission form
src/app/item/[id]/claim/ClaimSubmissionForm.tsx - Submit claim workflow
src/features/claims/submission/workflows/submitClaim.ts - Mock match prototype
src/legacy/claim-match-prototype/components/LegacyMatchScreen.tsx - Authentication state
src/core/authentication/components/AuthenticationProvider.tsx
Supabase platform
- Browser Supabase client
src/infrastructure/supabase/clients/browserSupabaseClient.ts - Supabase services
Other components
- Campus user
Connections 26
- Campus user → Browse home: browses
- Browse home → Item catalog: shows catalog
- Item catalog → Load public items: loads items
- Item catalog → Search and filter: filters items
- Load public items → Browser Supabase client: queries via
src/features/items/browsing/hooks/usePublicItems.ts - Browser Supabase client → Supabase services: connects
- Item details route → Item detail screen: renders
src/app/item/[id]/page.tsx - Item detail screen → Claim route: offers claim
- Claim route → Claim eligibility context: fetches context
src/app/item/[id]/claim/page.tsx - Claim route → Claim submission form: renders
src/app/item/[id]/claim/page.tsx - Claim submission form → Submit claim workflow: submits
src/app/item/[id]/claim/ClaimSubmissionForm.tsx - Campus user → Lost/found report routes: reports item
- Lost/found report routes → Report submission screen: renders
src/app/report/lost/page.tsx - Report submission screen → Report form: renders
src/features/reports/submission/components/ReportSubmissionScreen.tsx - Report form → Form state and validation: manages values
- Form state and validation → Create report workflow: validates and submits
- Create report workflow → Image upload: uploads image
- Create report workflow → Supabase services: persists report
- Campus user → Signup and login: creates account
- Authentication state → Browser Supabase client: reads auth session
src/core/authentication/components/AuthenticationProvider.tsx - Signup and login → Supabase services: authenticates
- Campus user → My reports: views submissions
- My reports → Supabase services: reads owned reports
- Campus user → Resolved-item history: views resolved items
- Resolved-item history → Supabase services: reads history
- Campus user → Mock match prototype: tries prototype claim/match