# Guides and Surveys Mobile SDK Changelog

> For AI agents: a documentation index is available at [/docs/llms.txt](/docs/llms.txt). Append `.md` to any page URL for markdown, or send `Accept: text/markdown`.

## 3.12.1

Released August 13, 2026. Platforms: Android, iOS, React Native.

**Fixes**

- \[Android\] Declare a uniquely-named `FileProvider` subclass so apps with other dependencies that declare `androidx.core.content.FileProvider` no longer fail manifest merge (GSM-1194).

## 3.12.0

Released July 31, 2026. Platforms: Android, iOS, React Native.

**Features**

- \[Flutter\] Flutter release now auto-bumps native iOS and Android SDK pins from the released native SDK versions.
- \[iOS\] \[Android\] Support showcase and split content layouts on mobile (GSM-1126).
- \[Android\] Add card embed form factor type (GSM-1135).
- \[iOS\] Add card embed form factor type (GSM-1049).
- \[iOS\] \[Android\] Add support for link images (GSM-1144).
- \[iOS\] Show a placeholder icon while guide images are loading (GSM-1120).
- \[React Native\] `boot()` now accepts options object with `integrations` callbacks to forward G+S events to analytics providers other than Amplitude Analytics (GSM-512).
- \[React Native\] Add `setRouter` / `unsetRouter` SDK methods to React Native for handling in-app navigation from CTA buttons (GSM-1169).

**Fixes**

- \[iOS\] \[Android\] Announce star rating and selection state to voiceover/talkback (GSM-1155).
- \[Android\] Gray out survey cta when a required response is missing (GSM-1151).
- \[Android\] Dropdowns won't use crashing material3 apis when app compose version differs (GSM-1147).
- \[iOS\] Skip nudge render when dismissed before render completes (GSM-1139).
- \[iOS\] \[Android\] Support CSS named colors in themes (GSM-1035).
- \[iOS\] \[Android\] Theme padding applies to the container, with all content blocks (title, body, images, videos, surveys, buttons) evenly spaced by the theme's "gap" value; existing themes are unaffected (GSM-1127).
- \[iOS\] \[Android\] Include Guides and Surveys mobile SDK version in event properties for "standalone" use case (GSM-1116).
- \[iOS\] \[Android\] Do not show duplicate image when using "vertical split" or "horizontal split" layouts (GSM-1129).
- \[Android\] Prevent duplicate debug buttons when navigating between activities (GSM-1159).
- \[iOS\] Show one close button on vertical-split popovers and pins with media (GSM-1165).
- \[iOS\] \[Android\] Clean up layouts and media alignment for card embeds and other types (GSM-1141).
- \[iOS\] \[Android\] Images use theme's button corner radius instead of card corner radius (GSM-1164).
- \[iOS\] \[Android\] Card embed border and background match fixed height (GSM-1163).
- \[iOS\] \[Android\] Hide debug button when test user mode is turned off (GSM-1156).
- \[Flutter\] Pass `mediaUrl` through when installing the engagement plugin so media proxy URLs take effect (GSM-1167).
- \[Android\] \[Flutter\] Opening a preview link no longer crashes apps whose activity does not extend `ComponentActivity` (GSM-1160).
- \[iOS\] Recognize taps near the top and bottom edges of a guide with image (GSM-1179).
- \[Android\] Hide pin nudge when the target element scrolls fully off-screen (GSM-1180).
- \[iOS\] \[Android\] Reduce image fade-in time (GSM-1181).

## 3.11.0

Released July 1, 2026. Platforms: Android, iOS, React Native, Flutter.

**Features**

- \[iOS\] \[Android\] Support "stay on step" CTA action for guides (GSM-1118).
- \[Android\] Add fullscreen text input editing ui for modals, popovers, pins with open keyboard (GSM-1056).
- \[iOS\] \[Android\] Add super debugger test user functionality and tests (GSM-892, GSM-1117).

**Fixes**

- \[iOS\] \[Android\] Render guide content blocks in the order configured in the web builder (GSM-1083).
- \[iOS\] \[Android\] VoiceOver/TalkBack skip background elements; navigate carousel elements on current step (GSM-1112).
- \[Android\] Ensure CTA is visible on long nudges (GSM-1056).
- \[iOS\] \[Android\] Use "gap" variable in theme for spacing between title/body and content blocks (existing themes unaffected) (GSM-1113).
- \[iOS\] Correct fullscreen keyboard editing layout after device rotation on iOS 26+ (GSM-1107).
- \[iOS\] Hide debug button if simulation context fails (GSM-1115).
- \[iOS\] Show debug button with error state when simulation context fails to load (GSM-1119).
- \[iOS\] Replace view hierarchy polling with event-driven monitoring and ensure it is only done in the foreground (GSM-1125).
- \[iOS\] Observe SwiftUI hosting-view layout changes in view hierarchy monitor (GSM-1125).
- \[Flutter\] Support "tap element" CTA action (GSM-1029).
- \[Flutter\] Support "element tapped" trigger (GSM-1028).
- \[Flutter\] Anchor pins to target element when scrolling (GSM-1027).

## 3.10.0

Released June 11, 2026. Platforms: Android, iOS, React Native, Flutter.

**Features**

- \[iOS\] \[Android\] Support survey input "prompt" (GSM-1073).
- \[iOS\] Add fullscreen text input editing ui for modals, popovers, pins with open keyboard (GSM-1056).

**Fixes**

- \[iOS\] \[Android\] Apply only theme typography and color to nps survey (GSM-1051).
- \[iOS\] Respect custom popover/pin/tooltip widths with media blocks (GSM-1045).
- \[iOS\] Ensure orphaned pin guide "marker" is cleaned up (GSM-1087).
- \[iOS\] \[Android\] Style disabled primary buttons (GSM-1080).

## 3.9.0

Released June 4, 2026. Platforms: Android, iOS, React Native.

**Features**

- \[iOS\] \[Android\] Support event-based trigger "delay" feature (GSW-552).
- \[Flutter\] Support swift package manager (GSM-1048).
- \[iOS\] \[Android\] Support `sub_priority` field for fine-grained guide ordering within priority buckets (GSW-425).

**Fixes**

- \[Android\] Persist bug report content on device rotation (GSM-1011).
- \[iOS\] Add top safe area padding for banner (GSM-1053).
- \[Flutter\] SDK not respecting native singleton on android (GSM-1057).
- \[iOS\] Ensure Engagement window displays above host app windows (GSM-1061).
- \[iOS\] Hide pin nudge when target element is obscured by another window (GSM-1061).
- \[iOS\] Ensure pin nudge mask is always cleaned up (GSM-1061).
- \[iOS\] \[Android\] Targeting nudges to users based on the app "version" (GSM-1068).
- \[iOS\] Use square corners on bottom of carousel Guide (on mobile phone only) (GSM-1077).

## 3.8.0

Released May 7, 2026. Platforms: Android, iOS, React Native, Flutter.

**Features**

- \[iOS\] \[Android\] Support for nudges that trigger after N events in a session (GSW-454).

**Fixes**

- \[Android\] Block TalkBack focus on background elements behind nudge (GSM-1018).
- \[Android\] Show selected debug nudge after device rotation instead of original debug nudge (GSDK-937).
- \[Android\] Add top safe area padding for banner (GSM-1033).
- \[iOS\] Use `actualContentSize` to position pin arrow (GSM-1040).
- \[iOS\] Changing font size when guide/survey is rendered causes elements to become non-tappable (GSM-899).
- \[iOS\] Position anchorable nudge UI on main thread after JS callback (GSM-1041).

## 3.7.0

Released April 28, 2026. Platforms: Android, iOS, React Native, Flutter.

**Features**

- \[iOS\] \[Android\] Show alert if user attempts to exit bug report before submitting (GSDK-945).
- \[iOS\] \[Android\] \[Flutter\] \[React Native\] Add `autoRefreshInterval` to init options and deprecate passing it through boot options (GSM-1014).
- \[Android\] Add debug logs screen and bug report logs (GSDK-911).

**Fixes**

- \[iOS\] Block VoiceOver focus on background elements behind nudge (GSM-1018).
- \[iOS\] Lead-align close button when title is trailing-aligned (GSM-1019).
- \[Android\] Update text animation to continue after device rotation (GSDK-923).

## 3.6.0

Released April 15, 2026. Platforms: Android, iOS, React Native, Flutter.

**Features**

- \[Android\] Update UI for debug overlay (GSDK-932).
- \[iOS\] \[Android\] Add debug support and bug report screens (GSDK-913).
- \[iOS\] Add debug logs screen and bug report logs (GSDK-911).
- \[Flutter\] \[React Native\] Add `updateLanguage` SDK method to Flutter & React Native (GSM-358).

**Fixes**

- \[iOS\] \[Android\] Support for multi-action CTAs in Guides & Surveys.
- \[iOS\] \[Android\] Support for conditional actions in Guides & Surveys.

## 3.5.0

Released April 9, 2026. Platforms: Android, iOS, React Native, Flutter.

**Features**

- \[Android\] Update UI for debug overlay (GSDK-932).
- \[Android\] \[React Native\] Add support for HLS video playback for Android (GSDK-924).

**Fixes**

- \[Android\] Reposition debug button so it's not off-screen on device rotation (GSDK-927).
- \[iOS\] Fix abort signal crash in super debugger (GSDK-928).
- \[iOS\] Fix sequence nudge rendering so text animations don't block each other (GSDK-909).
- \[Android\] \[React Native\] \[Flutter\] Potential duplicate class errors when a host app also depends on `org.commonmark` (GSDK-940).
- \[iOS\] Ensure font weight is applied to form components and markdown (GSDK-805).
- \[iOS\] When CSS system font keywords are specified as the font family in theme, use the system font (GSDK-805).
- \[iOS\] Ensure font weight in markdown matches web preview (GSDK-805).

**Performance improvements**

- \[iOS\] Reduce SDK bundle size by ~500KB by using variable fonts (GSDK-805).

## 3.4.0

Released March 31, 2026. Platforms: Android, iOS, React Native.

**Features**

- \[iOS\] \[Android\] Launch any unarchived guide or survey through debugger (GSDK-893).
- \[iOS\] \[Android\] Add debug mode to periodically reposition pins (GSDK-910).
- \[iOS\] \[Android\] Add debug mode "telltale" to indicate whether events are from and to the G+S SDK (GSDK-912).
- \[iOS\] Update UI for debug overlay (GSDK-913).

**Fixes**

- \[iOS\] Reposition debug button so it's not off-screen on device rotation (GSDK-927).

## 3.3.1

Released March 23, 2026. Platforms: Android, iOS, React Native.

**Fixes**

- \[iOS\] \[Android\] \[React Native\] Fix issue causing SDK method `screen` to not work properly if it was called before the SDK is fully initialized (GSDK-915, assistance-browser PR #1072).
- \[React Native\] Remove trailing comma to re-enable Swift 6.0 support.
- \[Android\] \[iOS\] Fix survey content width to match nudge step type (GSDK-908).
- \[Android\] Fix banner sizing for phone landscape mode (GSDK-907).
- \[iOS\] Fade in banner buttons after text animation completes (GSDK-904).
- \[iOS\] \[Android\] \[React Native\] Remove unnecessary 1 second delay in `screen` SDK method (GSDK-898).

## 3.3.0

Released March 17, 2026. Platforms: Android, iOS, React Native.

**Features**

- \[iOS\] Add theme support for rating button padding (GSDK-803).
- \[Android\] \[iOS\] Fade in buttons after text animation, and add image fade-in (GSDK-889).
- \[Android\] \[iOS\] Refresh SDK on app foregrounded (GSDK-886).
- \[Android\] \[iOS\] Replace reboot call with refresh on session change (GSDK-886).

**Fixes**

- \[Android\] \[iOS\] Fix animated text showing link syntax while in-progress (GSDK-601).
- \[Android\] Fix stuck text when coroutine cancelled mid-animation (GSDK-891).
- \[iOS\] Fix misaligned and unclosable tooltip with image (GSDK-890).
- \[iOS\] Fix undismissible star and number surveys (GSDK-906).

## 3.2.0

Released March 6, 2026. Platforms: Android, iOS, React Native.

**Features**

- \[React Native\] Allow "user\_properties" to be passed into "boot" SDK method (GSDK-869).
- \[Android\] Add theme support for line height (GSDK-820).
- \[Android\] Add theme support for rating button padding (GSDK-822).
- \[Android\] \[iOS\] Add theme support form control and button shadows (GSDK-806, GSDK-824).

**Fixes**

- \[Android\] Update step counter for multi-step pins (GSDK-876).
- \[iOS\] Use currentParent instead of view when resolving bar in nav hierarchy (GSDK-874).
- \[iOS\] Defer pin positioning to correct for layout timing (GSDK-868).
- \[Android\] Fix horizontal pin UI and positioning (GSDK-815).
- \[Android\] \[iOS\] Improve in-app support for vimeo and loom videos (GSDK-338, GSDK-861).
- \[Android\] Increase nudge width for number surveys with nps-format buttons (GSDK-833).

## 3.1.1

Released February 23, 2026. Platforms: Android, iOS, React Native.

**Fixes**

- \[Android\] \[iOS\] Reset survey responses on done or dismiss (GSDK-854).

## 3.1.0

Released February 13, 2026. Platforms: Android, iOS, React Native.

**Features**

- \[Android\] \[iOS\] \[React Native\] On `boot`, allow "user ID" to be null or blank as long as device ID is specified (GSDK-732).

**Fixes**

- \[Android\] \[iOS\] Fix auto-advance logic (GSDK-859).
- \[iOS\] Race condition causing pin nudge to be unable to render until the view hierarchy is updated (GSDK-827, GSDK-844).

## 3.0.0

Released February 11, 2026. Platforms: Android, iOS, React Native.

**Breaking changes**

- \[iOS\] `AmplitudeEngagement` is now an interface rather than a class. New instances (as of 3.0.0) are created using `AmplitudeEngagementFactory.make` rather than the `AmplitudeEngagement` constructor (GSDK-690).

**Features**

- \[Android\] \[iOS\] \[React Native\] Add SDK methods `disable` which temporarily hides any displayed guides or surveys and `enable` which shows them again (GSDK-513).
- \[React Native\] Add SDK method `shutdown` to React Native SDK binding (GSDK-769).
- \[Android\] \[iOS\] \[React Native\] Add `Minimum SDK version` support to App Management so older SDK versions don't initialize Guides and Surveys.

**Fixes**

- \[Android\] \[iOS\] Fix theming issues (GSDK-845, GSDK-847).
- \[Android\] Fix tap outside to close behavior for modals (GSDK-850).

## 2.1.1

Released February 2, 2026. Platforms: Android, iOS, React Native.

**Fixes**

- \[React Native\] Trailing comma issue causing build error on Swift compiler less than version 6.1.
- \[iOS\] Fix keyboard layout bug during iOS 26 device rotation (GSDK-632).
- \[Android\] Restore nudge keyboard after configuration change (GSDK-831).

## 2.1.0

Released February 2, 2026. Platforms: Android, iOS, React Native.

**Features**

- \[Android\] \[iOS\] Add support for `autoRefreshIntervalSeconds` option to `AmplitudeBootOptions` to configure the auto-refresh interval for the SDK (GSDK-799).
- \[Android\] \[iOS\] Add SDK method `setAutoRefreshInterval` to configure the auto-refresh interval for the SDK on the fly (GSDK-799).
- \[Android\] \[iOS\] Add SDK method `refresh` to manually trigger a refresh of targeting data (GSDK-799).

**Fixes**

- \[Android\] \[iOS\] Fix theming issues (GSDK-676).
- \[iOS\] Ensure Pin guide is displayed when it follows another guide in a Tour (a multi-step guide) (GSDK-827).
- \[Android\] Reposition nudge when keyboard shows (GSDK-782).
- \[Android\] Fix link appearance and click behavior (GSDK-821).
- \[Android\] Update components to use form control theme (GSDK-835).
- \[Android\] Ensure host app still receives touch events after session/activity changes (GSDK-198).

**Performance improvements**

- \[iOS\] View hierarchy tracking is now "async" and won't interfere with the main thread (GSDK-819).

## 2.0.3

Released January 26, 2026. Platforms: Android, iOS, React Native.

**Fixes**

- \[Android\] \[iOS\] Persist survey values when step-navigating (GSDK-582).
- \[Android\] \[iOS\] Hide buttons until text animation completes, if applicable (GSDK-780).
- \[Android\] Popover overlaps system bars because we were not consuming WindowInsets from host app appropriately (GSDK-784).
- \[Android\] Crash occurring on transition to a new activity that has `enableEdgeToEdge()` by waiting for root view to be attached to window (GSDK-768).
- \[iOS\] Ensure Modal Guides & Surveys are properly dismissed when `shutdown()` is called (GSDK-790).
- \[iOS\] Update default content alignment to leading GSDK-796.
- \[iOS\] Identify containerView as EngagementWindow to dismiss keyboard as needed GSDK-797.
- \[iOS\] Expand nudge to show Other textfield without scrolling (GSDK-779).
- \[React Native\] Internal engagement Android dependency version is incorrectly set.

## 2.0.2

Released January 9, 2026. Platforms: iOS.

**Fixes**

- \[iOS\] Compile SDK framework with Xcode 16.2 / Swift 6.0.3 for broader compatibility (GSDK-786).

## 2.0.1

Released January 7, 2026. Platforms: Android, iOS, React Native.

**Features**

- \[Android\] \[iOS\] Add `ignoreAnalyticsAutomaticScreenTracking` option to `AmplitudeInitOptions` to configure default Engagement SDK behavior for automatic screen tracking (GSDK-750).

**Fixes**

- \[Android\] Reset animation queue when nudge disappears (GSDK-518).
- \[Android\] \[iOS\] Crash in debug mode when used without calling "boot" on the SDK.
- \[iOS\] Ensure element selector and preview mode can be started when the other is active (GSDK-717).
- \[Android\] \[iOS\] Ignore Amplitude Analytics automatic screen tracking by default in Engagement SDK (GSDK-781).

## 2.0.0

Released January 2, 2026. Platforms: Android, iOS, React Native.

**Breaking changes**

- \[Android\] `AmplitudeEngagement` is now an interface rather than a class, and the `options` and `apiKey` are no longer accessible.
- \[Android\] \[iOS\] `AmplitudeInitOptions.Options` has been removed and `logLevel` now lives at the top level of the options object.
- \[Android\] `handlePreviewLinkIntent` is deprecated, use `handleLinkIntent` instead (GSDK-322).

**Features**

- \[Android\] \[iOS\] Add support for share links (GSDK-322).
- \[Android\] \[iOS\] Add support for custom tooltip size (GSDK-353).
- \[React Native\] Add support for `serverZone`, `serverUrl`, `cdnUrl`, `mediaUrl`, `logLevel` and `locale` init options (GSDK-767).

**Fixes**

- \[Android\] \[iOS\] Pin visibility logic and mask interactions (GSDK-748).
- \[iOS\] Allow banner content to expand vertically for tablet (GSDK-759).
- \[iOS\] Add finite checks before using actual content size in constraints (GSDK-761).
- \[iOS\] Maintain status bar visibility state when nudge shows (GSDK-758).
- \[iOS\] Fix arrow misalignment on scrolled pins (GSDK-725).
- \[Android\] Gracefully handle failure to initialize mobile SDK, instead of crashing host app (GSDK-775).
- \[Android\] Fix theming for step counter size and background color (GSDK-538).
- \[Android\] Correctly handle "null" user and device IDs (FOO-2908).
- \[iOS\] Remove `isObscuredByPresentedViewController` check for target view visibility (GSDK-720).
- \[iOS\] Tooltip is re-openable after using the "close" button to close it (GSDK-776).
- \[Android\] \[iOS\] Properly apply drop shadow to Guide/Survey cards from theme (GSDK-772).
- \[iOS\] Trigger display of matching guide/survey (if any) when user properties are updated through "\_setUserProperties" (FOO-2911).
- \[React Native\] React Native plugin automatically sets `serverZone` based on the server zone used for Amplitude initialization (GSDK-767).

**Performance improvements**

- \[iOS\] Event forwarding from Amplitude Analytics to G+S SDK is now "async" and won't interfere with the main thread (GSDK-763).

## 1.8.1

Released December 4, 2025. Platforms: iOS.

**Fixes**

- \[iOS\] Update default title+text alignment to leading (GSDK-733).
- \[iOS\] Bug causing app crash when Foundation.Data is used as an event property value (GSDK-736).

## 1.8.0

Released November 26, 2025. Platforms: Android, iOS, React Native.

**Features**

- \[iOS\] Update nudges to be scrollable for long content (GSDK-693).
- \[Android\] \[iOS\] Track nudge engagement event with link source (GSDK-144).
- \[Android\] \[iOS\] Respect modal height setting for carousels+modals on tablets.

**Fixes**

- \[Android\] Fix nps button height (GSDK-708).
- \[iOS\] Re-render mask + target view on device orientation changes (GSDK-441).
- \[Android\] Use theme background color for top+bottom of Carousel (GSDK-731).
- \[iOS\] Background mask for pins flickers when advancing between steps (GSDK-660).
- \[iOS\] Guide renders in top-left corner briefly before being moved to correct location (GSDK-718).
- \[Android\] Drop shadows on form factors is clipped and duplicated by Surface (GSDK-259).
- \[iOS\] Add support for conditional actions on button blocks (GSDK-726).
- \[Android\] Update spacing between ctas (GSDK-734).

## 1.7.0

Released November 18, 2025. Platforms: Android, iOS, React Native.

**Fixes**

- \[React Native\] Type error when using the Engagement Analytics Plugin with "amplitude.add(...)" (GSDK-698).
- \[Android\] Guide title incorrectly center-aligned when left alignment was configured (GSDK-701).
- \[Android\] Allow underscore ("\_") separated font files on Android (GSDK-701).
- \[Android\] Use correct corner radius and outer padding when rendering Guide (GSDK-701).
- \[iOS\] App is unresponsive after displaying StoreKit content (for example, `manageSubscriptionsSheet`) (GSDK-699).

## 1.6.1

Released November 13, 2025. Platforms: Android, iOS, React Native.

**Fixes**

- \[Android\] \[iOS\] Update ordering of survey and media blocks (GSDK-689).
- \[iOS\] Fix threading issue for uikit click element (GSDK-571).
- \[iOS\] Fix nudge anchoring on custom nav bar behind transparent system nav bar (GSDK-664).
- \[Android\] Refactor view hierarchy scanning to improve performance on the Main thread.

## 1.6.0

Released November 7, 2025. Platforms: Android, iOS, React Native.

**Features**

- \[Android\] \[iOS\] Proxy support (GSDK-630). Go to [Proxy](https://amplitude.com/docs/guides-and-surveys/proxy).
- \[Android\] \[iOS\] Support 4 new popover Guide positions (top-center, bottom-center, left-center, right-center) (FOO-2639).

**Fixes**

- \[Android\] \[iOS\] Add debug logging to all SDK methods.
- \[Android\] Proper handling of null or blank user IDs on boot (GSDK-681).
- \[Android\] Theming fixes (incorrect colors, text alignment, popover Guide width, and so forth.) (GSDK-671).
- \[Android\] When pin target scrolls offscreen, guide should be displayed again when target re-appears (GSDK-651).
- \[iOS\] \[Android\] On tablets, modal carousel max width in theme is used, rather than device's max-width (GSDK-633, GSDK-616).
- \[iOS\] Stop showing previously previewed guide when initiating a new preview (GSDK-595).
- \[iOS\] Ensure URLs opened in browser are opened on main UI thread (GSDK-652).
- \[Android\] Odd whitespace appears when Guide content is right-aligned (GSDK-647).
- \[iOS\] Automatically call shutdown() when the user ID is set to `nil` through Amplitude Analytics SDK (#436).
- \[iOS\] Modal Guide moves from centered to top left of screen (GSDK-627).
- \[iOS\] App hangs when executing a callback through a CTA button (GSDK-458).
- \[iOS\] Banners using text animations have blank text (GSDK-638).
- \[iOS\] Tooltip markers not staying with their targeted element when scrolling vertically (GSDK-607).
- \[iOS\] Tooltip appearing without pointer (GSDK-607).
- \[iOS\] User-driven dismissal of tooltip should NOT hide the tooltip marker (GSDK-607).
- \[iOS\] Ensure user properties passed to `analytics.identify` are used for Guide user property interpolation (#415).
- \[iOS\] Prevent flickering for tooltips and closed-by-default pins (GSDK-659).
- \[iOS\] Allow pins to target navbar elements (GSDK-664).
- \[iOS\] Close button ("x") padding uses value from theme (GSDK-661).
- \[iOS\] Images sometimes not loading (GSDK-656).

## 1.5.2

Released October 31, 2025. Platforms: iOS, React Native.

**Fixes**

- \[iOS\] \[React Native\] Crash when calling `setUserId`.

## 1.5.1

Released October 30, 2025. Platforms: Android, iOS, React Native.

**Breaking changes**

- \[Android\] \[iOS\] The `cleanup()` and `reboot()` functions have been removed, use `shutdown()` instead.

**Fixes**

- \[Android\] \[iOS\] \[React Native\] Ensure `shutdown()` removes all active nudges from view.
- \[Android\] \[iOS\] \[React Native\] Ensure non-JSON-safe values are serializable.

## 1.5.0

Released October 21, 2025. Platforms: Android, iOS, React Native.

**Breaking changes**

- \[Android\] \[iOS\] \[React Native\] Require calling `shutdown()` before calling `boot()` with a new user ID.

**Features**

- \[Android\] \[iOS\] Custom font support (GSDK-578, GSDK-620).
- \[Android\] Analytics plugin tracks changes to user ID (#355).
- \[Android\] \[iOS\] Support links and italics in Guide titles (GSDK-600).

**Fixes**

- \[iOS\] Multiple crashes involving QuickJS (GSDK-640, GSDK-625).
- \[Android\] Crash when rendering Guides in Android apps with multiple Activity or "plain" Activity (for example, not `AppCompatActivity`) (GSDK-589).
- \[iOS\] Crash on preview when using Debugger (#337).
- \[iOS\] "Arrow" for tooltip Guide not hiding when tooltip is closed (GSDK-609).
- \[iOS\] Carousel Guide is correct size on large (tablet) screens (GSDK-616).
- \[iOS\] Pin form factor "offset" positioning + alignment bugs (GSDK-593).
- \[iOS\] Modal and popover Guide snaps to the top-left rather than remaining in the configured position (GSDK-627).
- \[Android\] \[iOS\] \[React Native\] A race condition which could cause a Guide to be un-dismissable (#355).
- \[Android\] Condition causing duplicate carousel Guides (GSDK-641).
- \[iOS\] Text animations not always rendering properly (GSDK-638).
- \[Android\] \[iOS\] Issue causing Dark Mode theme to not be used, or incorrect colors to be used (GSDK-596, GSDK-612).
- \[Android\] \[iOS\] Remove extra spacing when actions are hidden (GSDK-421).
- \[Android\] Possible issue with "smart delay" trigger (GSDK-605).
- \[iOS\] Guide title font weight now defaults to semi-bold (GSDK-615).