# wong2/chatgpt-google-extension architecture

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

- Interactive diagram: https://gitdiagram.com/wong2/chatgpt-google-extension
- Repository: https://github.com/wong2/chatgpt-google-extension

## Overview

ChatGPT for Google is a browser extension that adds AI answers beside search results across ten documented search engines. Its main workflow detects a search query, mounts an answer panel, streams a response through the background process from the selected ChatGPT or OpenAI provider, and renders the answer with Markdown and code highlighting. Options configure provider, trigger mode, theme, and language; the popup also exposes ChatGPT login status. The graph follows documented features and indexed references; unsampled provider-selection and promotion details are represented only where the index supports them.

Main entry points: [`src/background/index.ts`](https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/index.ts) (Message dispatcher), [`src/content-script/index.tsx`](https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/index.tsx) (Page integration), [`src/content-script/ChatGPTContainer.tsx`](https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/ChatGPTContainer.tsx) (Answer panel), [`src/content-script/ChatGPTQuery.tsx`](https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/ChatGPTQuery.tsx) (Answer query)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_search["Search integration"]
  node_siteconfig["Engine selectors"]
  node_contententry["Page integration<br/>[index.tsx]"]
end

subgraph group_interface["Extension interface"]
  node_panel["Answer panel"]
  node_answercard["Answer card<br/>[ChatGPTCard.tsx]"]
  node_query["Answer query<br/>[ChatGPTQuery.tsx]"]
  node_feedback["Answer feedback"]
  node_promotion["Promotion card<br/>[Promotion.tsx]"]
end

subgraph group_settings["Settings and state"]
  node_options["Options page<br/>[App.tsx]"]
  node_providerselect["Provider settings<br/>[ProviderSelect.tsx]"]
  node_popup["Extension popup<br/>[App.tsx]"]
  node_config[("User configuration<br/>[config.ts]")]
end

subgraph group_generation["Answer generation"]
  node_background["Message dispatcher<br/>[index.ts]"]
  node_providertypes["Provider contract<br/>[types.ts]"]
  node_chatgpt["ChatGPT provider<br/>[chatgpt.ts]"]
  node_openai["OpenAI provider<br/>[openai.ts]"]
  node_sse["SSE reader<br/>[fetch-sse.ts]"]
  node_stream["Stream iterator"]
end

node_user(("Search user"))
node_engines(("Search engines"))
node_chatgptservice{{"ChatGPT service"}}
node_openaiservice{{"OpenAI API"}}
node_extensionapi{{"Extension service API"}}

node_user -->|"searches"| node_engines
node_engines -->|"loads extension"| node_contententry
node_contententry -->|"selects selectors"| node_siteconfig
node_contententry -->|"reads preferences"| node_config
node_contententry -->|"mounts panel"| node_panel
node_panel -->|"renders card"| node_answercard
node_panel -->|"renders query"| node_query
node_panel -->|"renders promotion"| node_promotion
node_query -->|"requests answer"| node_background
node_query -->|"renders feedback"| node_feedback
node_query -->|"sends feedback"| node_background
node_options -->|"reads and saves"| node_config
node_options -->|"renders selector"| node_providerselect
node_providerselect -->|"saves provider"| node_config
node_popup -->|"requests token"| node_background
node_background -->|"loads provider config"| node_config
node_background -->|"uses contract"| node_providertypes
node_background -->|"selects provider"| node_chatgpt
node_background -->|"selects provider"| node_openai
node_chatgpt -->|"streams response"| node_sse
node_openai -->|"streams response"| node_sse
node_sse -->|"iterates chunks"| node_stream
node_chatgpt -->|"calls API"| node_chatgptservice
node_openai -.->|"calls API"| node_openaiservice
node_promotion -.->|"fetches promotion"| node_extensionapi

click node_siteconfig "https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/search-engine-configs.ts"
click node_contententry "https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/index.tsx"
click node_panel "https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/ChatGPTContainer.tsx"
click node_answercard "https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/ChatGPTCard.tsx"
click node_query "https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/ChatGPTQuery.tsx"
click node_feedback "https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/ChatGPTFeedback.tsx"
click node_promotion "https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/Promotion.tsx"
click node_options "https://github.com/wong2/chatgpt-google-extension/blob/main/src/options/App.tsx"
click node_providerselect "https://github.com/wong2/chatgpt-google-extension/blob/main/src/options/ProviderSelect.tsx"
click node_popup "https://github.com/wong2/chatgpt-google-extension/blob/main/src/popup/App.tsx"
click node_config "https://github.com/wong2/chatgpt-google-extension/blob/main/src/config.ts"
click node_background "https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/index.ts"
click node_providertypes "https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/types.ts"
click node_chatgpt "https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/providers/chatgpt.ts"
click node_openai "https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/providers/openai.ts"
click node_sse "https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/fetch-sse.ts"
click node_stream "https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/stream-async-iterable.ts"

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_siteconfig,node_contententry,node_user toneBlue
class node_panel,node_answercard,node_query,node_feedback,node_promotion toneAmber
class node_options,node_providerselect,node_popup,node_config,node_openaiservice,node_extensionapi toneMint
class node_background,node_providertypes,node_chatgpt,node_openai,node_sse,node_stream toneRose
class node_engines,node_chatgptservice toneIndigo
```

## Components

### Search integration

- [Engine selectors](https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/search-engine-configs.ts): `src/content-script/search-engine-configs.ts`
- [Page integration](https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/index.tsx): `src/content-script/index.tsx`

### Extension interface

- [Answer panel](https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/ChatGPTContainer.tsx): `src/content-script/ChatGPTContainer.tsx`
- [Answer card](https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/ChatGPTCard.tsx): `src/content-script/ChatGPTCard.tsx`
- [Answer query](https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/ChatGPTQuery.tsx): `src/content-script/ChatGPTQuery.tsx`
- [Answer feedback](https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/ChatGPTFeedback.tsx): `src/content-script/ChatGPTFeedback.tsx`
- [Promotion card](https://github.com/wong2/chatgpt-google-extension/blob/main/src/content-script/Promotion.tsx): `src/content-script/Promotion.tsx`

### Settings and state

- [Options page](https://github.com/wong2/chatgpt-google-extension/blob/main/src/options/App.tsx): `src/options/App.tsx`
- [Provider settings](https://github.com/wong2/chatgpt-google-extension/blob/main/src/options/ProviderSelect.tsx): `src/options/ProviderSelect.tsx`
- [Extension popup](https://github.com/wong2/chatgpt-google-extension/blob/main/src/popup/App.tsx): `src/popup/App.tsx`
- [User configuration](https://github.com/wong2/chatgpt-google-extension/blob/main/src/config.ts): `src/config.ts`

### Answer generation

- [Message dispatcher](https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/index.ts): `src/background/index.ts`
- [Provider contract](https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/types.ts): `src/background/types.ts`
- [ChatGPT provider](https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/providers/chatgpt.ts): `src/background/providers/chatgpt.ts`
- [OpenAI provider](https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/providers/openai.ts): `src/background/providers/openai.ts`
- [SSE reader](https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/fetch-sse.ts): `src/background/fetch-sse.ts`
- [Stream iterator](https://github.com/wong2/chatgpt-google-extension/blob/main/src/background/stream-async-iterable.ts): `src/background/stream-async-iterable.ts`

### Other components

- **Search user**
- **Search engines**
- **ChatGPT service**
- **OpenAI API**
- **Extension service API**

## Connections

- Search user → Search engines: searches (evidence: `README.md`)
- Search engines → Page integration: loads extension (evidence: `src/content-script/index.tsx`)
- Page integration → Engine selectors: selects selectors (evidence: `src/content-script/index.tsx`)
- Page integration → User configuration: reads preferences (evidence: `src/content-script/index.tsx`)
- Page integration → Answer panel: mounts panel (evidence: `src/content-script/index.tsx`)
- Answer panel → Answer card: renders card (evidence: `src/content-script/ChatGPTContainer.tsx`)
- Answer panel → Answer query: renders query (evidence: `src/content-script/ChatGPTContainer.tsx`)
- Answer panel → Promotion card: renders promotion (evidence: `src/content-script/ChatGPTContainer.tsx`)
- Answer query → Message dispatcher: requests answer (evidence: `src/content-script/ChatGPTQuery.tsx`)
- Answer query → Answer feedback: renders feedback (evidence: `src/content-script/ChatGPTQuery.tsx`)
- Answer query → Message dispatcher: sends feedback (evidence: `src/background/index.ts`)
- Options page → User configuration: reads and saves (evidence: `src/options/App.tsx`)
- Options page → Provider settings: renders selector (evidence: `src/options/App.tsx`)
- Provider settings → User configuration: saves provider (evidence: `src/options/ProviderSelect.tsx`)
- Extension popup → Message dispatcher: requests token (evidence: `src/popup/App.tsx`)
- Message dispatcher → User configuration: loads provider config (evidence: `src/background/index.ts`)
- Message dispatcher → Provider contract: uses contract (evidence: `src/background/index.ts`)
- Message dispatcher → ChatGPT provider: selects provider (evidence: `src/background/index.ts`)
- Message dispatcher → OpenAI provider: selects provider (evidence: `src/background/index.ts`)
- ChatGPT provider → SSE reader: streams response (evidence: `src/background/providers/chatgpt.ts`)
- OpenAI provider → SSE reader: streams response (evidence: `src/background/providers/openai.ts`)
- SSE reader → Stream iterator: iterates chunks (evidence: `src/background/fetch-sse.ts`)
- ChatGPT provider → ChatGPT service: calls API (evidence: `src/background/providers/chatgpt.ts`)
- OpenAI provider → OpenAI API: calls API
- Promotion card → Extension service API: fetches promotion
