NostrBridge Webhook Relay Engine

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) or Kind 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

  1. Navigate to your GitHub repository ➔ SettingsWebhooksAdd webhook.
  2. Copy your unique NostrBridge endpoint URL: https://api.bridge.workouse.com/v1/wh/YOUR_RULE_ID
  3. Set Content type to application/json.
  4. Select Let me select individual events and check Releases.
  5. 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.