Official GitHub Integration
GitHub Release & Event Integration Guide
Step-by-step instructions for automatically broadcasting GitHub releases, issues, repository tags, and workflow events onto Nostr.
🐙 GitHub Official Resources & Documentation
Read official GitHub Webhook specifications and event payload structures.
1 Create a Webhook Rule in NostrBridge
Log into the Client Dashboard using your NIP-07 extension (Alby, nos2x) and click Create New Rule.
- Provider Selection:
GitHub (github.com) - Event Kind:
Kind 1 (Short Text Note)orKind 1617 (NIP-34 Git Patch) - Signing Preference: Select Ephemeral Bot Key, Encrypted Personal nsec, or NIP-46 Bunker.
2 Configure Liquid Mapping Template
In the template editor, enter the following Liquid formatting string to parse GitHub's payload structure:
🚀 New Release for {{ payload.repository.full_name }}: {{ payload.release.tag_name }}
{{ payload.release.body }}
Release Link: {{ payload.release.html_url }}
3 Configure GitHub Repository Webhook
- Navigate to your repository on GitHub ➔ Settings ➔ Webhooks ➔ Add webhook.
- Copy your unique NostrBridge endpoint URL:
https://api.bridge.workouse.com/v1/wh/YOUR_RULE_ID - Set Content type to
application/json. - Select Let me select individual events and check
ReleasesorPushes. - Click Add webhook.
✓ Verification & Log Explorer
Publish a release or push a commit on GitHub. NostrBridge receives the payload at edge speed, formats the event, signs it, and broadcasts to your target relays in sub-second time. Check the Log Explorer Guide to learn how execution logs work.