FabledCurator/extension/README.md

FabledCurator Firefox Extension

Self-hosted Firefox extension that pushes session cookies from supported platforms (Patreon, SubscribeStar, Hentai-Foundry, Discord, Pixiv, DeviantArt) into FabledCurator, and lets you add a creator as a Source from their page in one click.

Install (operator)

The signed XPI is bundled into the FC Docker image. Open FC → Settings → Maintenance → Browser extension → click "Install Firefox extension". Firefox shows its native install prompt. After installing, open the extension's options page (about:addons → FabledCurator → Preferences) and paste in the FC URL + extension API key shown on the same card.

Develop

cd extension/
npm install --no-save        # web-ext only
npm run lint                 # web-ext lint
npm run start                # launches Firefox with extension loaded
npm run build                # unsigned XPI in web-ext-artifacts/

Smoke checklist (after every release that touches extension/**)

• npm run lint passes
• npm run start loads the extension in a clean Firefox profile
• Options page accepts FC URL + key, indicator turns green
• Cookie export: log into patreon.com, click Patreon card → "X cookies exported"
• Discord token: open discord.com, click Discord card → "Token captured"
• Pixiv OAuth: click Pixiv card → login redirects, token stored
• Add as source: visit patreon.com/, click floating button → toast
• Subscriptions list: popup → "Sources" tab → list renders
• Check now: click play icon on source row → no error toast

Release

Bump manifest.json + package.json SemVer (both files) and commit under extension/**. The .forgejo/workflows/extension.yml workflow runs web-ext sign on main, commits the signed XPI to frontend/public/extension/, and the next FC server build bundles it into the Docker image.