Firefox WebExtension (Desktop and Mobile) that lets you share the current tab to Margit.at, frontpage.fyi, etc. with minimal effort.
chore: refresh ATProto Social branding
- Rewrite README with Margin/Frontpage workflows, mirrors, and setup notes
- Update manifest metadata, homepage link, and bump version to 0.1.6
+30
-19
+27
-16
README.md
+27
-16
README.md
···
1
-
## frontpage.fyi Firefox extension
1
+
## ATProto Social — Firefox extension
2
2
3
-
This repository provides a Firefox WebExtension that lets you share the current tab to [frontpage.fyi](https://frontpage.fyi) with minimal effort.
4
-
Links are submitted by creating `fyi.frontpage.feed.post` records on your ATProto account, the same mechanism the official Frontpage site uses.
3
+
A Firefox WebExtension for publishing to ATProto-based social platforms directly from your browser.
5
4
6
-
> ℹ️ This repository is hosted on [tangled](https://tangled.org/@galiglobal.com/frontpage_firefox_plugin) (PRs, issues) and [GitHub](https://github.com/antonmry/frontpage_firefox_plugin) (CI/CD, releases).
5
+
> ℹ️ This repository is hosted on [tangled](https://tangled.org/anton.galiglobal.com/frontpage_firefox_plugin) (PRs, issues) and [GitHub](https://github.com/antonmry/frontpage_firefox_plugin) (CI/CD, releases).
7
6
8
7
### Features
9
8
10
-
- Pop-up form that auto-fills the active tab’s title and URL.
11
-
- Title length indicator (120 characters, matching the Frontpage UI).
12
-
- Background service worker handles ATProto login, token refresh, and record creation.
9
+
- **Margin tab** — select text on any page and publish it as a highlight or annotation to [margin.at](https://margin.at):
10
+
- No comment → creates an `at.margin.highlight` record.
11
+
- With comment → creates an `at.margin.annotation` record (`motivation: commenting`).
12
+
- Uses the W3C `TextQuoteSelector` (exact text + surrounding context) for precise targeting.
13
+
- **Frontpage tab** — share the current tab to [frontpage.fyi](https://frontpage.fyi) by creating a `fyi.frontpage.feed.post` record on your ATProto account.
14
+
- Auto-fills the active tab's title and URL.
15
+
- Title length indicator (120 character limit).
16
+
- Background service worker handles ATProto login, token refresh, and record creation for both services.
13
17
- Options page for storing your handle, app password, and optional PDS override.
14
-
- Convenience links to open frontpage.fyi or the options page from the pop-up.
15
18
16
19
### Prerequisites
17
20
18
-
- An ATProto account that Frontpage can read.
21
+
- An ATProto account (Bluesky or self-hosted PDS).
19
22
- An app password for that account (create one at <https://bsky.app/settings/app-passwords> or via your own PDS).
20
23
21
24
### Install a packaged build
···
31
34
3. Click **Save credentials**. A success message confirms that the session tokens are stored locally.
32
35
4. Use **Log out** at any time to remove stored tokens (you can also revoke the app password server-side).
33
36
34
-
### Submit a link
37
+
### Publish a highlight or annotation (Margin)
38
+
39
+
1. Select text on any webpage.
40
+
2. Open the ATProto Social pop-up — the **Margin** tab opens by default with the selected text pre-filled.
41
+
3. Optionally add a comment (turns a highlight into an annotation).
42
+
4. Click **Highlight on Margin** or **Annotate on Margin**.
43
+
44
+
### Submit a link (Frontpage)
35
45
36
46
1. Browse to the page you want to share.
37
-
2. Open the Frontpage pop-up; the title and URL are pre-filled.
47
+
2. Open the ATProto Social pop-up and switch to the **Frontpage** tab; the title and URL are pre-filled.
38
48
3. Adjust the text if necessary and click **Post to Frontpage**.
39
49
4. On success, the pop-up reports the record URI returned by `com.atproto.repo.createRecord`.
40
50
41
51
### Implementation notes
42
52
43
-
- The background worker discovers the user’s PDS by resolving the handle (`com.atproto.identity.resolveHandle` + PLC lookup).
53
+
- The background worker discovers the user's PDS by resolving the handle (`com.atproto.identity.resolveHandle` + PLC lookup).
44
54
- Sessions are refreshed automatically via `com.atproto.server.refreshSession` when the access JWT expires.
45
55
- All data stays in `browser.storage.local`; nothing is transmitted to third-party services beyond the ATProto endpoints.
56
+
- Margin records use the `at.margin.annotation` and `at.margin.highlight` lexicons with a `TextQuoteSelector` for text targeting.
46
57
- Maximum lengths follow the current Frontpage limits (120 characters for the title, 2048 for URLs).
47
58
48
59
### Development tips
···
56
67
57
68
1. Open `about:debugging#/runtime/this-firefox`.
58
69
2. Click **Load Temporary Add-on…** and choose `manifest.json` inside the `extension/` directory.
59
-
3. Pin the “Frontpage” toolbar button if you want quick access.
70
+
3. Pin the "ATProto Social" toolbar button if you want quick access.
60
71
61
72
> This method is ideal while iterating; Firefox forgets the add-on on restart.
62
73
···
64
75
65
76
This repository includes `.github/workflows/package-extension.yml` which builds (and optionally signs) the add-on using [`web-ext`](https://extensionworkshop.com/documentation/develop/web-ext-command-reference/).
66
77
67
-
1. Configure `AMO_JWT_ISSUER` and `AMO_JWT_SECRET` repository secrets with your AMO API credentials if you want automatic signing.
78
+
1. Configure `AMO_JWT_ISSUER` and `AMO_JWT_SECRET` repository secrets with your AMO API credentials if you want automatic signing.
68
79
Without the secrets, the workflow still produces an unsigned ZIP you can download.
69
80
2. Trigger the workflow manually (`Actions` → **package-extension** → **Run workflow**).
70
81
3. Download the artifacts:
···
77
88
78
89
### Tangled mirror
79
90
80
-
The `mirror-to-tangled.yml` workflow pushes every commit on `main` to Tangled, a federated Git hosting platform built on ATProto.
81
-
Browse the mirror at <https://tangled.org/@galiglobal.com/frontpage_firefox_plugin>.
91
+
The `mirror-to-tangled.yml` workflow pushes every commit on `main` to Tangled, a federated Git hosting platform built on ATProto.
92
+
Browse the mirror at <https://tangled.org/anton.galiglobal.com/frontpage_firefox_plugin>.
82
93
Add a deploy key with write access as the `TANGLED_DEPLOY_KEY` repository secret so the mirror stays up to date.
+3
-3
extension/manifest.json
+3
-3
extension/manifest.json
···
1
1
{
2
2
"manifest_version": 3,
3
3
"name": "ATProto Social",
4
-
"description": "Quickly share the current tab to frontpage.fyi via ATProto.",
5
-
"version": "0.1.5",
4
+
"description": "Quickly share the current tab to different ATProto services.",
5
+
"version": "0.1.6",
6
6
"author": "ATProto Social Contributors",
7
-
"homepage_url": "https://frontpage.fyi",
7
+
"homepage_url": "https://tangled.org/anton.galiglobal.com/frontpage_firefox_plugin",
8
8
"icons": {
9
9
"16": "icons/icon-16.svg",
10
10
"32": "icons/icon-32.svg",