DerivativeSelf-hosted changelog and "What's new" widget, built from your Changesets, CHANGELOG.md, commits, GitHub or GitLab Releases. No SaaS, no tracking.
pnpm add @sweberdev/derivativeDerivative turns the changelog you already keep into a "What's new" button for your app. It reads Changesets output, any CHANGELOG.md in the Keep a Changelog or conventional-changelog style, conventional commits with version tags, or GitHub and GitLab Releases, and writes a static changelog.json, an Atom feed and a changelog page.
The widget is a single web component of about 6 kB gzipped with an unread badge, keyboard and screen reader support, dark mode and labels in English, German, French and Italian. The feed ships with your app and the read state stays in the browser, so there is no third-party service, no cookie and nothing to add to your privacy policy. A lean alternative to hosted tools such as Beamer or Headway.
Example
A short exampleCopy it into your project.
header.html
<!-- package.json: "build": "derivative build && vite build" -->
<header>
<a href="/">Acme</a>
<derivative-widget src="/changelog.json" lang="de"></derivative-widget>
</header>
<script type="module">
import "@sweberdev/derivative/widget"
</script>Features
What you getFree under MIT, with Pro on top.
Free, MIT
- Reads Changesets, Keep a Changelog and conventional commits
- Writes changelog.json, Atom and JSON Feed
- What's-new widget with unread badge and release highlights
- React and Vue bindings, 4 languages, accessible
- Frozen API with a written stability promise
Pro
- Everything in Free
- Read statistics without cookies or visitor IDs
- Audience segments and languages per entry
- Release notes with approval and import from Linear, Jira and Notion
- Announcements with double opt-in e-mail digests
All features in detail
Free, MIT
- Reads Changesets (default and GitHub formats), Keep a Changelog, conventional-changelog, conventional commits with tags, GitHub Releases and GitLab Releases (self-managed too); monorepo feeds can be limited to chosen packages; Linear cycles, Jira versions and Notion pages as sources (beta)
- derivative build writes changelog.json, an Atom feed, a JSON Feed and a standalone changelog page; derivative init sets it all up in one step
- <derivative-widget>: popover or inline, unread badge, optional search field, about 6 kB gzipped, no dependencies
- Highlights shown as a toast, banner or modal for the newest release, once per reader; major releases come first, the modal traps focus and closes with Escape
- Accessible: labelled dialog, focus handling, Escape to close, reduced motion respected, a correct heading outline, and axe and real-Chromium checks (contrast, RTL, phone width) in the test suite
- Labels and dates in English, German, French and Italian; dark mode, right-to-left pages, a dozen CSS custom properties and styleable parts
- Release communication: a title, summary, images or video, call-to-action links and an importance per release; translations inside the feed; entries and releases for chosen audiences; "new" hints on your own UI elements
- A frozen API with a written stability promise, deprecation policy, migration guide and upgrade guide, checked by tests and by installing the packed release into example projects; feed format 2 is a superset, version 1 feeds are still read
- Bindings for React (<WhatsNew>, useChangelog, an unstyled <ChangelogList>) and Vue 3 (<WhatsNew>, useChangelog); Svelte, Astro and plain HTML use the element directly
Pro
- Read statistics without cookies or visitor IDs: opens, reads and link clicks per release, plus a "Was this helpful?" vote under each release, with an HTML report, a password-protected dashboard route for your own backend, CSV export and storage in a file, Postgres or SQLite; emoji reactions and comments under each release, stored in your own database, plain text and approved by you before they show
- Audience segments and languages: entries only for certain plans or roles, scheduled releases, feature-flag audiences (Unleash, LaunchDarkly), translations written into the feed with DeepL, an OpenAI-compatible model or Anthropic, and a cache so only changed texts cost anything
- Release notes with approval: drafts as JSON files in your repository (draft, review, approved, publish date), a CI check, and optional AI-written first drafts with your own key that always need a person's approval; import from Linear, Jira and Notion as drafts, with all pages read and retries on rate limits (beta)
- Announcements: a subscriber list with double opt-in and e-mail digests sent through Resend, Postmark, Amazon SES or any SMTP server (one-click unsubscribe, consent evidence), plus posts to Slack, Teams, Discord, Mattermost, Google Chat, Mastodon, Bluesky and LinkedIn
| Feature | Free | Pro |
|---|---|---|
| Changelog parsers (incl. GitHub and GitLab Releases), CLI, Atom and JSON Feed | Included | Included |
| Widget, React and Vue bindings, highlights (toast, banner, modal), media, links and translations in the feed | Included | Included |
| Read statistics, helpful votes, emoji reactions and moderated comments, dashboard route, report and CSV export | Not included | Included |
| Audience segments, feature-flag audiences, scheduled releases, translated feeds, drafts with approval, AI-written drafts, tracker import (Linear, Jira, Notion; beta) | Not included | Included |
| Subscriber list, e-mail sending, chat, Mastodon, Bluesky and LinkedIn announcements | Not included | Included |
| Licence | MIT | Per person |
| Support | GitHub issues | Agency and Lifetime |
Pro
Pro packagesAdd-ons on top of the core.
@weber-development/derivative-insightsCounts opens, reads and link clicks per release on your own endpoint, adds a helpful / not helpful vote under each release, without cookies or visitor IDs, and renders a report or serves a dashboard route. Readers can also react with an emoji and leave comments on a release, which you moderate.
@weber-development/derivative-segmentsShows entries only to the plans or roles they are meant for, publishes releases on a schedule, translates the feed into more languages (inside the feed or one file per language) with DeepL, an OpenAI-compatible model or Anthropic, and manages drafts with an approval step, including AI-written first drafts. Entries can follow your Unleash or LaunchDarkly feature flags Imports releases from Linear, Jira and Notion as drafts (beta).
@weber-development/derivative-announceKeeps a subscriber list with double opt-in, sends new releases, with image and links, as an e-mail digest in the reader's language through Resend, Postmark, Amazon SES or your own SMTP server, and posts them to Slack, Teams, Discord, Mattermost, Google Chat, Mastodon, Bluesky and LinkedIn.
Pricing
PricingPrices are in CHF.
Freelancer
For one person working on client projects.
CHF 120
per year
2 months free
- 1 person
- No support entitlement
Agency
RecommendedFor teams of up to ten named people, one price.
CHF 390
per year
2 months free
- Up to 10 people
- Support included
Lifetime
Pay once for up to ten people and keep updates and repository access.
CHF 1’290
one-time
- Up to 10 people
- Support included
11 people or more: get in touch
- Pay yearly and get two months free: CHF 120 instead of CHF 144 for Freelancer, CHF 390 instead of CHF 468 for Agency.
- After cancelling, every version you already received keeps working. Only updates and repository access end.
- No licence key, no phone-home. The Pro packages never contact a server to check your licence.
- Agency and Lifetime cover up to ten named people for one price: you choose the number of seats at checkout and assign them in Polar. Your clients and their websites need no licence of their own.
- Checkout, invoices and VAT are handled by Polar as merchant of record.
FAQ
QuestionsShort answers.
Does Derivative send data to a server?
No. The feed is a static file you deploy with your app, and the widget stores the last release a reader has seen in their browser's local storage. Nothing else is stored or sent.
I don't use Changesets. Does it still work?
Yes. Derivative also reads Keep a Changelog and conventional-changelog files, or builds the feed from conventional commits and version tags. You can also write changelog.json by hand or from a CMS.
Can I write friendlier release notes than my commit messages?
Yes. Highlights in derivative.config.json add a title, a summary, images, links and an importance to any release, while the generated entries stay as they are. With Pro you can also keep drafts in your repository and have them approved before they are published.
Does it work without React?
Yes. The widget is a standard web component, so it works in plain HTML and in any framework. There are ready-made bindings for React and Vue 3, and Svelte and Astro need no wrapper (the docs show how).
Can I use the open-source part on its own?
Yes. @sweberdev/derivative and @sweberdev/derivative-react are MIT-licensed and complete without Pro. Pro adds statistics, segments and announcements on top of the same changelog.json.
I use Derivative 1.x. What changes with 2.0?
The feed format grows to version 2 and the widget's announce attribute becomes highlight; version 1 feeds are still read, and the CLI can write the old format with --feed-format 1. Node 22 is required. The migration guide in the documentation lists every change. Version 1.x keeps getting fixes for 12 months.
Do readers need an account to comment?
No. With Derivative Pro, readers can react with an emoji and leave a comment without an account. Comments are plain text, stored in your own database, held back until you approve them and never sent to us. You are responsible for them as personal data, so mention them in your privacy notice.
Articles
ArticlesGuides and release notes.
2026-10-05
The Compliance Bundle: three Pro add-ons, one licencePermito Pro, Surjection Pro and Logarithm Pro together from CHF 49 a month. New compliance packages join at no extra cost. Also: new prices for Cosine Pro and Derivative Pro.