# trebuuu/fluidextension architecture

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

- Interactive diagram: https://gitdiagram.com/trebuuu/fluidextension
- Repository: https://github.com/trebuuu/fluidextension

## Overview

FluidExtension is a Chrome extension that automates direct-message replies and related engagement through a side panel. The service worker is the runtime orchestrator: it applies settings and platform capability rules, communicates with page adapters, and keeps the FluidTalk token out of page scripts. The graph preserves the documented follow-up, outreach, comment, scheduling, preset, activity, and update-check branches. The README and excerpts establish the main worker/API/panel relationships; adapter-to-worker links for platforms beyond Instagram are shown as unverified because their wiring was not excerpted.

Main entry points: [`src/background.js`](https://github.com/trebuuu/fluidextension/blob/main/src/background.js) (Service worker), [`src/lib/fluidtalk.js`](https://github.com/trebuuu/fluidextension/blob/main/src/lib/fluidtalk.js) (FluidTalk client), [`src/sidepanel/sidepanel.js`](https://github.com/trebuuu/fluidextension/blob/main/src/sidepanel/sidepanel.js) (Side panel), [`src/lib/update.js`](https://github.com/trebuuu/fluidextension/blob/main/src/lib/update.js) (Release checker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Extension control"]
  node_panel["Side panel<br/>[sidepanel.js]"]
  node_worker["Service worker<br/>[background.js]"]
  node_activity[("Activity log<br/>[background.js]")]
end

subgraph group_platforms["Platform adapters"]
  node_instagram["Instagram adapter<br/>[instagram.js]"]
  node_threads["Threads adapter<br/>[threads.js]"]
  node_telegram["Telegram adapter<br/>[telegram.js]"]
  node_whatsapp["WhatsApp adapter<br/>[whatsapp.js]"]
end

subgraph group_engagement["Engagement workflows"]
  node_dm["DM replies<br/>[background.js]"]
  node_followups["Follow-up sweeps<br/>[background.js]"]
  node_outreach["Lead outreach<br/>[background.js]"]
  node_comments["Post comments<br/>[background.js]"]
  node_comment_replies["Comment replies<br/>[background.js]"]
  node_scheduler["Schedule and limits<br/>[background.js]"]
end

subgraph group_configuration["Configuration and status"]
  node_platforms_registry["Platform registry<br/>[platforms.js]"]
  node_settings[("Settings and presets<br/>[settings.js]")]
end

subgraph group_services["External services"]
  node_fluidtalk_client["FluidTalk client<br/>[fluidtalk.js]"]
  node_fluidtalk_service{{"FluidTalk API"}}
  node_release_check["Release checker<br/>[update.js]"]
  node_release_feed{{"Release feed"}}
end

node_user(("Operator"))
node_platform_sites{{"Platform websites"}}

node_user -->|"configures and starts"| node_panel
node_panel -->|"sends runtime messages"| node_worker
node_worker -->|"returns state and logs"| node_panel
node_platform_sites -->|"provides page DOM"| node_instagram
node_instagram -->|"exchanges messages"| node_worker
node_worker -.->|"dispatches page work"| node_threads
node_worker -.->|"dispatches page work"| node_telegram
node_worker -.->|"dispatches page work"| node_whatsapp
node_worker -->|"loads and applies"| node_settings
node_worker -->|"checks platform rules"| node_platforms_registry
node_panel -->|"edits and imports"| node_settings
node_worker -->|"runs inbox replies"| node_dm
node_worker -->|"runs follow-up sweeps"| node_followups
node_worker -->|"runs outreach pass"| node_outreach
node_worker -->|"requests post comments"| node_comments
node_worker -->|"requests comment replies"| node_comment_replies
node_worker -->|"checks schedule windows"| node_scheduler
node_scheduler -->|"reads schedule rules"| node_settings
node_worker -->|"records outcomes"| node_activity
node_panel -->|"displays activity"| node_activity
node_dm -->|"requests chat replies"| node_fluidtalk_client
node_followups -->|"requests follow-up queue"| node_fluidtalk_client
node_outreach -.->|"requests outreach"| node_fluidtalk_client
node_comments -->|"requests comments"| node_fluidtalk_client
node_comment_replies -->|"requests reply generation"| node_fluidtalk_client
node_worker -->|"uses API client"| node_fluidtalk_client
node_fluidtalk_client -->|"sends HTTPS requests"| node_fluidtalk_service
node_worker -->|"checks for releases"| node_release_check
node_panel -->|"shows update status"| node_release_check
node_release_check -->|"fetches release metadata"| node_release_feed

click node_panel "https://github.com/trebuuu/fluidextension/blob/main/src/sidepanel/sidepanel.js"
click node_worker "https://github.com/trebuuu/fluidextension/blob/main/src/background.js"
click node_instagram "https://github.com/trebuuu/fluidextension/blob/main/src/content/instagram.js"
click node_threads "https://github.com/trebuuu/fluidextension/blob/main/src/content/threads.js"
click node_telegram "https://github.com/trebuuu/fluidextension/blob/main/src/content/telegram.js"
click node_whatsapp "https://github.com/trebuuu/fluidextension/blob/main/src/content/whatsapp.js"
click node_platforms_registry "https://github.com/trebuuu/fluidextension/blob/main/src/lib/platforms.js"
click node_settings "https://github.com/trebuuu/fluidextension/blob/main/src/lib/settings.js"
click node_dm "https://github.com/trebuuu/fluidextension/blob/main/src/background.js"
click node_followups "https://github.com/trebuuu/fluidextension/blob/main/src/background.js"
click node_outreach "https://github.com/trebuuu/fluidextension/blob/main/src/background.js"
click node_comments "https://github.com/trebuuu/fluidextension/blob/main/src/background.js"
click node_comment_replies "https://github.com/trebuuu/fluidextension/blob/main/src/background.js"
click node_scheduler "https://github.com/trebuuu/fluidextension/blob/main/src/background.js"
click node_activity "https://github.com/trebuuu/fluidextension/blob/main/src/background.js"
click node_fluidtalk_client "https://github.com/trebuuu/fluidextension/blob/main/src/lib/fluidtalk.js"
click node_release_check "https://github.com/trebuuu/fluidextension/blob/main/src/lib/update.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_panel,node_worker,node_activity toneBlue
class node_instagram,node_threads,node_telegram,node_whatsapp toneAmber
class node_dm,node_followups,node_outreach,node_comments,node_comment_replies,node_scheduler toneMint
class node_platforms_registry,node_settings toneRose
class node_fluidtalk_client,node_fluidtalk_service,node_release_check,node_release_feed,node_user,node_platform_sites toneIndigo
```

## Components

### Extension control

- [Side panel](https://github.com/trebuuu/fluidextension/blob/main/src/sidepanel/sidepanel.js): `src/sidepanel/sidepanel.js`
- [Service worker](https://github.com/trebuuu/fluidextension/blob/main/src/background.js): `src/background.js`
- [Activity log](https://github.com/trebuuu/fluidextension/blob/main/src/background.js): `src/background.js`

### Platform adapters

- [Instagram adapter](https://github.com/trebuuu/fluidextension/blob/main/src/content/instagram.js): `src/content/instagram.js`
- [Threads adapter](https://github.com/trebuuu/fluidextension/blob/main/src/content/threads.js): `src/content/threads.js`
- [Telegram adapter](https://github.com/trebuuu/fluidextension/blob/main/src/content/telegram.js): `src/content/telegram.js`
- [WhatsApp adapter](https://github.com/trebuuu/fluidextension/blob/main/src/content/whatsapp.js): `src/content/whatsapp.js`

### Engagement workflows

- [DM replies](https://github.com/trebuuu/fluidextension/blob/main/src/background.js): `src/background.js`
- [Follow-up sweeps](https://github.com/trebuuu/fluidextension/blob/main/src/background.js): `src/background.js`
- [Lead outreach](https://github.com/trebuuu/fluidextension/blob/main/src/background.js): `src/background.js`
- [Post comments](https://github.com/trebuuu/fluidextension/blob/main/src/background.js): `src/background.js`
- [Comment replies](https://github.com/trebuuu/fluidextension/blob/main/src/background.js): `src/background.js`
- [Schedule and limits](https://github.com/trebuuu/fluidextension/blob/main/src/background.js): `src/background.js`

### Configuration and status

- [Platform registry](https://github.com/trebuuu/fluidextension/blob/main/src/lib/platforms.js): `src/lib/platforms.js`
- [Settings and presets](https://github.com/trebuuu/fluidextension/blob/main/src/lib/settings.js): `src/lib/settings.js`

### External services

- [FluidTalk client](https://github.com/trebuuu/fluidextension/blob/main/src/lib/fluidtalk.js): `src/lib/fluidtalk.js`
- **FluidTalk API**
- [Release checker](https://github.com/trebuuu/fluidextension/blob/main/src/lib/update.js): `src/lib/update.js`
- **Release feed**

### Other components

- **Operator**
- **Platform websites**

## Connections

- Operator → Side panel: configures and starts (evidence: `README.md`)
- Side panel → Service worker: sends runtime messages (evidence: `README.md`)
- Service worker → Side panel: returns state and logs (evidence: `README.md`)
- Platform websites → Instagram adapter: provides page DOM (evidence: `README.md`)
- Instagram adapter → Service worker: exchanges messages (evidence: `README.md`)
- Service worker → Threads adapter: dispatches page work
- Service worker → Telegram adapter: dispatches page work
- Service worker → WhatsApp adapter: dispatches page work
- Service worker → Settings and presets: loads and applies (evidence: `src/background.js`)
- Service worker → Platform registry: checks platform rules (evidence: `src/background.js`)
- Side panel → Settings and presets: edits and imports (evidence: `README.md`)
- Service worker → DM replies: runs inbox replies (evidence: `README.md`)
- Service worker → Follow-up sweeps: runs follow-up sweeps (evidence: `src/background.js`)
- Service worker → Lead outreach: runs outreach pass (evidence: `README.md`)
- Service worker → Post comments: requests post comments (evidence: `src/background.js`)
- Service worker → Comment replies: requests comment replies (evidence: `src/background.js`)
- Service worker → Schedule and limits: checks schedule windows (evidence: `src/background.js`)
- Schedule and limits → Settings and presets: reads schedule rules (evidence: `src/background.js`)
- Service worker → Activity log: records outcomes (evidence: `README.md`)
- Side panel → Activity log: displays activity (evidence: `README.md`)
- DM replies → FluidTalk client: requests chat replies (evidence: `README.md`)
- Follow-up sweeps → FluidTalk client: requests follow-up queue (evidence: `src/background.js`)
- Lead outreach → FluidTalk client: requests outreach (evidence: `src/background.js`)
- Post comments → FluidTalk client: requests comments (evidence: `src/background.js`)
- Comment replies → FluidTalk client: requests reply generation (evidence: `src/background.js`)
- Service worker → FluidTalk client: uses API client (evidence: `src/background.js`)
- FluidTalk client → FluidTalk API: sends HTTPS requests (evidence: `src/lib/fluidtalk.js`)
- Service worker → Release checker: checks for releases (evidence: `README.md`)
- Side panel → Release checker: shows update status (evidence: `README.md`)
- Release checker → Release feed: fetches release metadata (evidence: `src/lib/update.js`)
