# kumarsidhan/face-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/kumarsidhan/face-frontend
- Repository: https://github.com/kumarsidhan/face-frontend

## Overview

This is a React identity-verification frontend. Users register, provide an ID image and selfie, and may complete liveness checks; login has a separate selfie and liveness path. The routed pages own the upload and verification requests to an external backend, while shared webcam capture and face validation support image input. The README documents only the Create React App scaffold, so product capabilities are inferred from the sampled routes and source. Several page excerpts are partial; uncertain page-to-backend relationships are omitted.

Main entry points: [`src/routes/AppRoutes.js`](https://github.com/kumarsidhan/face-frontend/blob/main/src/routes/AppRoutes.js) (Page Routes), [`src/pages/UploadSelfie.js`](https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/UploadSelfie.js) (Selfie Upload), [`src/pages/UploadID.jsx`](https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/UploadID.jsx) (ID Upload), [`src/components/WebcamCapture.jsx`](https://github.com/kumarsidhan/face-frontend/blob/main/src/components/WebcamCapture.jsx) (Webcam Capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Routing"]
  node_app["React App<br/>[App.js]"]
  node_routes["Page Routes<br/>[AppRoutes.js]"]
end

subgraph group_registration["Registration Verification"]
  node_register["Registration<br/>[Register.js]"]
  node_registration_form["Registration Form"]
  node_id_upload["ID Upload<br/>[UploadID.jsx]"]
  node_selfie_upload["Selfie Upload<br/>[UploadSelfie.js]"]
  node_upload_liveness["Liveness Upload<br/>[UploadLiveness.js]"]
  node_liveness_check["Registration Liveness<br/>[LivenessCheck.js]"]
  node_success["Success Page<br/>[Success.js]"]
end

subgraph group_login["Login Verification"]
  node_login["Login<br/>[Login.js]"]
  node_selfie_login["Selfie Login<br/>[SelfieLogin.js]"]
  node_login_liveness["Login Liveness"]
end

subgraph group_shared["Capture and Validation"]
  node_webcam["Webcam Capture<br/>[WebcamCapture.jsx]"]
  node_legacy_webcam["Alternate Webcam<br/>[WebcamCapture1.js]"]
  node_face_validation["Face Validation<br/>[faceValidation.js]"]
end

node_user(("User"))
node_backend["Verification Backend"]
node_mediapipe["MediaPipe Model Assets"]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_routes
node_routes -->|"routes to"| node_register
node_routes -->|"routes to"| node_id_upload
node_routes -->|"routes to"| node_selfie_upload
node_routes -->|"routes to"| node_upload_liveness
node_routes -->|"routes to"| node_liveness_check
node_routes -->|"routes to"| node_success
node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_selfie_login
node_routes -->|"routes to"| node_login_liveness
node_id_upload -->|"renders"| node_webcam
node_id_upload -->|"validates with"| node_face_validation
node_id_upload -->|"uploads ID"| node_backend
node_selfie_upload -->|"renders"| node_webcam
node_selfie_upload -->|"validates with"| node_face_validation
node_selfie_upload -->|"uploads selfie"| node_backend
node_selfie_upload -->|"requests face match"| node_backend
node_selfie_login -->|"renders"| node_webcam
node_registration_form -.->|"uses client"| node_backend
node_webcam -->|"loads model"| node_mediapipe
node_face_validation -->|"loads model"| node_mediapipe
node_liveness_check -->|"loads model"| node_mediapipe
node_login_liveness -->|"loads model"| node_mediapipe

click node_app "https://github.com/kumarsidhan/face-frontend/blob/main/src/App.js"
click node_routes "https://github.com/kumarsidhan/face-frontend/blob/main/src/routes/AppRoutes.js"
click node_register "https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/Register.js"
click node_registration_form "https://github.com/kumarsidhan/face-frontend/blob/main/src/components/RegistrationForm.jsx"
click node_id_upload "https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/UploadID.jsx"
click node_selfie_upload "https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/UploadSelfie.js"
click node_upload_liveness "https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/UploadLiveness.js"
click node_liveness_check "https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/LivenessCheck.js"
click node_success "https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/Success.js"
click node_login "https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/Login.js"
click node_selfie_login "https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/SelfieLogin.js"
click node_login_liveness "https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/LivenessCheckLogin.js"
click node_webcam "https://github.com/kumarsidhan/face-frontend/blob/main/src/components/WebcamCapture.jsx"
click node_legacy_webcam "https://github.com/kumarsidhan/face-frontend/blob/main/src/components/WebcamCapture1.js"
click node_face_validation "https://github.com/kumarsidhan/face-frontend/blob/main/src/utils/faceValidation.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_routes,node_user toneBlue
class node_register,node_registration_form,node_id_upload,node_selfie_upload,node_upload_liveness,node_liveness_check,node_success toneAmber
class node_login,node_selfie_login,node_login_liveness,node_mediapipe toneMint
class node_webcam,node_legacy_webcam,node_face_validation toneRose
class node_backend toneIndigo
```

## Components

### Application Routing

- [React App](https://github.com/kumarsidhan/face-frontend/blob/main/src/App.js): `src/App.js`
- [Page Routes](https://github.com/kumarsidhan/face-frontend/blob/main/src/routes/AppRoutes.js): `src/routes/AppRoutes.js`

### Registration Verification

- [Registration](https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/Register.js): `src/pages/Register.js`
- [Registration Form](https://github.com/kumarsidhan/face-frontend/blob/main/src/components/RegistrationForm.jsx): `src/components/RegistrationForm.jsx`
- [ID Upload](https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/UploadID.jsx): `src/pages/UploadID.jsx`
- [Selfie Upload](https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/UploadSelfie.js): `src/pages/UploadSelfie.js`
- [Liveness Upload](https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/UploadLiveness.js): `src/pages/UploadLiveness.js`
- [Registration Liveness](https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/LivenessCheck.js): `src/pages/LivenessCheck.js`
- [Success Page](https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/Success.js): `src/pages/Success.js`

### Login Verification

- [Login](https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/Login.js): `src/pages/Login.js`
- [Selfie Login](https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/SelfieLogin.js): `src/pages/SelfieLogin.js`
- [Login Liveness](https://github.com/kumarsidhan/face-frontend/blob/main/src/pages/LivenessCheckLogin.js): `src/pages/LivenessCheckLogin.js`

### Capture and Validation

- [Webcam Capture](https://github.com/kumarsidhan/face-frontend/blob/main/src/components/WebcamCapture.jsx): `src/components/WebcamCapture.jsx`
- [Alternate Webcam](https://github.com/kumarsidhan/face-frontend/blob/main/src/components/WebcamCapture1.js): `src/components/WebcamCapture1.js`
- [Face Validation](https://github.com/kumarsidhan/face-frontend/blob/main/src/utils/faceValidation.js): `src/utils/faceValidation.js`

### Other components

- **User**
- **Verification Backend**
- **MediaPipe Model Assets**

## Connections

- User → React App: uses
- React App → Page Routes: renders (evidence: `src/App.js`)
- Page Routes → Registration: routes to (evidence: `src/routes/AppRoutes.js`)
- Page Routes → ID Upload: routes to (evidence: `src/routes/AppRoutes.js`)
- Page Routes → Selfie Upload: routes to (evidence: `src/routes/AppRoutes.js`)
- Page Routes → Liveness Upload: routes to (evidence: `src/routes/AppRoutes.js`)
- Page Routes → Registration Liveness: routes to (evidence: `src/routes/AppRoutes.js`)
- Page Routes → Success Page: routes to (evidence: `src/routes/AppRoutes.js`)
- Page Routes → Login: routes to (evidence: `src/routes/AppRoutes.js`)
- Page Routes → Selfie Login: routes to (evidence: `src/routes/AppRoutes.js`)
- Page Routes → Login Liveness: routes to (evidence: `src/routes/AppRoutes.js`)
- ID Upload → Webcam Capture: renders (evidence: `src/pages/UploadID.jsx`)
- ID Upload → Face Validation: validates with (evidence: `src/pages/UploadID.jsx`)
- ID Upload → Verification Backend: uploads ID (evidence: `src/pages/UploadID.jsx`)
- Selfie Upload → Webcam Capture: renders (evidence: `src/pages/UploadSelfie.js`)
- Selfie Upload → Face Validation: validates with (evidence: `src/pages/UploadSelfie.js`)
- Selfie Upload → Verification Backend: uploads selfie (evidence: `src/pages/UploadSelfie.js`)
- Selfie Upload → Verification Backend: requests face match (evidence: `src/pages/UploadSelfie.js`)
- Selfie Login → Webcam Capture: renders (evidence: `src/pages/SelfieLogin.js`)
- Registration Form → Verification Backend: uses client
- Webcam Capture → MediaPipe Model Assets: loads model (evidence: `src/components/WebcamCapture.jsx`)
- Face Validation → MediaPipe Model Assets: loads model (evidence: `src/utils/faceValidation.js`)
- Registration Liveness → MediaPipe Model Assets: loads model (evidence: `src/pages/LivenessCheck.js`)
- Login Liveness → MediaPipe Model Assets: loads model (evidence: `src/pages/LivenessCheckLogin.js`)
