# barathbalasubramanian/email-summarizer architecture

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

- Interactive diagram: https://gitdiagram.com/barathbalasubramanian/email-summarizer
- Repository: https://github.com/barathbalasubramanian/email-summarizer

## Overview

Email Summarizer is a Gmail-connected web app: users authorize Google, browse and filter inbox messages, then inspect AI-generated summaries, key points, action items, sentiment, and category. The dashboard coordinates email loading and pagination; UI components present the resulting list, statistics, and selected-message detail. The sampled code supports the main OAuth, Gmail-fetch, and summary paths. Some dashboard and summary API links are confirmed by the source index rather than full excerpts; other README-promised capabilities are represented at the landing-page feature level.

Main entry points: [`lib/gmail.ts`](https://github.com/barathbalasubramanian/email-summarizer/blob/main/lib/gmail.ts) (Gmail integration), [`app/dashboard/page.tsx`](https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/dashboard/page.tsx) (Dashboard controller), [`app/page.tsx`](https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/page.tsx) (Connect landing page), [`app/api/auth/callback/route.ts`](https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/api/auth/callback/route.ts) (OAuth callback)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and Auth"]
  node_landing["Connect landing page<br/>[page.tsx]"]
  node_auth_start["OAuth URL route<br/>[route.ts]"]
  node_google_oauth{{"Google OAuth"}}
  node_auth_callback["OAuth callback<br/>[route.ts]"]
  node_token_cookie[("Token cookie")]
  node_feature_promises["Privacy and smart insights<br/>[page.tsx]"]
end

subgraph group_email["Email Workflow"]
  node_dashboard["Dashboard controller<br/>[page.tsx]"]
  node_email_api["Inbox API<br/>[route.ts]"]
  node_gmail_lib["Gmail integration<br/>[gmail.ts]"]
  node_gmail_service{{"Gmail API"}}
end

subgraph group_insights["AI Insights"]
  node_summary_api["Summary API<br/>[route.ts]"]
  node_summarizer["Summary generation<br/>[ai-summarizer.ts]"]
  node_openai{{"OpenAI service"}}
end

subgraph group_ui["Dashboard UI"]
  node_email_list["Email list<br/>[email-list.tsx]"]
  node_dashboard_header["Dashboard header"]
  node_dashboard_stats["Dashboard statistics"]
  node_email_preview["Email preview<br/>[email-preview.tsx]"]
end

node_user(("Email user"))

node_user -->|"opens app"| node_landing
node_landing -->|"requests auth URL"| node_auth_start
node_auth_start -->|"gets auth URL"| node_gmail_lib
node_gmail_lib -->|"creates authorization URL"| node_google_oauth
node_user -.->|"authorizes account"| node_google_oauth
node_google_oauth -.->|"redirects with code"| node_auth_callback
node_auth_callback -->|"exchanges code"| node_gmail_lib
node_gmail_lib -->|"exchanges code"| node_google_oauth
node_auth_callback -->|"stores tokens"| node_token_cookie
node_dashboard -->|"fetches inbox pages"| node_email_api
node_email_api -->|"reads tokens"| node_token_cookie
node_email_api -->|"fetches emails"| node_gmail_lib
node_gmail_lib -->|"lists and reads messages"| node_gmail_service
node_dashboard -->|"renders and handles selection"| node_email_list
node_dashboard -->|"renders selected email"| node_email_preview
node_dashboard -->|"renders"| node_dashboard_header
node_dashboard -->|"renders"| node_dashboard_stats
node_email_preview -->|"requests summary"| node_summary_api
node_summary_api -->|"loads email"| node_gmail_lib
node_summary_api -->|"generates summary"| node_summarizer
node_summarizer -->|"requests analysis"| node_openai
node_landing -->|"presents capabilities"| node_feature_promises

click node_landing "https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/page.tsx"
click node_auth_start "https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/api/auth/google/route.ts"
click node_auth_callback "https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/api/auth/callback/route.ts"
click node_dashboard "https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/dashboard/page.tsx"
click node_email_api "https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/api/emails/route.ts"
click node_gmail_lib "https://github.com/barathbalasubramanian/email-summarizer/blob/main/lib/gmail.ts"
click node_email_list "https://github.com/barathbalasubramanian/email-summarizer/blob/main/components/email-list.tsx"
click node_dashboard_header "https://github.com/barathbalasubramanian/email-summarizer/blob/main/components/dashboard-header.tsx"
click node_dashboard_stats "https://github.com/barathbalasubramanian/email-summarizer/blob/main/components/dashboard-stats.tsx"
click node_email_preview "https://github.com/barathbalasubramanian/email-summarizer/blob/main/components/email-preview.tsx"
click node_summary_api "https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/api/emails/%5Bid%5D/summary/route.ts"
click node_summarizer "https://github.com/barathbalasubramanian/email-summarizer/blob/main/lib/ai-summarizer.ts"
click node_feature_promises "https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/page.tsx"

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_landing,node_auth_start,node_google_oauth,node_auth_callback,node_token_cookie,node_feature_promises,node_user toneBlue
class node_dashboard,node_email_api,node_gmail_lib,node_gmail_service toneAmber
class node_summary_api,node_summarizer,node_openai toneMint
class node_email_list,node_dashboard_header,node_dashboard_stats,node_email_preview toneRose
```

## Components

### Entry and Auth

- [Connect landing page](https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/page.tsx): `app/page.tsx`
- [OAuth URL route](https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/api/auth/google/route.ts): `app/api/auth/google/route.ts`
- **Google OAuth**
- [OAuth callback](https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/api/auth/callback/route.ts): `app/api/auth/callback/route.ts`
- **Token cookie**
- [Privacy and smart insights](https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/page.tsx): `app/page.tsx`

### Email Workflow

- [Dashboard controller](https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/dashboard/page.tsx): `app/dashboard/page.tsx`
- [Inbox API](https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/api/emails/route.ts): `app/api/emails/route.ts`
- [Gmail integration](https://github.com/barathbalasubramanian/email-summarizer/blob/main/lib/gmail.ts): `lib/gmail.ts`
- **Gmail API**

### AI Insights

- [Summary API](https://github.com/barathbalasubramanian/email-summarizer/blob/main/app/api/emails/%5Bid%5D/summary/route.ts): `app/api/emails/[id]/summary/route.ts`
- [Summary generation](https://github.com/barathbalasubramanian/email-summarizer/blob/main/lib/ai-summarizer.ts): `lib/ai-summarizer.ts`
- **OpenAI service**

### Dashboard UI

- [Email list](https://github.com/barathbalasubramanian/email-summarizer/blob/main/components/email-list.tsx): `components/email-list.tsx`
- [Dashboard header](https://github.com/barathbalasubramanian/email-summarizer/blob/main/components/dashboard-header.tsx): `components/dashboard-header.tsx`
- [Dashboard statistics](https://github.com/barathbalasubramanian/email-summarizer/blob/main/components/dashboard-stats.tsx): `components/dashboard-stats.tsx`
- [Email preview](https://github.com/barathbalasubramanian/email-summarizer/blob/main/components/email-preview.tsx): `components/email-preview.tsx`

### Other components

- **Email user**

## Connections

- Email user → Connect landing page: opens app (evidence: `app/page.tsx`)
- Connect landing page → OAuth URL route: requests auth URL (evidence: `app/page.tsx`)
- OAuth URL route → Gmail integration: gets auth URL (evidence: `app/api/auth/google/route.ts`)
- Gmail integration → Google OAuth: creates authorization URL (evidence: `lib/gmail.ts`)
- Email user → Google OAuth: authorizes account
- Google OAuth → OAuth callback: redirects with code (evidence: `app/api/auth/callback/route.ts`)
- OAuth callback → Gmail integration: exchanges code (evidence: `app/api/auth/callback/route.ts`)
- Gmail integration → Google OAuth: exchanges code (evidence: `lib/gmail.ts`)
- OAuth callback → Token cookie: stores tokens (evidence: `app/api/auth/callback/route.ts`)
- Dashboard controller → Inbox API: fetches inbox pages (evidence: `app/dashboard/page.tsx`)
- Inbox API → Token cookie: reads tokens (evidence: `app/api/emails/route.ts`)
- Inbox API → Gmail integration: fetches emails (evidence: `app/api/emails/route.ts`)
- Gmail integration → Gmail API: lists and reads messages (evidence: `lib/gmail.ts`)
- Dashboard controller → Email list: renders and handles selection (evidence: `app/dashboard/page.tsx`)
- Dashboard controller → Email preview: renders selected email (evidence: `app/dashboard/page.tsx`)
- Dashboard controller → Dashboard header: renders (evidence: `app/dashboard/page.tsx`)
- Dashboard controller → Dashboard statistics: renders (evidence: `app/dashboard/page.tsx`)
- Email preview → Summary API: requests summary (evidence: `components/email-preview.tsx`)
- Summary API → Gmail integration: loads email (evidence: `app/api/emails/[id]/summary/route.ts`)
- Summary API → Summary generation: generates summary (evidence: `app/api/emails/[id]/summary/route.ts`)
- Summary generation → OpenAI service: requests analysis (evidence: `lib/ai-summarizer.ts`)
- Connect landing page → Privacy and smart insights: presents capabilities (evidence: `app/page.tsx`)
