GitHub Release & Event Integration Guide
Step-by-step instructions for automatically broadcasting GitHub releases and repository events onto Nostr.
1 Create a Webhook Rule in NostrBridge
Log into the Client Dashboard using your NIP-07 extension (Alby, nos2x) and click Create New Rule.
- Rule Name:
GitHub Release Bot - Event Kind:
Kind 1 (Short Text Note)orKind 30023 (Longform) - Signing Preference: Select Ephemeral Bot Key or Encrypted Personal nsec.
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 GitHub repository ➔ 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
Releases. - Click Add webhook.
✓ Verification
Publish a release on GitHub. NostrBridge will receive the payload at edge speed, format the event, sign it, and broadcast to your target relays in sub-second time. Check the Log Explorer in your dashboard to view execution logs.