stable version

Author: EmilianoSanchez

CHANGES.txt

@@ -1,5 +1,5 @@
 1.3.0 (September 22, 2025)
- - Added `InLocalStorage` export to the `@splitsoftware/splitio-react-native` package. This export can be used to configure the SDK to use `AsyncStorage` or another storage implementation to persist the SDK rollout plan data across app restarts and speed up the initialization.
+ - Added the `InLocalStorage` export to the `@splitsoftware/splitio-react-native` package. This export can be used to configure the SDK to use `AsyncStorage` or another storage implementation to persist the SDK rollout plan data across app restarts and speed up the initialization.
  - Added the `initialRolloutPlan` configuration option, to allow preloading the SDK storage with a snapshot of the rollout plan.
  - Updated the application state listener to sync feature flag definitions when the app returns to the foreground and has exceeded the SDK’s feature refresh interval.
  - Updated @splitsoftware/splitio-commons package to version 2.6.0.

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@splitsoftware/splitio-react-native",
-  "version": "1.2.1-rc.2",
+  "version": "1.3.0",
   "description": "Split SDK for React Native",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -61,7 +61,7 @@
   },
   "homepage": "https://github.com/splitio/react-native-client#readme",
   "dependencies": {
-    "@splitsoftware/splitio-commons": "2.5.1-rc.1"
+    "@splitsoftware/splitio-commons": "2.6.0"
   },
   "devDependencies": {
     "@react-native-community/eslint-config": "^3.2.0",

package.json

@@ -1,7 +1,7 @@
 import type SplitIO from '@splitsoftware/splitio-commons/types/splitio';
 import { CONSENT_GRANTED } from '@splitsoftware/splitio-commons/src/utils/constants';
 
-const packageVersion = '1.2.1-rc.2';
+const packageVersion = '1.3.0';
 
 export const defaults = {
   startup: {

src/settings/defaults.ts

@@ -16,7 +16,21 @@ declare module JsSdk {
   export function SplitFactory(settings: SplitIO.IReactNativeSettings): SplitIO.IBrowserSDK;
 
   /**
-   * Persistent storage. By default, it uses the browser's LocalStorage API.
+   * Persistent storage. By default, it uses the Web LocalStorage API if available.
+   * Consider providing a custom storage wrapper, like [AsyncStorage](https://github.com/react-native-async-storage/async-storage), for Android and iOS targets.
+   *
+   * Example:
+   * ```
+   * import AsyncStorage from '@react-native-async-storage/async-storage';
+   * import { SplitFactory, InLocalStorage } from '@splitsoftware/splitio-react-native';
+   *
+   * const SDK_CONFIG = {
+   *   ...
+   *   storage: InLocalStorage({
+   *     wrapper: AsyncStorage,
+   *   }),
+   * }
+   * ```
    *
    * @see {@link https://developer.harness.io/docs/feature-management-experimentation/sdks-and-infrastructure/client-side-sdks/react-native-sdk/#configuring-persistent-cache-for-the-sdk}
    */

types/full/index.d.ts

@@ -16,7 +16,21 @@ declare module JsSdk {
   export function SplitFactory(settings: SplitIO.IReactNativeSettings): SplitIO.IBrowserSDK;
 
   /**
-   * Persistent storage. By default, it uses the browser's LocalStorage API if available.
+   * Persistent storage. By default, it uses the Web LocalStorage API if available.
+   * Consider providing a custom storage wrapper, like [AsyncStorage](https://github.com/react-native-async-storage/async-storage), for Android and iOS targets.
+   *
+   * Example:
+   * ```
+   * import AsyncStorage from '@react-native-async-storage/async-storage';
+   * import { SplitFactory, InLocalStorage } from '@splitsoftware/splitio-react-native';
+   *
+   * const SDK_CONFIG = {
+   *   ...
+   *   storage: InLocalStorage({
+   *     wrapper: AsyncStorage,
+   *   }),
+   * }
+   * ```
    *
    * @see {@link https://developer.harness.io/docs/feature-management-experimentation/sdks-and-infrastructure/client-side-sdks/react-native-sdk/#configuring-persistent-cache-for-the-sdk}
    */