docs: Firefox and Edge for users — install, build, limits, listings

- BUILD.md: rebuilding the release packages, written for Firefox Add-ons'
  source review (Node.js 26 stated outright: the sources archive drops
  .nvmrc), and useful to anyone checking a store build against the source.
- README: a browser/store/requirement table (Edge and Firefox listings not
  live yet, and said so), the Firefox package on each Release is for
  checking, not installing; the privacy section names the same CSP in every
  browser; limits gain Firefox's separators, address and title lengths.
- SECURITY.md: the latest version on each of the three stores is supported.
- ACCESSIBILITY.md: Firefox and Edge are best effort and untested with
  assistive technology; separators are drawn but not announced, and Alt+↑/↓
  past one leaves the spoken position unchanged — a known limitation.
- store/listing.*.md: the AMO and Edge blocks — the two bullets that named
  Chrome rewritten for browsers in general, one more limitation for Firefox,
  and each store's fields. Translations best-effort.
- CHANGELOG: the 1.3.0 entry under [Unreleased] until the bump.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
poli0981andClaude Opus 5.5 committed 2026-11-18 22:10:35 +07:00
1 parent dc4cd06cbb
commit 23f6386d3d
10 files changed
+307 -30

No files matched your search

+14 -7
View File
@@ -6,7 +6,7 @@ page zoomed, or with animation switched off. This file says what that means
today: what the goal is, what has actually been tested, what is known not to
work well yet, and how to tell us about a barrier.
**Last reviewed:** 2026-11-10, for version 1.2.1.
**Last reviewed:** 2026-11-18, for version 1.3.0.
## The goal
@@ -34,8 +34,10 @@ The priorities, in order:
|---|---|
| Chrome 136 or later on Windows | Supported, and where the testing below was done |
| Chrome 136 or later on macOS, Linux and ChromeOS | Supported; expected to work the same, not tested for accessibility |
| Edge, Brave, Vivaldi and Opera (the same build) | Best effort — the extension runs there, and accessibility is untested |
| Edge, Brave, Vivaldi and Opera (the same package as Chrome) | Best effort — the extension runs there, and accessibility is untested |
| Firefox 140 or later on the desktop (since 1.3.0, its own package) | Best effort — the extension runs there, and accessibility is untested |
| Chrome on Android or iOS | Not applicable: Chrome there does not run extensions |
| Firefox for Android | Not applicable: it has no bookmarks API for extensions |
## What is in place
@@ -132,8 +134,8 @@ limitations below).
| What 1.2.1 changed: focus, Alt+↑/↓, button sizes | A scripted keyboard run in Chrome — no screen reader | November 2026, version 1.2.1 |
| Colour contrast of the theme colours, reduced motion, the tree's key handling | Automated tests, on every change | Continuous |
**Not tested**, so we cannot tell you how well they work: anything on macOS,
Linux or ChromeOS; NVDA, JAWS, VoiceOver, ChromeVox and Orca; voice control
**Not tested**, so we cannot tell you how well they work: anything in Firefox
or Edge; anything on macOS, Linux or ChromeOS; NVDA, JAWS, VoiceOver, ChromeVox and Orca; voice control
(Dragon, Voice Access, Voice Control); switch access; screen magnifiers; and
zoom at 200 %. Narrator has not yet been run over what 1.2.1 added.
If you use one of these, a report of what you found — good or bad — is
@@ -158,6 +160,10 @@ These are known, and none of them is by design.
- **Reordering with a pointer needs a drag.** There is a keyboard way
(Alt+↑/↓) and Sort A→Z, but no click-only way to place one item before
another.
- **Separators in Firefox are only drawn.** A line in a Firefox folder is
shown in the tree, but a screen reader is not told it is there, and the
"position n of m" counts bookmarks and folders only — so Alt+↑ or Alt+↓ past
a separator moves the row without changing the position you hear.
- **Alt+↑/↓ may not reach the page on a Chromebook**, where the system can turn
those keys into Page Up and Page Down. On a Mac there is no Menu key (use
Shift+F10), and the laptop's delete key is Backspace, which the tree does
@@ -203,7 +209,8 @@ accessibility report is treated as a defect, not a feature request.
It helps to include:
- what you were trying to do, and what happened instead;
- the BookmarkMagic version (About tab, or `chrome://extensions`);
- the BookmarkMagic version (About tab, `chrome://extensions`, or
`about:addons` in Firefox);
- your browser and operating system;
- the assistive technology you use and its version, if any — a screen reader,
a contrast theme, zoom level, voice control;
@@ -224,8 +231,8 @@ guarantees:
- A report is acknowledged within about a week.
- A **blocking** barrier is fixed ahead of other work and shipped in its own
patch release; Chrome then updates installed copies by itself, usually
within days of the store's review.
patch release; your browser then updates installed copies by itself,
usually within days of the store's review.
- Anything else is scheduled, and added to the list above until it is fixed,
so the next person can see it is known.
- If a fix is not possible or not planned, you will be told why.
+63
View File
@@ -0,0 +1,63 @@
# Building BookmarkMagic from source
How to rebuild the packages attached to each
[GitHub Release](https://github.com/poli0981/bookmarkmagic/releases) — for
Firefox Add-ons reviewers, who must be able to reproduce the submitted package
from its sources, and for anyone who wants to check that a store build matches
this repository.
## Requirements
| Tool | Version | Where |
|---|---|---|
| Node.js | **26** (the version in `.nvmrc`; tested with 26.13) | <https://nodejs.org/en/download> |
| npm | the one bundled with Node.js 26 (11.x) | ships with Node.js |
| OS | any — Windows 11, macOS and Ubuntu all build the same files | |
No other tool, account, network service or environment variable is needed
beyond what `npm ci` installs from `package-lock.json`.
> **The Firefox sources archive omits dotfiles**, so `.nvmrc` and `.npmrc` are
> not in it. Use Node.js 26: an older Node may install but is not what the
> package was built with, and `package.json` says `"engines": { "node": ">=26" }`.
## Steps
```bash
npm ci # exactly the versions in package-lock.json
npm run zip:firefox # the Firefox package (and a sources archive)
npm run zip # the Chromium package (Chrome Web Store, Edge Add-ons)
```
`npm ci` runs one install script of this project's own, `wxt prepare`, which
generates the TypeScript configuration the build reads. (CI installs with
`--ignore-scripts` and runs `npx --no-install wxt prepare` itself; the result
is the same.)
## Output
| Command | Unpacked build | Package |
|---|---|---|
| `npm run zip:firefox` | `.output/firefox-mv3/` | `.output/bookmarkmagic-<version>-firefox.zip` |
| `npm run zip` | `.output/chrome-mv3/` | `.output/bookmarkmagic-<version>-chrome.zip` |
Compare the **files inside** the package with the submitted one, not the
archives themselves: a zip records file times, so two builds of the same
commit hash differently while every entry is identical (`docs/09 §5`).
## What the build does
- [WXT](https://wxt.dev) bundles `src/` with Vite into plain JavaScript, CSS
and HTML. The code is **minified, not obfuscated**.
- The only third-party code compiled in is the Svelte runtime, its `clsx`
helper and WXT's one-line browser shim, all MIT
([`legal/THIRD_PARTY_NOTICES.md`](legal/THIRD_PARTY_NOTICES.md)); the build
fails if anything else would ship.
- Nothing is downloaded at build time beyond `npm ci`, and the built extension
makes no network requests at all — its content security policy forbids them
([`docs/08_MV3_COMPLIANCE.md`](docs/08_MV3_COMPLIANCE.md) §3).
To check a build the way CI does: `npm run check:manifest` (Chromium) and
`npm run check:manifest -- --browser firefox` (Firefox) verify the manifest,
the permissions, the CSP, the file inventory and that no network API is in the
bundle.
+47 -1
View File
@@ -12,7 +12,53 @@ version bump).
## [Unreleased]
Nothing yet.
Firefox and Microsoft Edge, and maintenance mode. Permissions are unchanged
(`bookmarks` and `storage`), nothing is asked of you again, and on Chrome
there is nothing to do — your browser updates itself. This version also
carries everything listed under 1.2.1, which never reached the Chrome Web
Store on its own.
### Added
- **Firefox** (desktop, 140 or later), with a package of its own for Firefox
Add-ons — listing to come. The same features, the same two permissions and
the same no-network policy, which Firefox enforces just as Chrome does.
Firefox's **Bookmarks Menu** is a root like the others: Merge and Replace put
entries back where they came from, and the loose entries of a Firefox
export go into the menu, as Firefox itself does with them.
- **Microsoft Edge Add-ons** — the Chrome package, unchanged; listing to come.
Until then Edge installs from the Chrome Web Store.
- **Firefox separators** show in the Edit tab as lines. Nothing acts on them:
they are not focused, searched, counted, sorted across, or offered as
duplicates of each other. Sort A→Z sorts each run between two separators on
its own.
- Replace on Firefox says how many separators it will delete — no file
BookmarkMagic writes can keep one, so they do not come back with the backup.
- An import says how many separators the file held, and on Firefox skips — and
counts — any address longer than the 65,536 characters Firefox accepts,
before anything is written.
### Changed
- The About tab's store link is now **"Store listing"** and opens the store
your copy came from: the Chrome Web Store for the Chrome Web Store's copy,
Firefox Add-ons in Firefox, and otherwise the README's list of stores.
- Sentences that blamed Chrome for what every browser does now say "the
browser" — "The browser does not let an extension set a bookmark's original
date" — in all five languages; the note about skipped Firefox smart
bookmarks no longer calls them dead links.
- Copy diagnostics names the browser and its version (`"browser": "Firefox
160"`) instead of only Chrome's.
- The project is in **maintenance mode** ([`MAINTENANCE.md`](MAINTENANCE.md)):
fixes, accessibility, translations, security and dependency updates, and
features that are already on the roadmap.
### Packages
Each GitHub Release now carries three files: `…-chrome.zip` (the Chrome Web
Store and Edge Add-ons), `…-firefox.zip` and `…-sources.zip` (what Firefox
Add-ons reviews), with `SHA256SUMS.txt` over all three. [`BUILD.md`](BUILD.md)
explains how to rebuild them.
## [1.2.1] — 2026-11-10
+32 -18
View File
@@ -13,8 +13,9 @@
Move your bookmarks between browsers the simple way: with a file. No account,
no cloud sync, 100% offline.
A Chrome (MV3) extension for importing, exporting and editing bookmarks and
folder trees. English · Tiếng Việt · 日本語 · 简体中文 · Română.
A browser extension (Manifest V3) for importing, exporting and editing
bookmarks and folder trees — for Chrome and the other Chromium browsers, and,
since 1.3.0, for Firefox. English · Tiếng Việt · 日本語 · 简体中文 · Română.
## Project status
@@ -72,11 +73,11 @@ This is the whole point of the project, so it is worth being precise.
- **No network access at all.** Not analytics, not telemetry, not update pings.
There is no server, and the code makes no network calls. The browser backs
that up: the extension's content security policy makes Chrome refuse fetch,
XHR, WebSocket, EventSource and beacon requests, and remote images, fonts,
media and frames. On top of that, `npm run check:manifest` scans the shipped
bundle for network APIs (WebRTC included, which no CSP directive covers) and
`npm run guard` scans the source.
that up: the extension's content security policy — the same in Chrome, Edge
and Firefox — makes the browser refuse fetch, XHR, WebSocket, EventSource and
beacon requests, and remote images, fonts, media and frames. On top of that,
`npm run check:manifest` scans both shipped packages for network APIs (WebRTC
included, which no CSP directive covers) and `npm run guard` scans the source.
- **Exactly two permissions**: `bookmarks` and `storage`. No host permissions,
no content scripts, no background worker. Two gates enforce it: a unit test
over `wxt.config.ts`, and `npm run check:manifest`, which CI runs against the
@@ -98,28 +99,41 @@ Full policy: [`legal/PRIVACY.md`](legal/PRIVACY.md).
## Honest limitations
- Favicons cannot be imported — the bookmarks API has no favicon field.
- Imported bookmarks get today's date. Chrome does not let an extension set a
- Imported bookmarks get today's date. Browsers do not let an extension set a
bookmark's original creation date. Your **exported** files keep the real ones.
- **Firefox separators are not kept.** They show in the Edit tab as lines, but
no file BookmarkMagic writes can hold one: exports and backups leave them out,
imports skip the ones a file holds and say how many, and Replace — which
deletes them with everything else — tells you so before it starts.
- Firefox refuses bookmark addresses longer than 65,536 characters (they are
skipped, and counted) and shortens titles longer than 4,096.
- CSV is a flattened view: empty folders and "which folder is the toolbar" are
not preserved. Use HTML or JSON for a faithful backup.
- Markdown is share-only — BookmarkMagic cannot read it back.
## Install
From the Chrome Web Store: [here](https://chromewebstore.google.com/detail/bookmarkmagic/eghnciphhegekmnofffpgbdfefckdhmg)
| Browser | Where | Requires |
|---|---|---|
| Chrome, Brave, Vivaldi, Opera | [Chrome Web Store](https://chromewebstore.google.com/detail/bookmarkmagic/eghnciphhegekmnofffpgbdfefckdhmg) | Chrome 136 or later (April 2025), or a Chromium browser of the same vintage |
| Microsoft Edge | Edge Add-ons — **not listed yet**; until it is, Edge installs from the Chrome Web Store link above | Edge 136 or later |
| Firefox (desktop) | Firefox Add-ons — **not listed yet**; the link will be here when it is | Firefox 140 or later. Firefox for Android has no bookmarks API for extensions |
Requires Chrome 136 or later (April 2025), or any Chromium browser of the same
vintage — Edge, Brave, Vivaldi, Opera. On an older browser the store keeps the
version you already have and simply stops updating it.
On an older browser the store keeps the version you already have and simply
stops updating it.
From source (Node.js 26):
Each [GitHub Release](https://github.com/poli0981/bookmarkmagic/releases) carries
the exact packages sent to the stores, with `SHA256SUMS.txt`. Firefox only
installs add-ons Mozilla has signed, so its `-firefox.zip` there is for
checking the store build, not for installing.
From source (Node.js 26) — [`BUILD.md`](BUILD.md) has the details:
```bash
npm ci && npm run build
npm ci && npm run build # Chromium: load .output/chrome-mv3/ at chrome://extensions (Developer mode)
npm run build:firefox # Firefox: about:debugging → Load Temporary Add-on → .output/firefox-mv3/manifest.json
```
Then load `.output/chrome-mv3/` at `chrome://extensions` with Developer mode on.
## Development
```bash
@@ -205,5 +219,5 @@ questions: copyright@poli0981.dev.
The BookmarkMagic name and icon identify this project. The GPL lets anyone fork
the code; it does not let a fork present itself as this project.
Not affiliated with or endorsed by Google, Chrome, Mozilla, Firefox or any
browser vendor. Browser names are trademarks of their respective owners.
Not affiliated with or endorsed by Google, Chrome, Mozilla, Firefox,
Microsoft, Edge or any browser vendor. Browser names are trademarks of their respective owners.
+4 -4
View File
@@ -4,13 +4,13 @@
| Version | Supported |
|---|---|
| The latest version published on the Chrome Web Store | ✅ |
| The latest version published on the Chrome Web Store, Firefox Add-ons or Microsoft Edge Add-ons | ✅ |
| Anything older | ❌ |
There is no back-porting, and there is nothing for you to do to stay current:
Chrome auto-updates extensions once a new version passes store review. You can
see which version you are running in the extension's **About** tab, or on
`chrome://extensions`.
your browser updates extensions once a new version passes store review. You
can see which version you are running in the extension's **About** tab, on
`chrome://extensions`, or on `about:addons` in Firefox.
## Reporting a vulnerability
+30
View File
@@ -56,3 +56,33 @@ https://github.com/poli0981/bookmarkmagic
`https://github.com/poli0981/bookmarkmagic/blob/main/legal/PRIVACY.md`
**Distribution:** Public, all regions.
## Firefox Add-ons and Microsoft Edge Add-ons (since v1.3.0)
The description above, with the two bullets that name Chrome replaced by these — on Firefox and Edge they would not be true as written (Edge also refuses a listing that sells itself as a Chrome extension):
```
• Import bookmark files (HTML, JSON, CSV) — including the "Bookmarks" file
from the profile folder of a Chromium browser (Chrome, Edge, Brave…) and
Firefox JSON backups — with a full preview before anything is written:
counts, folders and duplicates first.
```
```
• Imported bookmarks get today's date — browsers don't let extensions set a
bookmark's original creation date. Your exported files keep the real dates.
```
On Firefox Add-ons only, add to LIMITATIONS:
```
• Firefox separators are not kept: exports and backups leave them out, and
Replace deletes them (it tells you first).
```
**Firefox Add-ons:** summary = the summary above (AMO allows 250 characters) ·
category *Bookmarks* · licence *GNU General Public License v3.0* · Firefox
(desktop) only — not Android · the same privacy-policy URL · support site: the
repository's issues.
**Edge Add-ons:** category *Productivity* · the same privacy-policy URL.
+30
View File
@@ -60,3 +60,33 @@ https://github.com/poli0981/bookmarkmagic
法的文書は英語のみです(`docs/14`)。プライバシーポリシーの URL は EN 版と
同じものを使います。
## Firefox Add-ons と Microsoft Edge Add-ons(v1.3.0 以降)
上の説明文のうち、Chrome に触れている 2 項目を次のものに置き換えて使います(Firefox と Edge ではそのままでは正しくなく、Edge は Chrome 拡張機能として紹介するリスティングを受け付けません):
```
• ブックマークファイル(HTML、JSON、CSV)をインポートします。Chromium 系
ブラウザ(Chrome、Edge、Brave など)のプロファイルフォルダにある
「Bookmarks」ファイルや Firefox の JSON バックアップにも対応。書き込む前に
必ずプレビューを表示し、件数・フォルダ・重複を先に確認できます。
```
```
• インポートしたブックマークの日付は本日になります。拡張機能がブックマーク
の元の作成日を設定することをブラウザが許可していないためです。エクスポート
したファイルには本来の日付が残ります。
```
Firefox Add-ons のみ、「制限事項」に追加:
```
• Firefox の区切り線は保持されません。エクスポートとバックアップには含まれず、
置き換えでは削除されます(事前に表示されます)。
```
**Firefox Add-ons:** 概要 = 上の概要 · カテゴリ *Bookmarks* · ライセンス
*GNU General Public License v3.0* · Firefox(デスクトップ)のみ · 同じ
プライバシーポリシー URL。
**Edge Add-ons:** カテゴリ *Productivity* · 同じプライバシーポリシー URL。
+31
View File
@@ -66,3 +66,34 @@ https://github.com/poli0981/bookmarkmagic
Documentele juridice există doar în limba engleză (`docs/14`); URL-ul politicii
de confidențialitate este același ca în versiunea în engleză.
## Firefox Add-ons și Microsoft Edge Add-ons (din v1.3.0)
Descrierea de mai sus, cu cele două puncte care numesc Chrome înlocuite de acestea — în Firefox și Edge n-ar fi adevărate așa cum sunt scrise (iar Edge refuză o pagină care se prezintă drept extensie Chrome):
```
• Importă fișiere de marcaje (HTML, JSON, CSV) — inclusiv fișierul „Bookmarks”
din dosarul profilului unui browser Chromium (Chrome, Edge, Brave…) și copiile
de rezervă JSON din Firefox — cu o previzualizare completă înainte de a scrie
ceva: numărul de marcaje, dosarele și duplicatele, de la început.
```
```
• Marcajele importate primesc data de azi — browserele nu permit extensiilor să
seteze data originală de creare a unui marcaj. Fișierele exportate păstrează
datele reale.
```
Doar pentru Firefox Add-ons, adăugați la LIMITĂRI:
```
• Separatoarele din Firefox nu se păstrează: exporturile și copiile de rezervă le
omit, iar înlocuirea le șterge (vă anunță înainte).
```
**Firefox Add-ons:** rezumat = rezumatul de mai sus · categoria *Bookmarks* ·
licența *GNU General Public License v3.0* · doar Firefox (desktop) · același
URL al politicii de confidențialitate.
**Edge Add-ons:** categoria *Productivity* · același URL al politicii de
confidențialitate.
+29
View File
@@ -55,3 +55,32 @@ https://github.com/poli0981/bookmarkmagic
Lưu ý: các tài liệu pháp lý chỉ có bản tiếng Anh (`docs/14`), nên URL chính sách
riêng tư giống hệt bản EN.
## Firefox Add-ons và Microsoft Edge Add-ons (từ v1.3.0)
Dùng phần mô tả ở trên, thay hai gạch đầu dòng có nhắc Chrome bằng hai dòng sau — trên Firefox và Edge, viết như cũ sẽ không đúng (Edge cũng từ chối listing tự giới thiệu là tiện ích Chrome):
```
• Nhập tệp bookmark (HTML, JSON, CSV) — kể cả tệp "Bookmarks" trong thư mục
hồ sơ của trình duyệt Chromium (Chrome, Edge, Brave…) và bản sao lưu JSON
của Firefox — và xem trước đầy đủ trước khi ghi bất cứ thứ gì: số lượng,
thư mục và mục trùng lặp.
```
```
• Bookmark được nhập vào sẽ mang ngày hôm nay — trình duyệt không cho phép tiện
ích đặt lại ngày tạo gốc của một bookmark. Các tệp bạn xuất ra vẫn giữ ngày thật.
```
Riêng Firefox Add-ons, thêm vào phần GIỚI HẠN:
```
• Đường phân cách của Firefox không được giữ: tệp xuất và bản sao lưu bỏ qua
chúng, và chế độ Thay thế sẽ xóa chúng (có báo trước).
```
**Firefox Add-ons:** tóm tắt = phần tóm tắt ở trên · danh mục *Bookmarks* ·
giấy phép *GNU General Public License v3.0* · chỉ Firefox (máy tính) · cùng
URL chính sách quyền riêng tư.
**Edge Add-ons:** danh mục *Productivity* · cùng URL chính sách quyền riêng tư.
+27
View File
@@ -54,3 +54,30 @@ https://github.com/poli0981/bookmarkmagic
```
法律文件仅有英文版本(`docs/14`),隐私政策 URL 与英文版相同。
## Firefox Add-ons 与 Microsoft Edge Add-ons(v1.3.0 起)
使用上面的描述,并把提到 Chrome 的两条换成下面两条——原文在 Firefox 和 Edge 上并不成立(Edge 也不接受把自己介绍为 Chrome 扩展程序的页面):
```
• 导入书签文件(HTML、JSON、CSV)——包括 Chromium 内核浏览器(Chrome、Edge、
Brave 等)个人资料文件夹中的“Bookmarks”文件和 Firefox 的 JSON 备份。写入
任何内容之前都会先完整预览:数量、文件夹和重复项一目了然。
```
```
• 导入的书签日期为今天——浏览器不允许扩展程序设置书签的原始创建日期。
您导出的文件会保留真实日期。
```
仅 Firefox Add-ons:在“限制”中添加:
```
• Firefox 的分隔线不会保留:导出和备份都不包含分隔线,替换模式会删除它们
(事先会提示)。
```
**Firefox Add-ons:** 摘要 = 上面的摘要 · 类别 *Bookmarks* · 许可证
*GNU General Public License v3.0* · 仅限 Firefox(桌面版)· 相同的隐私政策 URL。
**Edge Add-ons:** 类别 *Productivity* · 相同的隐私政策 URL。