Documentation

What is Vershun?

Vershun is a changelog-as-a-service. Create a beautiful public changelog page, notify users with an in-app widget and email notifications. Hosted in Europe, GDPR native.

Quick start

1. Create your account at app.vershun.io. No credit card required.
2. Create a project and write your first post using the rich text editor.
3. Add the widget to your site:

<script src="https://cdn.vershun.io/widget.js"
  data-project="your-project-id"
  async></script>

That's it. Your changelog page, widget, and email notifications are live.

Widget

Installation

Add this snippet to your HTML, just before the closing </body> tag:

<script src="https://cdn.vershun.io/widget.js"
  data-project="your-project-id"
  async></script>

Configuration options

Shadow DOM

The widget uses Shadow DOM to avoid CSS conflicts with your site. Your styles won't affect the widget, and the widget won't affect your styles.

Size

Less than 5KB gzipped. No dependencies. Loads asynchronously — zero impact on your page performance.

Custom domain

How to set up

1. Go to your project Overview > Domain.
2. Enter your domain (e.g. changelog.yourapp.com).
3. Add a CNAME record pointing to projects.vershun.io.
4. Click Verify DNS.
5. SSL is provisioned automatically via Let's Encrypt.

DNS propagation

It can take up to 24 hours for DNS changes to propagate. In most cases, it's under 10 minutes.

Email notifications

How it works

When you publish a post, all confirmed subscribers receive an email notification with the post title, excerpt, and a link to the full post.

Subscribe flow

Users subscribe via the widget or the public changelog page. They receive a confirmation email (double opt-in). Only confirmed subscribers get notifications.

Unsubscribe

Every email includes an unsubscribe link. One click, instantly removed. No questions asked.

API

Base URL

https://api.vershun.io/api/v1/public/{project-id}

Public endpoints require no authentication. Replace {project-id} with your project's public ID (e.g. my-app-a3b8f1).

Endpoints

Example

curl https://api.vershun.io/api/v1/public/my-app-a3b8f1/posts

For the full authenticated API reference, see the API documentation.

RSS feeds

Every project has RSS and Atom feeds:

Add these to any RSS reader or use them to integrate with tools like Zapier, Slack, or Discord.

Plans & limits

All plans include EU hosting, GDPR compliance, and free SSL. View pricing.