8000 feat(clipper): Safari build of the web clipper by adeelahmad · Pull Request #283 · adeelahmad/lense · GitHub
[go: up one dir, main page]

Skip to content

feat(clipper): Safari build of the web clipper - #283

Merged
adeelahmad merged 7 commits into
mainfrom
claude/project-thread-2cf09a
Oct 10, 2026
Merged

adeelahmad merged 7 commits into
mainfrom
claude/project-thread-2cf09a

Conversation

@adeelahmad
@adeelahmad adeelahmad commented Oct 10, 2026 •
Copy link
Copy Markdown
Owner

Requested by Adeel · project thread

Description

Before: the web clipper (#277) had no Safari build; Safari needs an extension carried inside a macOS app, and updates only through the App Store.

After: extensions/browser/safari/build.sh builds the clipper's Safari target and wraps it with Apple's safari-web-extension-converter and xcodebuild into Lens Clipper.app, zipped as lens-clipper-safari-app.zip. A new Safari clipper workflow builds it on macOS for every PR touching the extension and attaches the zip to each release (the Release workflow starts it). When the App Store Connect secrets exist (APPLE_TEAM_ID, APPLE_API_KEY_ID, APPLE_API_ISSUER, APPLE_API_KEY_P8), safari/app-store.sh signs it through Xcode cloud signing and uploads it, so testers update through TestFlight and everyone else through the Mac App Store; without them the upload is skipped.

How: targets/safari.json is the only manifest change (Safari 16.4+, hosts as host_permissions since Safari grants them per site anyway). No core files changed. docs/web-clipper.md gains a Safari section; safari/README.md covers building and installing.

Motivation and Context

Adeel asked for the web clipper on every major browser, with auto-updates; this is the Safari one.

Steps to reproduce (if appropriate):

The Safari clipper check on this PR builds the app on macOS (green). Locally on a Mac with Xcode: extensions/browser/safari/build.sh.

Types of changes

  • New feature (non-breaking change which adds functionality)

Checklist:

  • The title is a Conventional Commit.
  • My code follows the code style of this project. (actionlint and shellcheck clean)
  • I added or updated tests. (the macOS CI build is the check; the App Store upload can't run without the secrets)
  • My change requires documentation updates, and I have updated docs/ accordingly.

Done questions (AGENTS.md)

  • Goal: Safari build, release zip, App Store updates when secrets exist; merged on green.
  • Agents: n/a, a browser packaging change; clips go through the existing import webhook.
  • Zero setup: n/a for the server; Safari needs the app opened once and the extension enabled.
  • Fewest clicks: same clipper UI as Chrome.
  • Configurable: settings are the shared clipper options page.
  • Light: nothing added to the server install.
  • Private and secure: Safari asks per site; no new server surface.
  • Cost: n/a, no model calls.
  • User decides: the upload only runs when the owner adds the secrets.
  • Upgrades: n/a, no stored data.
  • Honest: docs say the zip is unsigned and how updates work.
  • Tests, docs and generated files updated.
  • Open standards: WebExtension; no new dependencies.
  • Refine later: ship inside the Lens macOS app (needs id prefix dev.lens.app.), iOS build, App Store listing.

🤖 Generated with Claude Code

https://claude.ai/code/session_01TNsWRU4vErn1QczKcuchkt

A MV3 extension in extensions/browser: clip the page (Readability), the
selection or a picked element to Markdown with MarkDownload-style
templates, and send it to Lens through a namespace's import webhook.
Shared core for the Firefox, Edge and Safari targets; CI builds a zip
per target and attaches them to releases.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018uA6PhZXrmpgsbfDh2W23u
Adds a safari target overlay and wraps dist/safari in a macOS app with
safari-web-extension-converter and xcodebuild. A macOS workflow builds it
on pull requests and attaches the zip to releases; unsigned unless the
SAFARI_TEAM_ID secret is set.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TNsWRU4vErn1QczKcuchkt
@adeelahmad adeelahmad self-assigned this Oct 10, 2026
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TNsWRU4vErn1QczKcuchkt
Safari extensions update only through the App Store, so a release now
signs and uploads the app when the App Store Connect secrets exist and
skips it otherwise. The release workflow starts the Safari one.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TNsWRU4vErn1QczKcuchkt
Base automatically changed from claude/project-thread-sin0jk to main October 10, 2026 20:18
# Conflicts:
#	.github/workflows/release.yml
#	docs/web-clipper.md
…t zip

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TNsWRU4vErn1QczKcuchkt
# Conflicts:
#	docs/web-clipper.md
@adeelahmad
adeelahmad merged commit afa8b1f into main Oct 10, 2026
10 checks passed
@adeelahmad
adeelahmad deleted the claude/project-thread-2cf09a branch October 10, 2026 21:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

0