Skip to main content

Changelog

1.0.0 (2026-08-26)​

Native SDK: iOS 1.29.5 · Android 1.25.4 · React Native: 0.68+ (built on 0.86.0)

Breaking Changes​

  • Full support for React Native New Architecture (Fabric, Turbo Modules, Codegen) with dual compatibility for Old Architecture (Bridge, Paper)
  • Public API redesigned around StoryManager, AppearanceManager, StoriesList, and BannerCarousel
  • StoriesWidget removed; use StoriesList with explicit storyManager, appearanceManager, and feed props
  • Generic storyManager.on(eventName, listener) and once subscriptions removed; use dedicated onXxx methods
  • CTA handling moved to storyManager.storyLinkClickHandler
  • Reader appearance and custom icon methods moved from StoryManager to AppearanceManager
  • Card title font settings now use separate fontSize, fontWeight, fontFamily, and lineHeight instead of a font string

Added​

  • StoryManager.create(config) recommended entry point that waits for native SDK initialization
  • destroy() to remove native event subscriptions when replacing a manager
  • setLoggingEnabled(enabled) and onLog for native SDK logs
  • setProductCartHandlers, onProductCartClicked, and product cart types
  • BannerCarousel with imperative BannerViewRef methods
  • StoriesList imperative API through StoriesListRef
  • StoryReaderCloseButtonPosition, StoryReaderPresentationStyle, StoryReaderSwipeStyle, StoriesListCardTitlePosition, StoriesListCardTitleTextAlign, StoriesListCardViewVariant, and CoverQuality exports

Changed​

  • Android native package is now com.inappstory.reactnativesdk
  • MainActivity should extend com.inappstory.reactnativesdk.activity.InAppStoryActivity
  • Android minimum SDK raised to 24, compile SDK raised to 35, and target SDK raised to 35
  • showStory, showStoryOnce, showOnboardings, showIAMById, and showIAMByEvent support AbortSignal

Fixed​

  • Native event subscriptions are kept per StoryManager instance and can be cleaned up with destroy()
  • Product cart requests are resolved asynchronously and errors are logged without crashing JS

0.29.0 (2026-08-04)​

Native SDK: iOS 1.29.3 · Android 1.25.3

Added​

  • addTags method on StoryManager (appends tags without replacing the current list)
  • preloadBannerPlace(placeId, tags?) to warm up a banner place before it is shown
  • showStoryOnce, clearCache, removeFromFavorite, favoritesCount and logout methods on StoryManager
  • cacheSize (Android-only) and anonymous options in StoryManagerConfig
  • Exported CTASource enum and CTA payload types (CTAStoryReaderPayload, CTAStoryListPayload, CTAGameReaderPayload)
  • Interactive product cart: setProductCartHandlers, onProductCartClicked, and ProductCart / ProductCartOffer / ProductCartHandlers types

Changed​

  • StoriesList now exposes its imperative API via ref (StoriesListRef) instead of viewModelExporter / StoriesListViewModel
  • Reader appearance and custom-icon setters moved from StoryManager to AppearanceManager
  • Renamed showOnboardingStories to showOnboardings(feed?, limit?, tags?, signal?)
  • setUserId now takes userIdSign as an explicit second argument
  • Replaced the generic on(eventName, listener) / once API with dedicated onShowStory, onCloseStory, onGameEvent, onIamEvent, onFailure, … subscription methods; event payloads now arrive in event.body

Fixed​

  • Game events

0.28.0 (2026-07-03)​

Native SDK: iOS 1.27.6 · Android 1.25.1

Added​

  • Added Banners feature

Changed​

  • Added sendStatistics in initWith method

Fixed​

  • Back navigation in in-app messages

0.27.1 (2026-05-20)​

Native SDK: iOS 1.27.6 · Android 1.24.3

Added​

  • Added missing IAM events

0.27.0 (2026-05-14)​

Native SDK: iOS 1.27.6 · Android 1.24.3

Added​

  • In-app messaging
  • Added CoverQuality in common options in AppearanceManager

0.26.3 (2025-12-04)​

Native SDK: iOS 1.25.13 · Android 1.21.22

Bug Fixes​

  • Android: remove deprecated UGCEditor (with unnecessary media read permissions)

0.26.2 (2025-12-02)​

Native SDK: iOS 1.25.13 · Android 1.21.22

Bug Fixes​

  • Android: correct loading stories for any feed slug (not only for default feed slug)
  • events: don't allow subscribe on events absented in native module

0.26.1 (2025-08-11)​

Native SDK: iOS 1.25.13 · Android 1.21.16

Bug Fixes​

  • iOS: update ias-sdk to 1.25.13 (fix data for clickOnStory statistic event)

0.26.0 (2025-08-08)​

Native SDK: iOS 1.25.12 · Android 1.21.16

Bug Fixes​

  • correct process defaultMuted true value

Features​

  • events: add clickOnStory event
  • events: add field slidesCount to showSlide and showStory events
  • exampleApp: update for new sdk version

0.25.0 (2025-07-24)​

Native SDK: iOS 1.24.15 · Android 1.20.11

Bug Fixes​

  • exampleApp: android build on RN v0.74.2

Features​

  • exampleApp: add icons overload example
  • StoriesList: add onLoadStart and onLoadEnd call for favoritesOnly StoriesList

0.24.0 (2025-07-16)​

Native SDK: iOS 1.24.15 · Android 1.20.11

Bug Fixes​

  • events: add missing favoriteListLength field to onLoadEnd event

Features​

  • StoryListUI: add new renderFavoriteCell: RenderFavoriteCell render props

0.23.0 (2025-03-07)​

Native SDK: iOS 1.24.15 · Android 1.20.11

Features​

  • add userIdSign to API
  • Android: update ias-sdk to 1.20.9 (ability to override appVersion and appBuild)
  • iOS: update ias-sdk to 1.24.15 (new feature - userId sign)
  • remove deprecated StoriesListOptions.card.title.color and StoriesListOptions.title options

0.22.0 (2025-02-12)​

Native SDK: iOS 1.24.9 · Android 1.20.7

Bug Fixes​

  • Android/FavoriteCell: add missed fun onFavoriteCell in InappstorySdkModule class

Features​

  • add customStyles?: StyleProp prop to StoriesListFavoriteCardOptions

0.21.1 (2025-01-17)​

Native SDK: iOS 1.24.9 · Android 1.20.7

Bug Fixes​

  • useEvents: do (init = false) in unmount of useEvents hook

0.21.0 (2025-01-17)​

Native SDK: iOS 1.24.9 · Android 1.20.7

Features​

  • Android: update ias-sdk to 1.20.7 (NPE fixes)

0.20.0 (2024-12-16)​

Native SDK: iOS 1.24.9 · Android 1.20.4

Bug Fixes​

  • types: remove unused field svgMask from StoriesListCardOptions

Features​

  • add ability to change appVersion and appBuild via StoryManagerConfig.appVersion
  • add additional prop options (type - {isFirstItem, isLastItem}) to renderCell render-prop
  • Android: update ias-sdk to 1.20.4 (ability to override appVersion and appBuild)
  • iOS: update ias-sdk to 1.24.9 (ability to override appVersion and appBuild)

0.19.0 (2024-11-20)​

Native SDK: iOS 1.24.8 · Android 1.20.3

Features​

  • Android: updated ias-sdk to 1.20.3 (timelineHide, timelineColor)
  • iOS: updated ias-sdk to 1.24.8 (timelineHide, timelineColor)

0.18.0 (2024-10-14)​

Native SDK: iOS 1.24.3 · Android 1.20.1

Bug Fixes​

  • added {fontSize; fontWeight; fontFamily; lineHeight; } to StoriesListCardOptions type
  • Android/CarouselCardVideoCover: use useTextureView true for ability to change card opacity
  • StoriesCarousel/FlatList: changing onViewableItemsChanged on the fly is not supported

Features​

  • Android: fix Android InAppStory native sdk with v1.20.1
  • iOS: update example app with v1.24.3
  • podspec: fix ios InAppStory native sdk with v1.24.3
  • StoryManager/Settings: remove setSandbox from Public API, sandbox now is always false