Skip to content

Add plugin entry: browser-gestures - #601

Merged
SawyerHood merged 3 commits into
get-bb:mainfrom
brzvsk:submit-browser-gestures
Oct 19, 2026
Merged

SawyerHood merged 3 commits into
get-bb:mainfrom
brzvsk:submit-browser-gestures

Conversation

@brzvsk

@brzvsk brzvsk commented Oct 18, 2026

Copy link
Copy Markdown
Contributor

Plugin

Browser Gestures adds two-finger trackpad back/forward navigation to the BB desktop browser. A dark arrow slides in from the page edge as the user swipes; navigation commits when the fingers lift (or on post-lift momentum), and pulling back cancels. Vertical scrolling, modified wheels, and horizontal scrollers that can still move in the swipe direction keep their normal behavior. It adds no toolbar button or settings.

Release source

  • Repository: https://github.com/brzvsk/bb-plugins
  • Tags: browser-gestures/v0.1.0 (7ac669394af8ef36d977192b4429acb0bd7ce465), browser-gestures/v0.1.1 (2d60fd06c5b519a252355d07dc5945ba87354260, current)
  • Subdirectory: plugins/browser-gestures
  • Version range: ^0.1.0; tag prefix: browser-gestures/
  • Requires BB 0.46.1+ and Plugin SDK >=0.6.49 <0.7.0.

The repository holds independently installable plugins; this entry resolves only the Browser Gestures subdirectory and its prefixed tags.

Verification

  • Plugin typecheck, 9 Node tests and bb plugin build . pass on a fresh checkout of the public browser-gestures/v0.1.1 tag.
  • Gesture start/release logic was tuned against recorded physical MacBook trackpad sessions in the BB desktop browser; the tests replay those recordings (every touch past the threshold navigates once, momentum carried onto a new page never starts a gesture, long holds wait for lift).
  • Exercised manually on a physical trackpad in BB 0.46.1 desktop.
  • Marketplace npm run build and npm run check (source liveness) pass; the only warning is an unchanged existing entry without a category.

Permissions and compatibility

Uses the experimental browser toolbar slot only to obtain experimental_page, and renders nothing in the toolbar. Through page.evaluate (isolated world) it installs a wheel listener and a fixed-position arrow element in the top-level document, refreshed every 250 ms with a 2.5 s lease so it cleans up when the plugin stops. It reads only wheel deltas, history availability (navigation.canGoBack/canGoForward) and scroll extents; it reads no page content and makes no network requests. No external services, credentials or model calls. Desktop BB only; cross-origin iframes do not receive the gesture. Pages cannot observe finger lift, so a completely still hold at full extent commits after about 0.6 s; this is documented in the overview.

Assets

  • swipe-ready.jpg: the arrow fully out, ready to go back on lift.
  • swipe-in-progress.jpg: the arrow mid-swipe.

Both are 2880×1800 captures of the plugin's real page script rendering on a public Wikipedia article, driven by synthetic wheel events in headless Chromium; they show the in-page arrow, not the surrounding BB window. No private data.

The SVG icon is vendored locally. The overview is copied from plugins/browser-gestures/PLUGIN_OVERVIEW.md in the released plugin repository.

AGENT GENERATED

🤖 Generated with Claude Code

@SawyerHood SawyerHood left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated note from a Claude Code agent, posted on behalf of the marketplace maintainer.

Reviewed and verified the submitted change under the maintainer admission policy. Required CI passes; approved for merge.

@SawyerHood
SawyerHood merged commit eabd91f into get-bb:main Oct 19, 2026
1 check passed
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