# shivamtiwari01016/ai-email-reply-assistant architecture

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

- Interactive diagram: https://gitdiagram.com/shivamtiwari01016/ai-email-reply-assistant
- Repository: https://github.com/shivamtiwari01016/ai-email-reply-assistant

## Overview

Email Reply Assistant has two user-facing paths: a React web interface with tone selection and a Gmail extension that generates professional replies in-place. Both send email content to the Spring Boot API, whose service builds a prompt, calls Gemini, and returns generated text. The web UI also supports copying replies and switching color modes. The README documents the overall integrations; sampled source confirms the request handlers and extension behavior, but not every backend configuration detail.

Main entry points: [`backend/src/main/java/com/email/writer/app/EmailGeneratorController.java`](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/backend/src/main/java/com/email/writer/app/EmailGeneratorController.java) (Email API), [`extension/content.js`](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/extension/content.js) (AI Reply Button), [`frontend/src/App.jsx`](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/frontend/src/App.jsx) (Reply Form), [`backend/src/main/java/com/email/writer/app/EmailGeneratorService.java`](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/backend/src/main/java/com/email/writer/app/EmailGeneratorService.java) (Reply Generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Interface"]
  node_web_form["Reply Form<br/>[App.jsx]"]
  node_reply_display["Reply Display<br/>[App.jsx]"]
  node_theme["Color Theme<br/>[theme.jsx]"]
end

subgraph group_extension["Gmail Extension"]
  node_compose_watch["Compose Watcher<br/>[content.js]"]
  node_reply_button["AI Reply Button<br/>[content.js]"]
  node_email_extract["Email Extraction<br/>[content.js]"]
  node_reply_insert["Reply Insertion<br/>[content.js]"]
end

subgraph group_backend["Reply Backend"]
  node_api["Email API"]
  node_request_data["Email Request<br/>[EmailRequest.java]"]
  node_generator["Reply Generator"]
end

subgraph group_ai["AI Service"]
  node_gemini["Gemini API"]
end

node_web_user(("Web User"))
node_gmail_user(("Gmail User"))
node_gmail["Gmail Compose"]

node_web_user -->|"enters email"| node_web_form
node_web_form -->|"posts request"| node_api
node_api -->|"binds request"| node_request_data
node_api -->|"calls generation"| node_generator
node_generator -->|"requests completion"| node_gemini
node_api -.->|"returns reply"| node_reply_display
node_web_user -->|"copies reply"| node_reply_display
node_web_form -->|"uses color mode"| node_theme
node_gmail_user -->|"opens compose"| node_gmail
node_gmail -->|"compose changes"| node_compose_watch
node_compose_watch -->|"injects button"| node_reply_button
node_reply_button -->|"reads email"| node_email_extract
node_reply_button -->|"posts request"| node_api
node_reply_button -->|"inserts response"| node_reply_insert
node_reply_insert -->|"writes reply"| node_gmail

click node_web_form "https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/frontend/src/App.jsx"
click node_reply_display "https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/frontend/src/App.jsx"
click node_theme "https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/frontend/src/theme.jsx"
click node_compose_watch "https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/extension/content.js"
click node_reply_button "https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/extension/content.js"
click node_email_extract "https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/extension/content.js"
click node_reply_insert "https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/extension/content.js"
click node_api "https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/backend/src/main/java/com/email/writer/app/EmailGeneratorController.java"
click node_request_data "https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/backend/src/main/java/com/email/writer/app/EmailRequest.java"
click node_generator "https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/backend/src/main/java/com/email/writer/app/EmailGeneratorService.java"

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_web_form,node_reply_display,node_theme,node_web_user,node_gmail_user toneBlue
class node_compose_watch,node_reply_button,node_email_extract,node_reply_insert toneAmber
class node_api,node_request_data,node_generator toneMint
class node_gemini toneRose
class node_gmail toneIndigo
```

## Components

### Web Interface

- [Reply Form](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Reply Display](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Color Theme](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/frontend/src/theme.jsx): `frontend/src/theme.jsx`

### Gmail Extension

- [Compose Watcher](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/extension/content.js): `extension/content.js`
- [AI Reply Button](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/extension/content.js): `extension/content.js`
- [Email Extraction](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/extension/content.js): `extension/content.js`
- [Reply Insertion](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/extension/content.js): `extension/content.js`

### Reply Backend

- [Email API](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/backend/src/main/java/com/email/writer/app/EmailGeneratorController.java): `backend/src/main/java/com/email/writer/app/EmailGeneratorController.java`
- [Email Request](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/backend/src/main/java/com/email/writer/app/EmailRequest.java): `backend/src/main/java/com/email/writer/app/EmailRequest.java`
- [Reply Generator](https://github.com/shivamtiwari01016/ai-email-reply-assistant/blob/main/backend/src/main/java/com/email/writer/app/EmailGeneratorService.java): `backend/src/main/java/com/email/writer/app/EmailGeneratorService.java`

### AI Service

- **Gemini API**

### Other components

- **Web User**
- **Gmail User**
- **Gmail Compose**

## Connections

- Web User → Reply Form: enters email (evidence: `README.md`)
- Reply Form → Email API: posts request (evidence: `frontend/src/App.jsx`)
- Email API → Email Request: binds request (evidence: `backend/src/main/java/com/email/writer/app/EmailGeneratorController.java`)
- Email API → Reply Generator: calls generation (evidence: `backend/src/main/java/com/email/writer/app/EmailGeneratorController.java`)
- Reply Generator → Gemini API: requests completion (evidence: `backend/src/main/java/com/email/writer/app/EmailGeneratorService.java`)
- Email API → Reply Display: returns reply
- Web User → Reply Display: copies reply (evidence: `frontend/src/App.jsx`)
- Reply Form → Color Theme: uses color mode (evidence: `frontend/src/App.jsx`)
- Gmail User → Gmail Compose: opens compose (evidence: `README.md`)
- Gmail Compose → Compose Watcher: compose changes (evidence: `extension/content.js`)
- Compose Watcher → AI Reply Button: injects button (evidence: `extension/content.js`)
- AI Reply Button → Email Extraction: reads email (evidence: `extension/content.js`)
- AI Reply Button → Email API: posts request (evidence: `extension/content.js`)
- AI Reply Button → Reply Insertion: inserts response (evidence: `extension/content.js`)
- Reply Insertion → Gmail Compose: writes reply (evidence: `extension/content.js`)
