# azurezephyry/wildfinds-next architecture

> Architecture diagram of the GitHub repository azurezephyry/wildfinds-next, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azurezephyry/wildfinds-next
- Repository: https://github.com/azurezephyry/wildfinds-next

## Overview

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: [`src/app/item/[id]/claim/page.tsx`](https://github.com/azurezephyry/wildfinds-next/blob/main/src/app/item/%5Bid%5D/claim/page.tsx) (Claim route), [`src/features/items/browsing/components/ItemCatalog.tsx`](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/items/browsing/components/ItemCatalog.tsx) (Item catalog), [`src/features/reports/submission/workflows/submitItemReport.ts`](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/submission/workflows/submitItemReport.ts) (Create report workflow), [`src/infrastructure/supabase/clients/browserSupabaseClient.ts`](https://github.com/azurezephyry/wildfinds-next/blob/main/src/infrastructure/supabase/clients/browserSupabaseClient.ts) (Browser Supabase client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_home["Browse home<br/>[page.tsx]"]
  node_item_detail_route["Item details route<br/>[page.tsx]"]
  node_claim_route["Claim route<br/>[page.tsx]"]
  node_report_route["Lost/found report routes<br/>[page.tsx]"]
  node_auth_ui["Signup and login<br/>[SignupScreen.tsx]"]
end

subgraph group_items["Item discovery"]
  node_item_browse["Item catalog<br/>[ItemCatalog.tsx]"]
  node_item_load["Load public items<br/>[usePublicItems.ts]"]
  node_item_filter["Search and filter"]
  node_item_detail["Item detail screen"]
end

subgraph group_reporting["Reporting"]
  node_report_screen["Report submission screen"]
  node_report_form["Report form"]
  node_report_state["Form state and validation"]
  node_report_workflow["Create report workflow"]
  node_report_storage["Image upload"]
  node_my_reports["My reports"]
  node_history["Resolved-item history"]
end

subgraph group_identity["Identity and claims"]
  node_claim_context["Claim eligibility context"]
  node_claim_form["Claim submission form"]
  node_claim_submit["Submit claim workflow<br/>[submitClaim.ts]"]
  node_legacy_match["Mock match prototype"]
  node_auth_provider["Authentication state"]
end

subgraph group_platform["Supabase platform"]
  node_supabase_client["Browser Supabase client"]
  node_supabase[("Supabase services")]
end

node_visitor(("Campus user"))

node_visitor -->|"browses"| node_home
node_home -.->|"shows catalog"| node_item_browse
node_item_browse -.->|"loads items"| node_item_load
node_item_browse -.->|"filters items"| node_item_filter
node_item_load -->|"queries via"| node_supabase_client
node_supabase_client -->|"connects"| node_supabase
node_item_detail_route -->|"renders"| node_item_detail
node_item_detail -.->|"offers claim"| node_claim_route
node_claim_route -->|"fetches context"| node_claim_context
node_claim_route -->|"renders"| node_claim_form
node_claim_form -->|"submits"| node_claim_submit
node_visitor -->|"reports item"| node_report_route
node_report_route -->|"renders"| node_report_screen
node_report_screen -->|"renders"| node_report_form
node_report_form -.->|"manages values"| node_report_state
node_report_state -.->|"validates and submits"| node_report_workflow
node_report_workflow -.->|"uploads image"| node_report_storage
node_report_workflow -.->|"persists report"| node_supabase
node_visitor -->|"creates account"| node_auth_ui
node_auth_provider -->|"reads auth session"| node_supabase_client
node_auth_ui -.->|"authenticates"| node_supabase
node_visitor -->|"views submissions"| node_my_reports
node_my_reports -.->|"reads owned reports"| node_supabase
node_visitor -->|"views resolved items"| node_history
node_history -.->|"reads history"| node_supabase
node_visitor -->|"tries prototype claim/match"| node_legacy_match

click node_home "https://github.com/azurezephyry/wildfinds-next/blob/main/src/app/page.tsx"
click node_item_browse "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/items/browsing/components/ItemCatalog.tsx"
click node_item_load "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/items/browsing/hooks/usePublicItems.ts"
click node_item_filter "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/items/browsing/hooks/useFilteredItems.ts"
click node_item_detail_route "https://github.com/azurezephyry/wildfinds-next/blob/main/src/app/item/%5Bid%5D/page.tsx"
click node_item_detail "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/items/details/components/ItemDetailsScreen.tsx"
click node_claim_context "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/claims/submission/queries/fetchClaimSubmissionContext.ts"
click node_claim_route "https://github.com/azurezephyry/wildfinds-next/blob/main/src/app/item/%5Bid%5D/claim/page.tsx"
click node_claim_form "https://github.com/azurezephyry/wildfinds-next/blob/main/src/app/item/%5Bid%5D/claim/ClaimSubmissionForm.tsx"
click node_claim_submit "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/claims/submission/workflows/submitClaim.ts"
click node_legacy_match "https://github.com/azurezephyry/wildfinds-next/blob/main/src/legacy/claim-match-prototype/components/LegacyMatchScreen.tsx"
click node_report_route "https://github.com/azurezephyry/wildfinds-next/blob/main/src/app/report/lost/page.tsx"
click node_report_screen "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/submission/components/ReportSubmissionScreen.tsx"
click node_report_form "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/submission/components/ReportSubmissionForm.tsx"
click node_report_state "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/submission/hooks/useReportSubmissionForm.ts"
click node_report_workflow "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/submission/workflows/submitItemReport.ts"
click node_report_storage "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/submission/storage/uploadReportImage.ts"
click node_my_reports "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/personal/hooks/usePersonalReports.ts"
click node_history "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/items/history/queries/fetchResolvedItems.ts"
click node_auth_ui "https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/authentication/signup/components/SignupScreen.tsx"
click node_auth_provider "https://github.com/azurezephyry/wildfinds-next/blob/main/src/core/authentication/components/AuthenticationProvider.tsx"
click node_supabase_client "https://github.com/azurezephyry/wildfinds-next/blob/main/src/infrastructure/supabase/clients/browserSupabaseClient.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_item_detail_route,node_claim_route,node_report_route,node_auth_ui,node_visitor toneBlue
class node_item_browse,node_item_load,node_item_filter,node_item_detail toneAmber
class node_report_screen,node_report_form,node_report_state,node_report_workflow,node_report_storage,node_my_reports,node_history toneMint
class node_claim_context,node_claim_form,node_claim_submit,node_legacy_match,node_auth_provider toneRose
class node_supabase_client,node_supabase toneIndigo
```

## Components

### App experience

- [Browse home](https://github.com/azurezephyry/wildfinds-next/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Item details route](https://github.com/azurezephyry/wildfinds-next/blob/main/src/app/item/%5Bid%5D/page.tsx): `src/app/item/[id]/page.tsx`
- [Claim route](https://github.com/azurezephyry/wildfinds-next/blob/main/src/app/item/%5Bid%5D/claim/page.tsx): `src/app/item/[id]/claim/page.tsx`
- [Lost/found report routes](https://github.com/azurezephyry/wildfinds-next/blob/main/src/app/report/lost/page.tsx): `src/app/report/lost/page.tsx`
- [Signup and login](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/authentication/signup/components/SignupScreen.tsx): `src/features/authentication/signup/components/SignupScreen.tsx`

### Item discovery

- [Item catalog](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/items/browsing/components/ItemCatalog.tsx): `src/features/items/browsing/components/ItemCatalog.tsx`
- [Load public items](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/items/browsing/hooks/usePublicItems.ts): `src/features/items/browsing/hooks/usePublicItems.ts`
- [Search and filter](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/items/browsing/hooks/useFilteredItems.ts): `src/features/items/browsing/hooks/useFilteredItems.ts`
- [Item detail screen](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/items/details/components/ItemDetailsScreen.tsx): `src/features/items/details/components/ItemDetailsScreen.tsx`

### Reporting

- [Report submission screen](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/submission/components/ReportSubmissionScreen.tsx): `src/features/reports/submission/components/ReportSubmissionScreen.tsx`
- [Report form](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/submission/components/ReportSubmissionForm.tsx): `src/features/reports/submission/components/ReportSubmissionForm.tsx`
- [Form state and validation](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/submission/hooks/useReportSubmissionForm.ts): `src/features/reports/submission/hooks/useReportSubmissionForm.ts`
- [Create report workflow](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/submission/workflows/submitItemReport.ts): `src/features/reports/submission/workflows/submitItemReport.ts`
- [Image upload](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/submission/storage/uploadReportImage.ts): `src/features/reports/submission/storage/uploadReportImage.ts`
- [My reports](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/reports/personal/hooks/usePersonalReports.ts): `src/features/reports/personal/hooks/usePersonalReports.ts`
- [Resolved-item history](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/items/history/queries/fetchResolvedItems.ts): `src/features/items/history/queries/fetchResolvedItems.ts`

### Identity and claims

- [Claim eligibility context](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/claims/submission/queries/fetchClaimSubmissionContext.ts): `src/features/claims/submission/queries/fetchClaimSubmissionContext.ts`
- [Claim submission form](https://github.com/azurezephyry/wildfinds-next/blob/main/src/app/item/%5Bid%5D/claim/ClaimSubmissionForm.tsx): `src/app/item/[id]/claim/ClaimSubmissionForm.tsx`
- [Submit claim workflow](https://github.com/azurezephyry/wildfinds-next/blob/main/src/features/claims/submission/workflows/submitClaim.ts): `src/features/claims/submission/workflows/submitClaim.ts`
- [Mock match prototype](https://github.com/azurezephyry/wildfinds-next/blob/main/src/legacy/claim-match-prototype/components/LegacyMatchScreen.tsx): `src/legacy/claim-match-prototype/components/LegacyMatchScreen.tsx`
- [Authentication state](https://github.com/azurezephyry/wildfinds-next/blob/main/src/core/authentication/components/AuthenticationProvider.tsx): `src/core/authentication/components/AuthenticationProvider.tsx`

### Supabase platform

- [Browser Supabase client](https://github.com/azurezephyry/wildfinds-next/blob/main/src/infrastructure/supabase/clients/browserSupabaseClient.ts): `src/infrastructure/supabase/clients/browserSupabaseClient.ts`
- **Supabase services**

### Other components

- **Campus user**

## Connections

- 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 (evidence: `src/features/items/browsing/hooks/usePublicItems.ts`)
- Browser Supabase client → Supabase services: connects
- Item details route → Item detail screen: renders (evidence: `src/app/item/[id]/page.tsx`)
- Item detail screen → Claim route: offers claim
- Claim route → Claim eligibility context: fetches context (evidence: `src/app/item/[id]/claim/page.tsx`)
- Claim route → Claim submission form: renders (evidence: `src/app/item/[id]/claim/page.tsx`)
- Claim submission form → Submit claim workflow: submits (evidence: `src/app/item/[id]/claim/ClaimSubmissionForm.tsx`)
- Campus user → Lost/found report routes: reports item
- Lost/found report routes → Report submission screen: renders (evidence: `src/app/report/lost/page.tsx`)
- Report submission screen → Report form: renders (evidence: `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 (evidence: `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
