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.
https://app.lytmark.com/w/YOUR_PROJECT_ID
Install steps
-
Open the URL in a WebView from your “What’s new” button
platform=androidoriostells your analytics which app it was. The page talks to your app through a small bridge: JSON messagesclose,open_urlandseen. -
Handle close, back and links
Step 1 already closes the screen on
closeand opens links onopen_url. For the back button callLytmark.back():truemeans the page went back itself (post → list),falsemeans close the screen. -
Unread badge (optional)
Store
latest_atfrom theseenmessage and send it assince. The answer is the number of new posts (up to 99). -
Signed-in users (optional)
Pass
email,name,idandhashin the URL, likeLytmark.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, 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.
// 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);
// 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),
);
// 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;
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.
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} />;
}
// 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();
}, []);
GET https://api.lytmark.com/api/widget/YOUR_PROJECT_ID/unread?since=<latest_at>
→ {"count": 3, "latest_at": 1762000000}
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.
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")
}
}
// In onCreate, after loadUrl
onBackPressedDispatcher.addCallback(this, object : OnBackPressedCallback(true) {
override fun handleOnBackPressed() {
web.evaluateJavascript("window.Lytmark ? Lytmark.back() : false") { if (it != "true") finish() }
}
})
GET https://api.lytmark.com/api/widget/YOUR_PROJECT_ID/unread?since=<latest_at>
→ {"count": 3, "latest_at": 1762000000}
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.
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.
// 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
}
}
GET https://api.lytmark.com/api/widget/YOUR_PROJECT_ID/unread?since=<latest_at>
→ {"count": 3, "latest_at": 1762000000}
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.
| Option | Values | What it does |
|---|---|---|
platform | android | ios | Platform for analytics (otherwise guessed from the user agent). |
tab | updates | roadmap | ideas | First tab (a tab your plan lacks opens Updates). |
post | post id | Opens that post directly. |
theme | light | dark | auto | Overrides the project theme. |
close | 0 | Hides the ✕ button, when your app has its own header. |
track | false | No analytics, like data-track="false" on the web. |
consent | pending | granted | denied | Like 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.