# kishoraditya/chat-navigator-extension architecture

> Architecture diagram of the GitHub repository kishoraditya/chat-navigator-extension, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kishoraditya/chat-navigator-extension
- Repository: https://github.com/kishoraditya/chat-navigator-extension

## Overview

##### Project type and purpose
- This is a **Chrome extension** (Manifest V3) that injects UI into supported chat websites (ChatGPT, Claude.ai, Grok, etc.)
- Purpose: Add floating “Q” and “C” buttons to parse the page’s DOM, list questions/chats, and enable smooth navigation.

##### File structure
- At the root:
– manifest.json (defines permissions, content scripts, matches)
– ARCHITECTURE.md / README.md (docs)
– LICENSE
- content-scripts/
– ui-handler.js (core UI logic & controller)
– platform parsers (chatgpt.js, claude.js, copilot.js, deepseek.js, gemini.js, grok.js, meta.js, perplexity.js)
- styles/
– floating-ui.css (translucent UI styling)
- No backend or server components—pure client-side.

##### README for additional insights
- Uses **Manifest V3**, **Content Scripts**, **MutationObserver**, **debounced updates**, and **CSS Backdrop Filter**.
- Parsers implement a uniform interface (`getQuestions()`, `getChats()`) for each platform.

##### Main components & their relationships
a. **Browser & Manifest**
– Chrome loads `manifest.json`, grants `activeTab` permission, and injects content scripts on matching URLs.
b. **Content Scripts**
– Platform Parsers: scan the host page’s DOM to extract questions and chat links.
– UI Handler: receives parsed data, renders floating Q/C buttons, handles click events, overlays panels.
c. **Styles**
– floating-ui.css: injected by the UI Handler to style panels and buttons with backdrop blur and positioning.
d. **DOM & Page**
– The live page on supported domains (chat.openai.com, claude.ai, etc.)—source of AST-like data parsed by scripts.
e. **Core interactions:**
1. User navigates to a supported site → Browser (via manifest) injects parsers + ui-handler.js + CSS.
2. Parsers use MutationObserver to watch for new messages or navigation events.
3. On detection (debounced), parsers extract question/chat arrays and emit them to UI Handler.
4. UI Handler builds or updates floating UI overlay, injecting HTML into the page.
5. User clicks Q/C buttons → UI Handler scrolls/smooth-scrolls the host page to the selected element.

##### Architectural patterns & design principles
- **Separation of Concerns**: Each parser file handles a single platform’s DOM quirks; ui-handler.js handles all UI rendering & event wiring.
- **Event-driven**: MutationObserver events drive updates; click events drive navigation.
- **Debouncing**: Limits update frequency for performance.
- **Modular**: New platforms can be added with minimal changes—just drop in a new parser and update manifest.json.

##### Technologies, frameworks, and libraries
- **Manifest V3** (Chrome extension spec)
- **Content Scripts** (injected JavaScript)
- **CSS Backdrop Filter** for translucent UI
- **MutationObserver** (DOM API)
- **Vanilla JS** (no framework)
- **Debounce utility** (in ui-handler.js)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Browser Layer
    subgraph "Browser Layer"
        Manifest["manifest.json"]:::browser
    end

    %% Injection Layer
    subgraph "Injection Layer"
        subgraph "Parsers"
            ChatGPT["ChatGPT Parser"]:::parser
            Claude["Claude Parser"]:::parser
            Copilot["Copilot Parser"]:::parser
            Deepseek["Deepseek Parser"]:::parser
            Gemini["Gemini Parser"]:::parser
            Grok["Grok Parser"]:::parser
            Meta["Meta Parser"]:::parser
            Perplexity["Perplexity Parser"]:::parser
        end
        UIHandler["UI Handler"]:::ui
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        Styles["floating-ui.css"]:::css
    end

    %% Page Layer
    subgraph "Page Layer"
        PageDOM["Host Page DOM"]:::page
    end

    %% Connections
    Manifest -->|"inject content scripts"| ChatGPT
    Manifest -->|"inject content scripts"| Claude
    Manifest -->|"inject content scripts"| Copilot
    Manifest -->|"inject content scripts"| Deepseek
    Manifest -->|"inject content scripts"| Gemini
    Manifest -->|"inject content scripts"| Grok
    Manifest -->|"inject content scripts"| Meta
    Manifest -->|"inject content scripts"| Perplexity
    Manifest -->|"inject ui-handler.js"| UIHandler
    Manifest -->|"inject CSS"| Styles

    ChatGPT -->|"MutationObserver events"| UIHandler
    Claude -->|"MutationObserver events"| UIHandler
    Copilot -->|"MutationObserver events"| UIHandler
    Deepseek -->|"MutationObserver events"| UIHandler
    Gemini -->|"MutationObserver events"| UIHandler
    Grok -->|"MutationObserver events"| UIHandler
    Meta -->|"MutationObserver events"| UIHandler
    Perplexity -->|"MutationObserver events"| UIHandler

    UIHandler -->|"inject HTML overlay"| PageDOM
    UIHandler -->|"inject CSS link"| Styles
    Styles -->|"applies styling"| PageDOM

    PageDOM -->|"user clicks Q/C"| UIHandler
    UIHandler -->|"scroll to element"| PageDOM

    %% Click Events
    click Manifest "https://github.com/kishoraditya/chat-navigator-extension/blob/main/manifest.json"
    click ChatGPT "https://github.com/kishoraditya/chat-navigator-extension/blob/main/content-scripts/chatgpt.js"
    click Claude "https://github.com/kishoraditya/chat-navigator-extension/blob/main/content-scripts/claude.js"
    click Copilot "https://github.com/kishoraditya/chat-navigator-extension/blob/main/content-scripts/copilot.js"
    click Deepseek "https://github.com/kishoraditya/chat-navigator-extension/blob/main/content-scripts/deepseek.js"
    click Gemini "https://github.com/kishoraditya/chat-navigator-extension/blob/main/content-scripts/gemini.js"
    click Grok "https://github.com/kishoraditya/chat-navigator-extension/blob/main/content-scripts/grok.js"
    click Meta "https://github.com/kishoraditya/chat-navigator-extension/blob/main/content-scripts/meta.js"
    click Perplexity "https://github.com/kishoraditya/chat-navigator-extension/blob/main/content-scripts/perplexity.js"
    click UIHandler "https://github.com/kishoraditya/chat-navigator-extension/blob/main/content-scripts/ui-handler.js"
    click Styles "https://github.com/kishoraditya/chat-navigator-extension/blob/main/styles/floating-ui.css"
    click ARCHdoc "https://github.com/kishoraditya/chat-navigator-extension/blob/main/ARCHITECTURE.md"
    click README "https://github.com/kishoraditya/chat-navigator-extension/blob/main/README.md"

    %% Styles
    classDef browser fill:#cce5ff,stroke:#004085,color:#004085;
    classDef parser fill:#d4edda,stroke:#155724,color:#155724;
    classDef ui fill:#fff3cd,stroke:#856404,color:#856404;
    classDef css fill:#f8d7da,stroke:#721c24,color:#721c24;
    classDef page fill:#e2e3e5,stroke:#6c757d,color:#6c757d;
    class ARCHdoc,README docs;
    classDef docs fill:#e2f0fb,stroke:#0b5394,color:#0b5394;
```
