GitHub project

iOS 27 & UIScene support

customerio-reactnative 6.10.0 adds acknowledged UIScene routing with React Native 0.88 and newer. AppDelegate-only apps need no change.

customerio-reactnative 6.10.0 adds acknowledged scene routing for apps using React Native 0.88 or newer. React Native 0.87 and earlier don’t expose the scene URL APIs that the Customer.io bridge requires. Keep the AppDelegate lifecycle until React Native 0.88 is available as a stable release.

  • AppDelegate-only apps need no change. Existing integrations keep working while your toolchain still permits the AppDelegate lifecycle.
  • Scene hosts call NativeCustomerIO.configureAcknowledgedSceneDeepLinkRouting() at the start of scene(_:willConnectTo:options:), pass the scene connection options when React Native starts, and register CustomerIO.setDeepLinkHandler before CustomerIO.initialize. Cold destinations wait for the handler. Its handled or declined result determines whether the SDK stops or uses the native fallback.
  • Live Activities in a scene host use NativeLiveActivities.reactNativeLaunchOptions(from:) for cold connection and NativeLiveActivities.handleAndRouteWidgetUrl for warm opens.

The supported scope is one simultaneous window scene.

Version 6.9.0 scene integrations can keep the earlier configureSceneDeepLinkRouting() and Linking listener path. Prefer the acknowledged handler for new integrations because a Linking event can’t report whether JavaScript handled a URL.

See the iOS 27 UIScene migration guide for full steps.

Updated August 28, 2026