Widget Embed

Let users see what's new without leaving your app. The rlse widget shows your latest release notes in a modal or slide-out.

Quick Setup

Option 1: Script Tag (Any Website)

Add this to your HTML, just before the closing body tag:

<script>
  window.rlseWidgetConfig = {
    orgSlug: "your-org-slug"
  };
</script>
<script async src="https://rlse.dev/widget.js"></script>

Option 2: React Component

import { RlseWidget } from 'rlse-widget';

function App() {
  return (
    <>
      <YourApp />
      <RlseWidget orgSlug="your-org-slug" />
    </>
  );
}

Configuration

OptionTypeDefaultDescription
orgSlugstringrequiredYour organization slug
appSlugstring-Filter to specific app
triggerstringmanualmanual, auto, or both
positionstringbottom-rightWidget button position
themestringautolight, dark, or auto
limitnumber10Max changes to show

Trigger Modes

Manual (default)

Floating button always visible. Click to open. Shows unread badge.

Auto

No visible button. Modal auto-opens on first visit after new releases. Respects autoShowAfter days setting.

Both

Best of both worlds: visible button + auto-popup for new releases.

Unread Tracking

The widget uses browser LocalStorage to track seen changes. No backend required—works immediately for all visitors.

Styling

Use primaryColor to match your brand:

window.rlseWidgetConfig = {
  orgSlug: "acme",
  primaryColor: "#ff6b6b"  // Your brand color
};