How to Share GitHub Releases on Nostr

If you're an open-source developer or maintain a software project, keeping your community updated about new releases is crucial. By sharing your GitHub Releases directly to the Nostr network, you can instantly notify your followers about new features, bug fixes, and version tags in a fully decentralized way.

In this tutorial, we will walk you through setting up a NostrBridge webhook to automatically listen to your GitHub repository and broadcast formatted notes whenever a release is published.

Prerequisites

• A GitHub repository where you have admin access (to configure webhooks).
• A Nostr account (NIP-07 browser extension like Alby or nos2x, or a NIP-46 Bunker).
• A NostrBridge account.

Step 1: Create a Rule in NostrBridge

First, we need to generate a unique webhook URL that GitHub can send data to.

1. Log into the NostrBridge Client Dashboard.
2. Click on the Create New Rule button.
3. Under Provider Selection, choose GitHub (github.com).
4. Set the Event Kind to Kind 1 (Short Text Note).
5. Choose how you want NostrBridge to sign the events (we recommend a NIP-46 Bunker with a real account because Ephemeral bot keys often do not reach followers).

Step 2: Configure the Message Template

NostrBridge uses a powerful Liquid templating engine to format the JSON data sent by GitHub into a readable Nostr note. When setting up your rule, copy and paste the following template into the editor:

🚀 New Release for {{ payload.repository.full_name }}: {{ payload.release.tag_name }}

{{ payload.release.body | truncate: 150 }}

Check it out here: {{ payload.release.html_url }}
#github #opensource #nostr

This template dynamically extracts the repository name, the release version, a snippet of the release notes, and the direct link.

Step 3: Add the Webhook to your GitHub Repository

Now that NostrBridge is ready to receive events, you must tell GitHub to send them.

1. Copy your unique NostrBridge Endpoint URL from the dashboard (it looks like https://api.bridge.workouse.com/v1/wh/YOUR_RULE_ID).
2. Go to your repository on GitHub.
3. Navigate to Settings > Webhooks and click Add webhook.
4. Paste your NostrBridge Endpoint URL into the Payload URL field.
5. Change the Content type to application/json.
6. In the Secret field, enter the Webhook Secret provided in your NostrBridge rule settings (NostrBridge verifies the X-Hub-Signature-256 header to ensure the payload is authentic).
7. Under Which events would you like to trigger this webhook?, select Let me select individual events.
8. Uncheck Pushes and check Releases.
9. Ensure the webhook is set to Active and click Add webhook.

Step 4: Publish a Release and Verify!

Everything is connected! To test the integration, create a new Draft Release on GitHub and publish it.

Within milliseconds of publishing, GitHub will send the payload to NostrBridge. NostrBridge will format your message using your Liquid template, sign it with your chosen key, and broadcast it to your preferred relays.

Open your favorite Nostr client (like Damus, Primal, or Snort) and look for your new automated post!