# satyam-0304/campus-lend architecture

> Architecture diagram of the GitHub repository satyam-0304/campus-lend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/satyam-0304/campus-lend
- Repository: https://github.com/satyam-0304/campus-lend

## Overview

CampusLend is a campus-only peer-to-peer equipment lending marketplace. Students authenticate and verify their campus email, browse or list equipment, manage borrow requests, and coordinate through profiles, chat, notifications, and reviews. The frontend is a React application; its typed API client communicates with Express, whose routes enforce identity and verification before accessing Supabase. The README documents direct browser use of Supabase Auth and Storage. Some frontend wiring and route internals were not sampled, so those links are limited to indexed references or documented architecture.

Main entry points: [`frontend/src/App.tsx`](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/App.tsx) (CampusLend app), [`backend/config/supabaseClient.js`](https://github.com/satyam-0304/campus-lend/blob/main/backend/config/supabaseClient.js) (Backend Supabase clients), [`backend/app.js`](https://github.com/satyam-0304/campus-lend/blob/main/backend/app.js) (Express API), [`frontend/src/lib/api.ts`](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/lib/api.ts) (Typed API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Student experience"]
  node_app["CampusLend app<br/>[App.tsx]"]
  node_landing["Landing page<br/>[LandingPage.tsx]"]
end

subgraph group_identity["Identity and verification"]
  node_authmodal["Sign-in modal<br/>[AuthModal.tsx]"]
  node_otpmodal["OTP verification"]
  node_browser_supabase["Browser Supabase client<br/>[supabase.ts]"]
  node_auth_routes["OTP endpoints<br/>[authOtpRoutes.js]"]
  node_auth_middleware["JWT validation<br/>[authMiddleware.js]"]
  node_verified_middleware["Email gate"]
  node_email_service["Verification email<br/>[emailService.js]"]
end

subgraph group_marketplace["Marketplace operations"]
  node_equipment_ui["Equipment browsing<br/>[ProductCard.tsx]"]
  node_product_detail["Item details"]
  node_seller_hub["Seller dashboard<br/>[SellerHub.tsx]"]
  node_rental_dates["Rental dates"]
  node_equipment_routes["Equipment listings<br/>[equipmentRoutes.js]"]
  node_request_routes["Borrow lifecycle<br/>[requestRoutes.js]"]
  node_profile_routes["Profile management<br/>[profileRoutes.js]"]
end

subgraph group_community["Community interactions"]
  node_message_ui["Chat drawer<br/>[ChatDrawer.tsx]"]
  node_message_routes["Messaging API<br/>[messageRoutes.js]"]
  node_notification_ui["Notifications"]
  node_notification_routes["Notification API"]
  node_review_ui["Reviews<br/>[ReviewModal.tsx]"]
  node_review_routes["Review API<br/>[reviewRoutes.js]"]
end

subgraph group_backend["API and persistence"]
  node_api_client["Typed API client<br/>[api.ts]"]
  node_express["Express API<br/>[app.js]"]
  node_supabase_client["Backend Supabase clients<br/>[supabaseClient.js]"]
end

node_student(("Campus student"))
node_supabase_auth["Supabase Auth"]
node_database[("Supabase database")]
node_storage[("Supabase Storage")]

node_student -->|"uses"| node_app
node_app -->|"renders"| node_landing
node_app -->|"opens"| node_authmodal
node_app -->|"opens"| node_otpmodal
node_authmodal -->|"authenticates with"| node_browser_supabase
node_browser_supabase -->|"uses"| node_supabase_auth
node_app -->|"renders"| node_equipment_ui
node_app -->|"renders"| node_product_detail
node_app -->|"renders"| node_seller_hub
node_product_detail -->|"renders"| node_rental_dates
node_equipment_ui -.->|"requests data"| node_api_client
node_seller_hub -.->|"requests data"| node_api_client
node_api_client -->|"calls REST API"| node_express
node_express -->|"mounts"| node_equipment_routes
node_express -->|"mounts"| node_request_routes
node_express -->|"mounts"| node_profile_routes
node_express -->|"mounts"| node_auth_routes
node_express -->|"mounts"| node_message_routes
node_express -->|"mounts"| node_notification_routes
node_express -->|"mounts"| node_review_routes
node_auth_routes -->|"checks identity"| node_auth_middleware
node_auth_middleware -->|"uses anon client"| node_supabase_client
node_auth_routes -->|"uses service client"| node_supabase_client
node_auth_routes -->|"sends codes"| node_email_service
node_email_service -->|"emails code"| node_student
node_equipment_routes -->|"authenticates"| node_auth_middleware
node_equipment_routes -->|"requires verification"| node_verified_middleware
node_request_routes -->|"authenticates"| node_auth_middleware
node_request_routes -->|"requires verification"| node_verified_middleware
node_verified_middleware -->|"checks status"| node_supabase_client
node_equipment_routes -->|"reads and writes"| node_supabase_client
node_request_routes -->|"reads and writes"| node_supabase_client
node_profile_routes -->|"reads and writes"| node_supabase_client
node_message_routes -->|"reads and writes"| node_supabase_client
node_notification_routes -->|"reads and writes"| node_supabase_client
node_review_routes -->|"authenticates"| node_auth_middleware
node_review_routes -->|"reads and writes"| node_supabase_client
node_supabase_client -->|"accesses"| node_database
node_student -->|"uploads images"| node_browser_supabase
node_browser_supabase -->|"stores item photos"| node_storage
node_app -->|"renders"| node_message_ui
node_app -->|"renders"| node_notification_ui
node_app -->|"renders"| node_review_ui
node_message_ui -.->|"requests data"| node_api_client
node_notification_ui -.->|"requests data"| node_api_client
node_review_ui -.->|"requests data"| node_api_client

click node_app "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/App.tsx"
click node_landing "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/LandingPage.tsx"
click node_authmodal "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/AuthModal.tsx"
click node_otpmodal "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/EmailOtpVerificationModal.tsx"
click node_browser_supabase "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/lib/supabase.ts"
click node_equipment_ui "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/ProductCard.tsx"
click node_product_detail "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/ProductDetailModal.tsx"
click node_seller_hub "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/SellerHub.tsx"
click node_rental_dates "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/RentalDateSelector.tsx"
click node_api_client "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/lib/api.ts"
click node_express "https://github.com/satyam-0304/campus-lend/blob/main/backend/app.js"
click node_equipment_routes "https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/equipmentRoutes.js"
click node_request_routes "https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/requestRoutes.js"
click node_profile_routes "https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/profileRoutes.js"
click node_auth_routes "https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/authOtpRoutes.js"
click node_auth_middleware "https://github.com/satyam-0304/campus-lend/blob/main/backend/middleware/authMiddleware.js"
click node_verified_middleware "https://github.com/satyam-0304/campus-lend/blob/main/backend/middleware/requireEmailVerified.js"
click node_email_service "https://github.com/satyam-0304/campus-lend/blob/main/backend/services/emailService.js"
click node_message_ui "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/ChatDrawer.tsx"
click node_message_routes "https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/messageRoutes.js"
click node_notification_ui "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/NotificationPopover.tsx"
click node_notification_routes "https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/notificationRoutes.js"
click node_review_ui "https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/ReviewModal.tsx"
click node_review_routes "https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/reviewRoutes.js"
click node_supabase_client "https://github.com/satyam-0304/campus-lend/blob/main/backend/config/supabaseClient.js"

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_app,node_landing toneBlue
class node_authmodal,node_otpmodal,node_browser_supabase,node_auth_routes,node_auth_middleware,node_verified_middleware,node_email_service,node_database,node_storage toneAmber
class node_equipment_ui,node_product_detail,node_seller_hub,node_rental_dates,node_equipment_routes,node_request_routes,node_profile_routes toneMint
class node_message_ui,node_message_routes,node_notification_ui,node_notification_routes,node_review_ui,node_review_routes toneRose
class node_api_client,node_express,node_supabase_client,node_student,node_supabase_auth toneIndigo
```

## Components

### Student experience

- [CampusLend app](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Landing page](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/LandingPage.tsx): `frontend/src/components/LandingPage.tsx`

### Identity and verification

- [Sign-in modal](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/AuthModal.tsx): `frontend/src/components/AuthModal.tsx`
- [OTP verification](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/EmailOtpVerificationModal.tsx): `frontend/src/components/EmailOtpVerificationModal.tsx`
- [Browser Supabase client](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/lib/supabase.ts): `frontend/src/lib/supabase.ts`
- [OTP endpoints](https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/authOtpRoutes.js): `backend/routes/authOtpRoutes.js`
- [JWT validation](https://github.com/satyam-0304/campus-lend/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Email gate](https://github.com/satyam-0304/campus-lend/blob/main/backend/middleware/requireEmailVerified.js): `backend/middleware/requireEmailVerified.js`
- [Verification email](https://github.com/satyam-0304/campus-lend/blob/main/backend/services/emailService.js): `backend/services/emailService.js`

### Marketplace operations

- [Equipment browsing](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/ProductCard.tsx): `frontend/src/components/marketplace/ProductCard.tsx`
- [Item details](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/ProductDetailModal.tsx): `frontend/src/components/marketplace/ProductDetailModal.tsx`
- [Seller dashboard](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/SellerHub.tsx): `frontend/src/components/marketplace/SellerHub.tsx`
- [Rental dates](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/RentalDateSelector.tsx): `frontend/src/components/marketplace/RentalDateSelector.tsx`
- [Equipment listings](https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/equipmentRoutes.js): `backend/routes/equipmentRoutes.js`
- [Borrow lifecycle](https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/requestRoutes.js): `backend/routes/requestRoutes.js`
- [Profile management](https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/profileRoutes.js): `backend/routes/profileRoutes.js`

### Community interactions

- [Chat drawer](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/ChatDrawer.tsx): `frontend/src/components/marketplace/ChatDrawer.tsx`
- [Messaging API](https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/messageRoutes.js): `backend/routes/messageRoutes.js`
- [Notifications](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/NotificationPopover.tsx): `frontend/src/components/marketplace/NotificationPopover.tsx`
- [Notification API](https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/notificationRoutes.js): `backend/routes/notificationRoutes.js`
- [Reviews](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/components/marketplace/ReviewModal.tsx): `frontend/src/components/marketplace/ReviewModal.tsx`
- [Review API](https://github.com/satyam-0304/campus-lend/blob/main/backend/routes/reviewRoutes.js): `backend/routes/reviewRoutes.js`

### API and persistence

- [Typed API client](https://github.com/satyam-0304/campus-lend/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Express API](https://github.com/satyam-0304/campus-lend/blob/main/backend/app.js): `backend/app.js`
- [Backend Supabase clients](https://github.com/satyam-0304/campus-lend/blob/main/backend/config/supabaseClient.js): `backend/config/supabaseClient.js`

### Other components

- **Campus student**
- **Supabase Auth**
- **Supabase database**
- **Supabase Storage**

## Connections

- Campus student → CampusLend app: uses (evidence: `README.md`)
- CampusLend app → Landing page: renders (evidence: `frontend/src/App.tsx`)
- CampusLend app → Sign-in modal: opens (evidence: `frontend/src/App.tsx`)
- CampusLend app → OTP verification: opens (evidence: `frontend/src/App.tsx`)
- Sign-in modal → Browser Supabase client: authenticates with (evidence: `frontend/src/components/AuthModal.tsx`)
- Browser Supabase client → Supabase Auth: uses (evidence: `README.md`)
- CampusLend app → Equipment browsing: renders (evidence: `frontend/src/App.tsx`)
- CampusLend app → Item details: renders (evidence: `frontend/src/App.tsx`)
- CampusLend app → Seller dashboard: renders (evidence: `frontend/src/App.tsx`)
- Item details → Rental dates: renders (evidence: `frontend/src/components/marketplace/ProductDetailModal.tsx`)
- Equipment browsing → Typed API client: requests data
- Seller dashboard → Typed API client: requests data
- Typed API client → Express API: calls REST API (evidence: `README.md`)
- Express API → Equipment listings: mounts (evidence: `backend/app.js`)
- Express API → Borrow lifecycle: mounts (evidence: `backend/app.js`)
- Express API → Profile management: mounts (evidence: `backend/app.js`)
- Express API → OTP endpoints: mounts (evidence: `backend/app.js`)
- Express API → Messaging API: mounts (evidence: `backend/app.js`)
- Express API → Notification API: mounts (evidence: `backend/app.js`)
- Express API → Review API: mounts (evidence: `backend/app.js`)
- OTP endpoints → JWT validation: checks identity (evidence: `backend/routes/authOtpRoutes.js`)
- JWT validation → Backend Supabase clients: uses anon client (evidence: `backend/middleware/authMiddleware.js`)
- OTP endpoints → Backend Supabase clients: uses service client (evidence: `backend/routes/authOtpRoutes.js`)
- OTP endpoints → Verification email: sends codes (evidence: `backend/routes/authOtpRoutes.js`)
- Verification email → Campus student: emails code (evidence: `backend/services/emailService.js`)
- Equipment listings → JWT validation: authenticates (evidence: `backend/routes/equipmentRoutes.js`)
- Equipment listings → Email gate: requires verification (evidence: `backend/routes/equipmentRoutes.js`)
- Borrow lifecycle → JWT validation: authenticates (evidence: `backend/routes/requestRoutes.js`)
- Borrow lifecycle → Email gate: requires verification (evidence: `backend/routes/requestRoutes.js`)
- Email gate → Backend Supabase clients: checks status (evidence: `backend/middleware/requireEmailVerified.js`)
- Equipment listings → Backend Supabase clients: reads and writes (evidence: `backend/routes/equipmentRoutes.js`)
- Borrow lifecycle → Backend Supabase clients: reads and writes (evidence: `backend/routes/requestRoutes.js`)
- Profile management → Backend Supabase clients: reads and writes (evidence: `backend/routes/profileRoutes.js`)
- Messaging API → Backend Supabase clients: reads and writes (evidence: `backend/routes/messageRoutes.js`)
- Notification API → Backend Supabase clients: reads and writes (evidence: `backend/routes/notificationRoutes.js`)
- Review API → JWT validation: authenticates (evidence: `backend/routes/reviewRoutes.js`)
- Review API → Backend Supabase clients: reads and writes (evidence: `backend/routes/reviewRoutes.js`)
- Backend Supabase clients → Supabase database: accesses (evidence: `README.md`)
- Campus student → Browser Supabase client: uploads images (evidence: `README.md`)
- Browser Supabase client → Supabase Storage: stores item photos (evidence: `README.md`)
- CampusLend app → Chat drawer: renders (evidence: `frontend/src/App.tsx`)
- CampusLend app → Notifications: renders (evidence: `frontend/src/App.tsx`)
- CampusLend app → Reviews: renders (evidence: `frontend/src/App.tsx`)
- Chat drawer → Typed API client: requests data
- Notifications → Typed API client: requests data
- Reviews → Typed API client: requests data
