Product Hunt 🎉 We are featured on Product Hunt! Use code for 1,000 free execution credits.
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) or Kind 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

  1. Navigate to your repository on GitHubSettingsWebhooksAdd 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 or Pushes.
  5. 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.