How trebuuu/fluidextension works
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: background.js Service worker · fluidtalk.js FluidTalk client · sidepanel.js Side panel · update.js Release checker
Components 21
Extension control
- Side panel
src/sidepanel/sidepanel.js - Service worker
src/background.js - Activity log
src/background.js
Platform adapters
- Instagram adapter
src/content/instagram.js - Threads adapter
src/content/threads.js - Telegram adapter
src/content/telegram.js - WhatsApp adapter
src/content/whatsapp.js
Engagement workflows
- DM replies
src/background.js - Follow-up sweeps
src/background.js - Lead outreach
src/background.js - Post comments
src/background.js - Comment replies
src/background.js - Schedule and limits
src/background.js
Configuration and status
- Platform registry
src/lib/platforms.js - Settings and presets
src/lib/settings.js
External services
- FluidTalk client
src/lib/fluidtalk.js - FluidTalk API
- Release checker
src/lib/update.js - Release feed
Other components
- Operator
- Platform websites
Connections 30
- Operator → Side panel: configures and starts
README.md - Side panel → Service worker: sends runtime messages
README.md - Service worker → Side panel: returns state and logs
README.md - Platform websites → Instagram adapter: provides page DOM
README.md - Instagram adapter → Service worker: exchanges messages
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
src/background.js - Service worker → Platform registry: checks platform rules
src/background.js - Side panel → Settings and presets: edits and imports
README.md - Service worker → DM replies: runs inbox replies
README.md - Service worker → Follow-up sweeps: runs follow-up sweeps
src/background.js - Service worker → Lead outreach: runs outreach pass
README.md - Service worker → Post comments: requests post comments
src/background.js - Service worker → Comment replies: requests comment replies
src/background.js - Service worker → Schedule and limits: checks schedule windows
src/background.js - Schedule and limits → Settings and presets: reads schedule rules
src/background.js - Service worker → Activity log: records outcomes
README.md - Side panel → Activity log: displays activity
README.md - DM replies → FluidTalk client: requests chat replies
README.md - Follow-up sweeps → FluidTalk client: requests follow-up queue
src/background.js - Lead outreach → FluidTalk client: requests outreach
src/background.js - Post comments → FluidTalk client: requests comments
src/background.js - Comment replies → FluidTalk client: requests reply generation
src/background.js - Service worker → FluidTalk client: uses API client
src/background.js - FluidTalk client → FluidTalk API: sends HTTPS requests
src/lib/fluidtalk.js - Service worker → Release checker: checks for releases
README.md - Side panel → Release checker: shows update status
README.md - Release checker → Release feed: fetches release metadata
src/lib/update.js