bb plugin — Web Push Notify

Get Web Push notifications when a bb agent finishes or fails—even when bb is closed. Notifications are sent directly from your bb server, with no polling or hosted backend.

Install

Requires bb 0.36 or newer and an HTTPS or localhost bb origin.

bb plugin install git:https://github.com/MayankBansal12/bb-plugin-web-push-notify.git@main --yes

Open Settings → Extensions → Plugins → Web Push Notify, name the browser, then allow notifications and select Enable and test.

Security and backups

bb stores this plugin's VAPID private key and browser push subscriptions in the plugin database under bb's data directory. Treat that database, its WAL files, and backups as credentials: restrict host and backup access to the bb operator. Anyone who obtains both the private key and subscription records can send notifications that appear to come from this bb server.

Removing and reinstalling the plugin may rotate the VAPID key and require browsers to register again. Restores should keep the plugin database and its WAL files together.

Develop

git clone https://github.com/MayankBansal12/bb-plugin-web-push-notify.git
cd bb-plugin-web-push-notify
npm install
npm run typecheck
npm test
npm run build
bb plugin install . --yes
bb plugin dev

Contributions

Issues and pull requests are welcome.