Add a changelog widget to your iOS or Android app

Lytmark is an in-app changelog, public roadmap and feature-voting widget for SaaS products and web apps. Add a “What’s new” panel, an ideas box and roadmap voting to your product, for a flat monthly price with no per-user limits.

In a mobile app, the full widget opens in a WebView from your own “What’s new” button, full screen: updates, plus roadmap and ideas on Pro. It works in Flutter, React Native, Android (Kotlin) and iOS (Swift) apps, and it’s fine on the App Store and Google Play. There is no native SDK to add: the widget is a web page, so new Lytmark features reach your app without an app update.

Before you start

  • A free Lytmark accountSign up at app.lytmark.com. No card needed.
  • Your project IDIt’s on the Install page of your dashboard, under Mobile app, already filled into the URL.
  • About 15 minutesOne screen with a WebView, opened from a button in your app.

Your widget URL

Every project has a mobile widget page at app.lytmark.com/w/ plus your project ID. It’s the same widget as on your website, sized for a full phone screen, in your colors and theme. In the examples on this page the ID is YOUR_PROJECT_ID.

Your widget URL
https://app.lytmark.com/w/YOUR_PROJECT_ID

Install steps

  1. Open the URL in a WebView from your “What’s new” button

    platform=android or ios tells your analytics which app it was. The page talks to your app through a small bridge: JSON messages close, open_url and seen.

  2. Handle close, back and links

    Step 1 already closes the screen on close and opens links on open_url. For the back button call Lytmark.back(): true means the page went back itself (post → list), false means close the screen.

  3. Unread badge (optional)

    Store latest_at from the seen message and send it as since. The answer is the number of new posts (up to 99).

  4. Signed-in users (optional)

    Pass email, name, id and hash in the URL, like Lytmark.identify() on the web. The hash is computed on your server with the secret from Settings → User identification in your dashboard. Never put the secret in the app: anyone can pull it out of an APK or IPA.

    Node.js
    // Node.js, on your server only
    const crypto = require('crypto');
    
    function lytmarkHash(email) {
      return crypto
        .createHmac('sha256', process.env.LYTMARK_IDENTITY_SECRET)
        .update(email.trim().toLowerCase())
        .digest('hex');
    }

Code for your platform

The code for each step, per platform. It’s the same code as on the Install page of your dashboard, where your project ID is already filled in.

Flutter

Example code — adapt to your app.

Flutter · Step 1: Open the URL in a WebView
// webview_flutter, url_launcher, shared_preferences
final url = Uri.https('app.lytmark.com', '/w/YOUR_PROJECT_ID', {
  'platform': Platform.isIOS ? 'ios' : 'android',
});
final controller = WebViewController()
  ..setJavaScriptMode(JavaScriptMode.unrestricted)
  ..addJavaScriptChannel('LytmarkBridge', onMessageReceived: (m) async {
    final msg = jsonDecode(m.message) as Map<String, dynamic>;
    switch (msg['type']) {
      case 'close': Navigator.of(context).pop();
      case 'open_url': launchUrl(Uri.parse(msg['url']), mode: LaunchMode.externalApplication);
      case 'seen': (await SharedPreferences.getInstance()).setInt('lytmark_since', msg['latest_at']);
    }
  })
  ..loadRequest(url);
Flutter · Step 2: Handle close, back and links
// Back button
PopScope(
  canPop: false,
  onPopInvokedWithResult: (didPop, _) async {
    if (didPop) return;
    final handled = await controller.runJavaScriptReturningResult('window.Lytmark ? Lytmark.back() : false');
    if (handled.toString() != 'true' && context.mounted) Navigator.of(context).pop();
  },
  child: WebViewWidget(controller: controller),
);
Flutter · Step 3: Unread badge
// Badge
final since = (await SharedPreferences.getInstance()).getInt('lytmark_since');
final res = await http.get(Uri.parse('https://api.lytmark.com/api/widget/YOUR_PROJECT_ID/unread${since != null ? '?since=$since' : ''}'));
final count = jsonDecode(res.body)['count'] as int;
Flutter · Step 4: Signed-in users
final url = Uri.https('app.lytmark.com', '/w/YOUR_PROJECT_ID', {
  'platform': Platform.isIOS ? 'ios' : 'android',
  if (user != null) ...{'email': user.email, 'name': user.name, 'hash': user.lytmarkHash}, // hash from your server
});

React Native

Example code — adapt to your app.

React Native · Step 1: Open the URL in a WebView
import { WebView } from 'react-native-webview';
import { BackHandler, Linking, Platform } from 'react-native';

export function WhatsNew({ user, onClose }) {
  const ref = useRef(null);
  const qs = new URLSearchParams({ platform: Platform.OS === 'ios' ? 'ios' : 'android' });
  const onMessage = e => {
    const msg = JSON.parse(e.nativeEvent.data);
    if (msg.type === 'close' || (msg.type === 'back' && !msg.handled)) onClose();
    if (msg.type === 'open_url') Linking.openURL(msg.url);
    if (msg.type === 'seen') AsyncStorage.setItem('lytmark_since', String(msg.latest_at));
  };
  return <WebView ref={ref} source={{ uri: `https://app.lytmark.com/w/YOUR_PROJECT_ID?${qs}` }} onMessage={onMessage} />;
}
React Native · Step 2: Handle close, back and links
// Inside WhatsNew: the Android back button
useEffect(() => {
  const sub = BackHandler.addEventListener('hardwareBackPress', () => {
    ref.current?.injectJavaScript('window.ReactNativeWebView.postMessage(JSON.stringify({type:"back", handled: window.Lytmark ? Lytmark.back() : false})); true;');
    return true; // decided in onMessage
  });
  return () => sub.remove();
}, []);
React Native · Step 3: Unread badge
GET https://api.lytmark.com/api/widget/YOUR_PROJECT_ID/unread?since=<latest_at>
→ {"count": 3, "latest_at": 1762000000}
React Native · Step 4: Signed-in users
const qs = new URLSearchParams({ platform: Platform.OS === 'ios' ? 'ios' : 'android', ...(user ? { email: user.email, hash: user.lytmarkHash } : {}) });

Android (Kotlin)

Example code — adapt to your app.

Android (Kotlin) · Step 1: Open the URL in a WebView
class WhatsNewActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    val web = WebView(this).also { setContentView(it) }
    web.settings.javaScriptEnabled = true
    web.settings.domStorageEnabled = true
    web.addJavascriptInterface(object {
      @JavascriptInterface fun postMessage(json: String) {
        val msg = JSONObject(json)
        runOnUiThread {
          when (msg.getString("type")) {
            "close" -> finish()
            "open_url" -> startActivity(Intent(Intent.ACTION_VIEW, Uri.parse(msg.getString("url"))))
            "seen" -> getSharedPreferences("lytmark", MODE_PRIVATE).edit().putLong("since", msg.getLong("latest_at")).apply()
          }
        }
      }
    }, "LytmarkAndroid")
    web.loadUrl("https://app.lytmark.com/w/YOUR_PROJECT_ID?platform=android")
  }
}
Android (Kotlin) · Step 2: Handle close, back and links
// In onCreate, after loadUrl
onBackPressedDispatcher.addCallback(this, object : OnBackPressedCallback(true) {
  override fun handleOnBackPressed() {
    web.evaluateJavascript("window.Lytmark ? Lytmark.back() : false") { if (it != "true") finish() }
  }
})
Android (Kotlin) · Step 3: Unread badge
GET https://api.lytmark.com/api/widget/YOUR_PROJECT_ID/unread?since=<latest_at>
→ {"count": 3, "latest_at": 1762000000}
Android (Kotlin) · Step 4: Signed-in users
web.loadUrl("https://app.lytmark.com/w/YOUR_PROJECT_ID?platform=android") // + &email=…&hash=… from your server

iOS (Swift)

Example code — adapt to your app.

iOS (Swift) · Step 1: Open the URL in a WebView
final class WhatsNewViewController: UIViewController, WKScriptMessageHandler {
  private var web: WKWebView!

  override func viewDidLoad() {
    super.viewDidLoad()
    let config = WKWebViewConfiguration()
    config.userContentController.add(self, name: "lytmark")
    web = WKWebView(frame: view.bounds, configuration: config)
    web.autoresizingMask = [.flexibleWidth, .flexibleHeight]
    view.addSubview(web)
    web.load(URLRequest(url: URL(string: "https://app.lytmark.com/w/YOUR_PROJECT_ID?platform=ios")!))
  }
}

Messages arrive in userContentController: close dismisses the screen, open_url opens the link. SFSafariViewController only opens http(s) URLs; send mailto: and tel: to UIApplication.shared.open.

iOS (Swift) · Step 2: Handle close, back and links
// In WhatsNewViewController
func userContentController(_ c: WKUserContentController, didReceive message: WKScriptMessage) {
  guard let s = message.body as? String, let d = s.data(using: .utf8),
        let msg = try? JSONSerialization.jsonObject(with: d) as? [String: Any] else { return }
  switch msg["type"] as? String {
  case "close": dismiss(animated: true)
  case "open_url": if let u = (msg["url"] as? String).flatMap(URL.init(string:)) { present(SFSafariViewController(url: u), animated: true) }
  case "seen": UserDefaults.standard.set(msg["latest_at"], forKey: "lytmark_since")
  default: break
  }
}
iOS (Swift) · Step 3: Unread badge
GET https://api.lytmark.com/api/widget/YOUR_PROJECT_ID/unread?since=<latest_at>
→ {"count": 3, "latest_at": 1762000000}
iOS (Swift) · Step 4: Signed-in users
web.load(URLRequest(url: URL(string: "https://app.lytmark.com/w/YOUR_PROJECT_ID?platform=ios")!)) // + &email=…&hash=… from your server

URL options

Add them to the widget URL, for example ?platform=ios&tab=roadmap&close=0.

OptionValuesWhat it does
platformandroid | iosPlatform for analytics (otherwise guessed from the user agent).
tabupdates | roadmap | ideasFirst tab (a tab your plan lacks opens Updates).
postpost idOpens that post directly.
themelight | dark | autoOverrides the project theme.
close0Hides the ✕ button, when your app has its own header.
trackfalseNo analytics, like data-track="false" on the web.
consentpending | granted | deniedLike data-consent on the web.

Website and app in one project

  • One changelog, two places. Posts, roadmap and ideas are the same on your website and in your app. You publish once.
  • Votes add up. A vote or idea from the app counts on the same roadmap item as one from your website.
  • Website vs app analytics. On Pro, Analytics has an All · Website · App filter, so you can see where views, reactions and votes come from.

Is your app a web app in a native shell (Capacitor, Ionic, Cordova)? Then the regular snippet works too: see the HTML guide.

Mobile app changelog FAQ

Does it work on the App Store and Google Play?

Yes. The widget opens in a standard WebView (WKWebView on iOS, Android WebView), the same way many apps show help pages or news. It doesn’t download code into your app.

Is there a native SDK?

No, and you don’t need one. The widget runs in a WebView from one URL, so there’s nothing to add to your build, and new Lytmark features reach your app without an app update.

Do votes from the app and the website add up?

Yes. Your website and app share one project, so a vote or idea from the app lands on the same roadmap and ideas list as one from your website.

Can I see app vs website analytics?

Yes, on Pro. Analytics has an All, Website and App filter, and the platform option in the URL tells iOS and Android apart.

Give your app a “What’s new” screen today.

Free plan, no card. One project for your website and your app.