Backlog

Next up

In Progress

Done

Main Roadmap

Edge runs Chromium MV3 — should accept the same zip with minimal changes. Firefox needs <code>browser.*</code> namespace bridging via webextension-polyfill and SW differences testing.

In Review

Edge Add-ons + Firefox listings

Shane

Currently Magpie ships as an unpacked extension via GitHub Releases. Goal: get it on the Chrome Web Store for one-click install.Blockers: need 5 screenshots (1280×800), promo image (440×280), description text in EN+ZH, justification for each permission, and the $5 one-time developer registration. Review takes 3-7 days.

Chrome Web Store listing

Some sites have unique HTML structures (callout boxes, code blocks with line-numbers, etc.) that need custom turndown rules to convert cleanly. Let users register rules per hostname in options.Implementation: <code>siteRules: Record&lt;hostname, RuleConfig[]&gt;</code> in settings; turndown picks up rules matching <code>article.sourceUrl</code>.

Per-domain custom turndown rules

For users who want to review before merging into main: each save creates a new branch + opens a PR rather than push to main directly.Implementation: options gains a "direct push / open PR" toggle; git-data.ts gains createBranch + createPullRequest; pipeline branches by config.

PR mode — open a pull request instead of pushing directly

Pick 3+ related articles across tabs and combine them into a single markdown file (with section headings per source) committed in one go. Useful for building "reading collections" or topic digests.

Multi-page collation — combine related articles into one capture

Currently the popup preview shows raw <code>$...$</code> math expressions. Render them visually for a better preview experience.Implementation: popup imports the katex library, applies it to preview textContent.

KaTeX preview rendering in popup

Let users define their own frontmatter schema in options (e.g. <code>category</code>, <code>status: draft</code>, custom enums). Currently the schema is hard-coded.

Custom frontmatter fields

chrome:// / extension:// / Web Store pages can't be content-script injected, so Magpie can't capture them. Workaround: have the SW fetch the page URL into an offscreen document and run Readability there.Implementation: new src/offscreen/, manifest gains "offscreen" permission. Chrome 109+.

Restricted-page fallback via offscreen document

Network drop or GitHub timeout currently means the article is lost (only cached briefly in SW memory). Queue failed saves to chrome.storage and retry when network comes back.Trade-off: serializing image bytes to storage is heavy — may need to chunk or cap. Estimated medium effort.

Offline retry queue for failed saves

Some CDNs (WeChat, JianShu, etc.) reject image requests without a matching Referer header → image download fails with 403. Currently Magpie keeps the remote URL on failure; ideally we should retry with a forged Referer.Implementation: use <code>chrome.declarativeNetRequest</code> to dynamically add <code>Referer: &lt;source_url&gt;</code> on image fetches. Retry once on 403.

Hot-link image handling — add Referer header to fetch

Add an editable input in popup showing the current slug (pre-filled with translation/pinyin result). Lets users override when the auto-generated slug isn't satisfying.Implementation: popup adds an input, SAVE_TO_GITHUB message gains <code>customSlug?: string</code> field.

Planned

Custom slug input — edit folder name before save

Right now Magpie commits to a single configured repo. Many users want: tech articles → repo A, life notes → repo B. Pick at save time via dropdown.Implementation sketch:<ul><li>Settings becomes Settings[] + defaultRepoIndex</li><li>Options page gains a repo list manager (add/edit/delete)</li><li>Popup gains a repo dropdown next to Save button</li><li>Optional: auto-route by URL hostname</li></ul>

Multi-repo support — pick destination repo when saving

Add a tab to popup showing the most recent 20 saved articles: slug + time + commit URL. Lets users quickly revisit what they captured.Implementation sketch:<ul><li>New <code>src/lib/storage/history.ts</code> with chrome.storage.local ring buffer (20 entries)</li><li>Push <code>{ slug, title, url, commitSha, savedAt }</code> after each successful save</li><li>Popup gains a tab toggle, new pane renders the list</li></ul>

History list — show recently saved articles in popup

Uses Chrome's built-in Translator API (Gemini Nano, on-device, free, private). Three-tier fallback: Translator → pinyin → sanitize. Frontmatter title keeps the original; only the folder slug becomes English.Released in v0.3.

Completed

Chinese title translation for English slug (Gemini Nano)

Auto-extract tags from OpenGraph / JSON-LD / meta keywords / site-mapping rules. Editable chip UI in popup.Released in v0.2.

Tag auto-suggestion from page metadata

Sidebar navigation, hash routing (#/settings, #/ai, #/images, #/guide, #/feedback, #/about). 1000px fixed-width card layout. Click brand logo opens About page with project value proposition.Released in v0.5.0 and refined through v0.7.0.

Options page — sidebar layout with Settings / AI / Image Hosting / Guide / Feedback tabs

Custom i18n implementation that lets users override Chrome's UI language pin. All UI strings have zh_CN + en variants. About 200+ keys.Released in v0.3.0.

Bilingual i18n (Chinese / English) with language switcher

Auto-opens after install: Welcome → Prepare GitHub repo + PAT → Configure + test connection → Done. Form re-uses settings + testConnection from options page.Released in v0.3.0.

Onboarding flow — 4-step welcome wizard on first install

Popup wizard restructure: Extract → (AI Boost?) → Upload → Result. Dynamic step count based on whether AI Boost is enabled. AI step output flows back to extract-done for review before [Confirm save] / [Re-run AI].Sticky action button at panel bottom stays visible when content scrolls. Confetti on commit success (3-color brand palette).Released across v0.4.0 and v0.6.0.

Capture wizard — 3-step / 4-step adaptive flow

Push images to your own S3 / R2 / Aliyun OSS / Tencent COS / MinIO bucket instead of into the GitHub repo. Article repos stay text-only.<ul><li>Pure-TS AWS Signature V4 (Web Crypto API), no SDK</li><li>Verified against AWS docs known-answer test</li><li>Date-prefixed keys: pathPrefix/YYYY/MM/DD/sha8.ext</li><li>Failed uploads silently fall back to GitHub repo</li><li>Test Upload button to verify CORS + credentials</li></ul>Released in v0.7.0.

Image Hosting — push images to your S3-compatible bucket

Plug in your own OpenAI-compatible / Anthropic LLM endpoint. Four independent capabilities, each with its own switch and silent fallback.<ul><li>Auto-extract tags from full article content</li><li>Auto-generate 1-2 sentence summary into frontmatter excerpt</li><li>Optimize article slug (LLM → Translator → pinyin three-tier fallback)</li><li>Clean up converted markdown formatting</li></ul>Released in v0.6.0. Concurrent execution via Promise.all (~50-70% faster than sequential).