← Back to Open Source

Herald

Herald is a self-hosted changelog app that runs as a Cloudflare Worker. Write your release notes, publish a clean public page, and keep your users in the loop. You own all of it, with no SaaS subscription and no servers to maintain.

Overview

Most changelog tools are a hosted service you rent forever or a markdown file nobody reads. Herald gives you a real editor and a public changelog page that you host yourself, on infrastructure you most likely already pay for.

Deploy to Cloudflare with one click and it sets up the database, storage, and queue for you. The GitHub App wizard locks the admin to your repo’s collaborators, so there’s no OAuth app to register and nothing to wire up by hand. When a new version lands upstream, npm run update pulls it into your copy.

Editing a changelog entry in Herald

Features

  • Runs on Cloudflare - Workers, D1, and R2 on the free tier, so it costs nothing to host
  • GitHub App auth - One-click setup, no OAuth config; only your repo’s collaborators reach the admin
  • Markdown editor - Write in Markdown and drag images straight in; Cloudflare Images optimises them for you
  • Structured releases - Tag entries by type (Added, Changed, Fixed, Removed, Deprecated, Security), sort them into product areas, and group them into versions
  • AI summaries - Turn a release’s entries into a plain summary with Workers AI
  • REST API and GitHub Action - Post entries from CI so the changelog updates with your deploys
  • Public page and RSS - A clean public changelog with a built-in RSS feed
  • Your branding - Set your own logo and favicon
  • One-command updates - npm run update pulls the latest release into your deployment

Links