# foyin/serverless-image-recognition architecture

> Architecture diagram of the GitHub repository foyin/serverless-image-recognition, 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/foyin/serverless-image-recognition
- Repository: https://github.com/foyin/serverless-image-recognition

## Overview

This is a React image-recognition web app: a user selects a PNG/JPEG, requests an upload URL, uploads the image, then requests and displays labels with confidence and parent categories. The sampled code shows the browser-side sequence and state handoff; the README identifies Amazon Rekognition as the recognition technology. The cloud service internals and endpoint configuration are not present in the excerpts, so those relationships are shown only where documented or directly invoked.

Main entry points: [`src/components/TitleArea/FileUploader/FileUploader.js`](https://github.com/foyin/serverless-image-recognition/blob/main/src/components/TitleArea/FileUploader/FileUploader.js) (Image uploader), [`src/components/TitleArea/TitleArea.js`](https://github.com/foyin/serverless-image-recognition/blob/main/src/components/TitleArea/TitleArea.js) (Title area), [`src/index.js`](https://github.com/foyin/serverless-image-recognition/blob/main/src/index.js) (React entry), [`src/App.js`](https://github.com/foyin/serverless-image-recognition/blob/main/src/App.js) (App shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web interface"]
  node_app["App shell<br/>[App.js]"]
  node_title["Title area<br/>[TitleArea.js]"]
  node_label_list["Label list<br/>[LabelList.js]"]
  node_label["Label detail<br/>[Label.js]"]
end

subgraph group_cloud["Recognition workflow"]
  node_uploader["Image uploader<br/>[FileUploader.js]"]
  node_upload_api["Upload URL API"]
  node_storage[("Image storage")]
  node_recognition_api["Recognition API"]
  node_rekognition["Amazon Rekognition"]
end

subgraph group_runtime["App runtime"]
  node_entry["React entry<br/>[index.js]"]
  node_vitals["Web vitals<br/>[reportWebVitals.js]"]
end

node_user(("User"))

node_user -->|"opens app"| node_entry
node_entry -->|"mounts"| node_app
node_entry -->|"reports metrics"| node_vitals
node_app -->|"renders"| node_title
node_title -->|"renders"| node_uploader
node_user -->|"selects image"| node_uploader
node_uploader -->|"requests URL"| node_upload_api
node_upload_api -->|"returns URL"| node_uploader
node_uploader -->|"uploads image"| node_storage
node_uploader -->|"requests labels"| node_recognition_api
node_recognition_api -.->|"uses recognition"| node_rekognition
node_uploader -->|"sets results"| node_title
node_title -->|"renders results"| node_label_list
node_label_list -->|"renders labels"| node_label

click node_entry "https://github.com/foyin/serverless-image-recognition/blob/main/src/index.js"
click node_app "https://github.com/foyin/serverless-image-recognition/blob/main/src/App.js"
click node_title "https://github.com/foyin/serverless-image-recognition/blob/main/src/components/TitleArea/TitleArea.js"
click node_uploader "https://github.com/foyin/serverless-image-recognition/blob/main/src/components/TitleArea/FileUploader/FileUploader.js"
click node_label_list "https://github.com/foyin/serverless-image-recognition/blob/main/src/components/TitleArea/LabelList/LabelList.js"
click node_label "https://github.com/foyin/serverless-image-recognition/blob/main/src/components/TitleArea/LabelList/Label.js"
click node_vitals "https://github.com/foyin/serverless-image-recognition/blob/main/src/reportWebVitals.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_title,node_label_list,node_label,node_user toneBlue
class node_uploader,node_upload_api,node_storage,node_recognition_api,node_rekognition toneAmber
class node_entry,node_vitals toneMint
```

## Components

### Web interface

- [App shell](https://github.com/foyin/serverless-image-recognition/blob/main/src/App.js): `src/App.js`
- [Title area](https://github.com/foyin/serverless-image-recognition/blob/main/src/components/TitleArea/TitleArea.js): `src/components/TitleArea/TitleArea.js`
- [Label list](https://github.com/foyin/serverless-image-recognition/blob/main/src/components/TitleArea/LabelList/LabelList.js): `src/components/TitleArea/LabelList/LabelList.js`
- [Label detail](https://github.com/foyin/serverless-image-recognition/blob/main/src/components/TitleArea/LabelList/Label.js): `src/components/TitleArea/LabelList/Label.js`

### Recognition workflow

- [Image uploader](https://github.com/foyin/serverless-image-recognition/blob/main/src/components/TitleArea/FileUploader/FileUploader.js): `src/components/TitleArea/FileUploader/FileUploader.js`
- **Upload URL API**
- **Image storage**
- **Recognition API**
- **Amazon Rekognition**

### App runtime

- [React entry](https://github.com/foyin/serverless-image-recognition/blob/main/src/index.js): `src/index.js`
- [Web vitals](https://github.com/foyin/serverless-image-recognition/blob/main/src/reportWebVitals.js): `src/reportWebVitals.js`

### Other components

- **User**

## Connections

- User → React entry: opens app
- React entry → App shell: mounts (evidence: `src/index.js`)
- React entry → Web vitals: reports metrics (evidence: `src/index.js`)
- App shell → Title area: renders (evidence: `src/App.js`)
- Title area → Image uploader: renders (evidence: `src/components/TitleArea/TitleArea.js`)
- User → Image uploader: selects image (evidence: `src/components/TitleArea/FileUploader/FileUploader.js`)
- Image uploader → Upload URL API: requests URL (evidence: `src/components/TitleArea/FileUploader/FileUploader.js`)
- Upload URL API → Image uploader: returns URL (evidence: `src/components/TitleArea/FileUploader/FileUploader.js`)
- Image uploader → Image storage: uploads image (evidence: `src/components/TitleArea/FileUploader/FileUploader.js`)
- Image uploader → Recognition API: requests labels (evidence: `src/components/TitleArea/FileUploader/FileUploader.js`)
- Recognition API → Amazon Rekognition: uses recognition (evidence: `README.md`)
- Image uploader → Title area: sets results (evidence: `src/components/TitleArea/FileUploader/FileUploader.js`)
- Title area → Label list: renders results (evidence: `src/components/TitleArea/TitleArea.js`)
- Label list → Label detail: renders labels (evidence: `src/components/TitleArea/LabelList/LabelList.js`)
