# parth-2305/reclaim-hacksphere-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/parth-2305/reclaim-hacksphere-2026
- Repository: https://github.com/parth-2305/reclaim-hacksphere-2026

## Overview

RECLAIM is a college lost-and-found web app. Users submit lost or found reports; the app stores report data and photos, compares lost/found items, and lets users review matches and verify ownership. The dashboard summarizes reports, match activity, and verification status. The README identifies the product and its MVP scope; the graph’s internal links are based on the supplied source excerpts and SOURCE INDEX, so unsampled behavior is not assumed.

Main entry points: [`src/pages/Dashboard.jsx`](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/Dashboard.jsx) (Dashboard), [`src/App.jsx`](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/App.jsx) (Route application), [`src/pages/Matches.jsx`](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/Matches.jsx) (Matches page), [`src/pages/Verification.jsx`](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/Verification.jsx) (Ownership verification)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_routes["Route application<br/>[App.jsx]"]
  node_layout["Page layout<br/>[Layout.jsx]"]
  node_header["Header<br/>[Header.jsx]"]
  node_sidebar["Sidebar navigation<br/>[Sidebar.jsx]"]
  node_toast_hook["Toast hook<br/>[useToast.js]"]
  node_toast_context["Toast context<br/>[toastContext.js]"]
  node_toast_ui["Toast display<br/>[Toast.jsx]"]
end

subgraph group_reports["Reporting and storage"]
  node_report_lost["Lost report page<br/>[ReportLost.jsx]"]
  node_report_found["Found report page<br/>[ReportFound.jsx]"]
  node_report_form["Report form<br/>[ReportForm.jsx]"]
  node_supabase_client["Supabase client<br/>[supabaseClient.js]"]
end

subgraph group_matching["Matching and verification"]
  node_matches["Matches page<br/>[Matches.jsx]"]
  node_matching_engine["Match scoring<br/>[matching.js]"]
  node_report_status["Report status<br/>[reportStatus.js]"]
  node_verification["Ownership verification<br/>[Verification.jsx]"]
end

subgraph group_views["Results and shared UI"]
  node_home["Home page<br/>[Home.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_page_header["Page header<br/>[PageHeader.jsx]"]
  node_item_thumb["Item thumbnail<br/>[ItemThumb.jsx]"]
  node_status_badge["Status badge<br/>[StatusBadge.jsx]"]
  node_score_ring["Match score ring<br/>[ScoreRing.jsx]"]
  node_stat_card["Summary stat card<br/>[StatCard.jsx]"]
end

node_user(("Campus user"))
node_supabase[("Supabase service")]

node_user -->|"opens app"| node_routes
node_routes -->|"renders routes in"| node_layout
node_routes -->|"routes to"| node_home
node_routes -->|"routes to"| node_report_lost
node_routes -->|"routes to"| node_report_found
node_routes -->|"routes to"| node_matches
node_routes -->|"routes to"| node_verification
node_routes -->|"routes to"| node_dashboard
node_layout -->|"renders"| node_header
node_layout -->|"renders"| node_sidebar
node_report_lost -->|"renders"| node_report_form
node_report_found -->|"renders"| node_report_form
node_report_form -->|"uploads and saves"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase
node_report_form -->|"shows feedback via"| node_toast_hook
node_dashboard -->|"loads report data"| node_supabase_client
node_home -->|"loads data"| node_supabase_client
node_matches -->|"loads report data"| node_supabase_client
node_dashboard -->|"finds matches"| node_matching_engine
node_matches -->|"finds matches"| node_matching_engine
node_verification -->|"checks answer"| node_matching_engine
node_report_status -->|"gets match status"| node_matching_engine
node_dashboard -->|"derives statuses"| node_report_status
node_matches -->|"derives pair status"| node_report_status
node_verification -->|"reads and updates verification"| node_supabase_client
node_report_form -->|"stores report"| node_supabase_client
node_dashboard -->|"renders"| node_stat_card
node_dashboard -->|"renders"| node_page_header
node_dashboard -->|"renders"| node_item_thumb
node_dashboard -->|"renders"| node_status_badge
node_dashboard -->|"renders"| node_score_ring
node_matches -->|"renders"| node_page_header
node_matches -->|"renders"| node_item_thumb
node_matches -->|"renders"| node_status_badge
node_matches -->|"renders"| node_score_ring
node_verification -->|"renders"| node_page_header
node_verification -->|"renders"| node_item_thumb
node_verification -->|"renders"| node_status_badge
node_verification -->|"renders"| node_score_ring
node_report_form -->|"calls"| node_toast_hook
node_toast_hook -->|"reads"| node_toast_context
node_toast_ui -->|"uses"| node_toast_context

click node_routes "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/App.jsx"
click node_layout "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/layout/Layout.jsx"
click node_header "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/layout/Header.jsx"
click node_sidebar "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/layout/Sidebar.jsx"
click node_home "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/Home.jsx"
click node_report_lost "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/ReportLost.jsx"
click node_report_found "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/ReportFound.jsx"
click node_report_form "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/reports/ReportForm.jsx"
click node_supabase_client "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/services/supabaseClient.js"
click node_dashboard "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/Dashboard.jsx"
click node_matches "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/Matches.jsx"
click node_matching_engine "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/services/matching.js"
click node_report_status "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/utils/reportStatus.js"
click node_verification "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/Verification.jsx"
click node_toast_hook "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/hooks/useToast.js"
click node_toast_context "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/hooks/toastContext.js"
click node_toast_ui "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/Toast.jsx"
click node_page_header "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/PageHeader.jsx"
click node_item_thumb "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/ItemThumb.jsx"
click node_status_badge "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/StatusBadge.jsx"
click node_score_ring "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/ScoreRing.jsx"
click node_stat_card "https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/StatCard.jsx"

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_routes,node_layout,node_header,node_sidebar,node_toast_hook,node_toast_context,node_toast_ui,node_user toneBlue
class node_report_lost,node_report_found,node_report_form,node_supabase_client,node_supabase toneAmber
class node_matches,node_matching_engine,node_report_status,node_verification toneMint
class node_home,node_dashboard,node_page_header,node_item_thumb,node_status_badge,node_score_ring,node_stat_card toneRose
```

## Components

### App and navigation

- [Route application](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/App.jsx): `src/App.jsx`
- [Page layout](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/layout/Layout.jsx): `src/components/layout/Layout.jsx`
- [Header](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/layout/Header.jsx): `src/components/layout/Header.jsx`
- [Sidebar navigation](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/layout/Sidebar.jsx): `src/components/layout/Sidebar.jsx`
- [Toast hook](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/hooks/useToast.js): `src/hooks/useToast.js`
- [Toast context](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/hooks/toastContext.js): `src/hooks/toastContext.js`
- [Toast display](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/Toast.jsx): `src/components/common/Toast.jsx`

### Reporting and storage

- [Lost report page](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/ReportLost.jsx): `src/pages/ReportLost.jsx`
- [Found report page](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/ReportFound.jsx): `src/pages/ReportFound.jsx`
- [Report form](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/reports/ReportForm.jsx): `src/components/reports/ReportForm.jsx`
- [Supabase client](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/services/supabaseClient.js): `src/services/supabaseClient.js`

### Matching and verification

- [Matches page](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/Matches.jsx): `src/pages/Matches.jsx`
- [Match scoring](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/services/matching.js): `src/services/matching.js`
- [Report status](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/utils/reportStatus.js): `src/utils/reportStatus.js`
- [Ownership verification](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/Verification.jsx): `src/pages/Verification.jsx`

### Results and shared UI

- [Home page](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/Home.jsx): `src/pages/Home.jsx`
- [Dashboard](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`
- [Page header](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/PageHeader.jsx): `src/components/common/PageHeader.jsx`
- [Item thumbnail](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/ItemThumb.jsx): `src/components/common/ItemThumb.jsx`
- [Status badge](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/StatusBadge.jsx): `src/components/common/StatusBadge.jsx`
- [Match score ring](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/ScoreRing.jsx): `src/components/common/ScoreRing.jsx`
- [Summary stat card](https://github.com/parth-2305/reclaim-hacksphere-2026/blob/main/src/components/common/StatCard.jsx): `src/components/common/StatCard.jsx`

### Other components

- **Campus user**
- **Supabase service**

## Connections

- Campus user → Route application: opens app (evidence: `src/App.jsx`)
- Route application → Page layout: renders routes in (evidence: `src/App.jsx`)
- Route application → Home page: routes to (evidence: `src/App.jsx`)
- Route application → Lost report page: routes to (evidence: `src/App.jsx`)
- Route application → Found report page: routes to (evidence: `src/App.jsx`)
- Route application → Matches page: routes to (evidence: `src/App.jsx`)
- Route application → Ownership verification: routes to (evidence: `src/App.jsx`)
- Route application → Dashboard: routes to (evidence: `src/App.jsx`)
- Page layout → Header: renders (evidence: `src/components/layout/Layout.jsx`)
- Page layout → Sidebar navigation: renders (evidence: `src/components/layout/Layout.jsx`)
- Lost report page → Report form: renders (evidence: `src/pages/ReportLost.jsx`)
- Found report page → Report form: renders (evidence: `src/pages/ReportFound.jsx`)
- Report form → Supabase client: uploads and saves (evidence: `src/components/reports/ReportForm.jsx`)
- Supabase client → Supabase service: connects to (evidence: `src/services/supabaseClient.js`)
- Report form → Toast hook: shows feedback via (evidence: `src/components/reports/ReportForm.jsx`)
- Dashboard → Supabase client: loads report data (evidence: `src/pages/Dashboard.jsx`)
- Home page → Supabase client: loads data (evidence: `src/pages/Home.jsx`)
- Matches page → Supabase client: loads report data (evidence: `src/pages/Matches.jsx`)
- Dashboard → Match scoring: finds matches (evidence: `src/pages/Dashboard.jsx`)
- Matches page → Match scoring: finds matches (evidence: `src/pages/Matches.jsx`)
- Ownership verification → Match scoring: checks answer (evidence: `src/pages/Verification.jsx`)
- Report status → Match scoring: gets match status (evidence: `src/utils/reportStatus.js`)
- Dashboard → Report status: derives statuses (evidence: `src/pages/Dashboard.jsx`)
- Matches page → Report status: derives pair status (evidence: `src/pages/Matches.jsx`)
- Ownership verification → Supabase client: reads and updates verification (evidence: `src/pages/Verification.jsx`)
- Report form → Supabase client: stores report (evidence: `src/components/reports/ReportForm.jsx`)
- Dashboard → Summary stat card: renders (evidence: `src/pages/Dashboard.jsx`)
- Dashboard → Page header: renders (evidence: `src/pages/Dashboard.jsx`)
- Dashboard → Item thumbnail: renders (evidence: `src/pages/Dashboard.jsx`)
- Dashboard → Status badge: renders (evidence: `src/pages/Dashboard.jsx`)
- Dashboard → Match score ring: renders (evidence: `src/pages/Dashboard.jsx`)
- Matches page → Page header: renders (evidence: `src/pages/Matches.jsx`)
- Matches page → Item thumbnail: renders (evidence: `src/pages/Matches.jsx`)
- Matches page → Status badge: renders (evidence: `src/pages/Matches.jsx`)
- Matches page → Match score ring: renders (evidence: `src/pages/Matches.jsx`)
- Ownership verification → Page header: renders (evidence: `src/pages/Verification.jsx`)
- Ownership verification → Item thumbnail: renders (evidence: `src/pages/Verification.jsx`)
- Ownership verification → Status badge: renders (evidence: `src/pages/Verification.jsx`)
- Ownership verification → Match score ring: renders (evidence: `src/pages/Verification.jsx`)
- Report form → Toast hook: calls (evidence: `src/components/reports/ReportForm.jsx`)
- Toast hook → Toast context: reads (evidence: `src/hooks/useToast.js`)
- Toast display → Toast context: uses (evidence: `src/components/common/Toast.jsx`)
