Consumer Authentication

/

Mobile SDKs

/

React Native SDK reference

/

Changelog

SDK Changelog

This page provides release information about our React Native SDK.

v0.38.2

Released 2024-12-05

Patch Changes

  • Add DFPPA to OTP Email Login Or Create

v0.38.1

Released 2024-11-26

Patch Changes

  • Relax the requirement for products specified in the UI config to have a corresponding *Options configuration set if the product can use default options.

v0.38.0

Released 2024-11-26

Minor Changes

  • Update B2B client to enable the ability to disable URL caching on iOS

v0.37.0

Released 2024-11-20

Minor Changes

  • Releasing React Native B2B UI.

v0.36.1

Released 2024-11-19

Patch Changes

  • Fixes a bug where session tokens were not updated after registering a biometric

v0.36.0

Released 2024-11-13

Minor Changes

  • Tenanted Email Authenticate to Use EmailAddress as Input Param Over MemberID

v0.35.3

Released 2024-11-12

Patch Changes

  • Updated dependencies

v0.35.2

Released 2024-11-01

Patch Changes

  • Updated dependencies

v0.35.1

Released 2024-10-30

Patch Changes

  • Updated dependencies

v0.35.0

Released 2024-10-24

Minor Changes

  • Add headless TOTP client to RN B2C client

v0.34.0

Released 2024-10-22

Minor Changes

  • Add override parameters for the WebAuthn registration endpoint.

Patch Changes

  • Remove unused errorMessage field.

v0.33.2

Released 2024-10-16

Patch Changes

  • Update requirements for ReactNative UI to allow OTP/OAuth as valid configurations

v0.33.1

Released 2024-10-14

Patch Changes

  • Updated dependencies

v0.33.0

Released 2024-10-08

Minor Changes

  • Add SCIM client to RN B2B client

v0.32.4

Released 2024-10-08

Patch Changes

  • Fix potential DFP multi continuation bug.

v0.32.3

Released 2024-10-02

Patch Changes

  • Updated dependencies

v0.32.2

Released 2024-09-17

Patch Changes

  • Update StandardCharsets since the Facebook implementation is now Deprecated

v0.32.1

Released 2024-08-28

Patch Changes

  • Updated dependencies

v0.32.0

Released 2024-08-26

Minor Changes

  • Better management of biometric registrations to ensure local and remote registrations stay in sync

  • Update options for enabling SMS autofill in RN and add necessary code changes

v0.31.0

Released 2024-08-23

Minor Changes

  • Add B2B OAuth for react native. Modifying the visibilty of the base class for the headless B2B OAuth client for purposes of inheritence.

v0.30.2

Released 2024-08-21

Patch Changes

  • Updated dependencies

v0.30.1

Released 2024-08-14

Patch Changes

  • Updated dependencies

v0.30.0

Released 2024-08-14

Minor Changes

  • Implements Sign in With Ethereum (SIWE) for crypto wallets

  • Adds ability to view and unlink retired emails to HeadlessB2BOrganizationClient and HeadlessB2BSelfClient.

Patch Changes

  • B2B SSO now properly uses DFP

v0.29.2

Released 2024-08-12

Patch Changes

  • Updated dependencies

v0.29.1

Released 2024-08-09

Patch Changes

  • Updated dependencies

v0.29.0

Released 2024-08-02

Minor Changes

  • Adds dfppaDomain to optional SDK client configuration

v0.28.1

Released 2024-07-25

Patch Changes

  • Updated dependencies

v0.28.0

Released 2024-07-25

Minor Changes

  • Deprecate some properties in RN UI OAuth options and provide a new type for specifying per-provider options; Correctly support provider_params in RN OAuth flows

v0.27.4

Released 2024-07-19

Patch Changes

  • Updated dependencies

v0.27.3

Released 2024-07-12

Patch Changes

  • Updated dependencies

v0.27.2

Released 2024-07-02

Patch Changes

  • Updated dependencies

v0.27.1

Released 2024-06-27

Patch Changes

  • Ensure that DFP/Catcha works for biometrics

v0.27.0

Released 2024-06-18

Minor Changes

  • Fix crash when fetching a null biometric registration ID; Delete biometric registration ID when deleting a biometric key; Force popup of biometric prompt when registering a new biometric

v0.26.5

Released 2024-06-06

Patch Changes

  • Attempt to cleanup orphaned IABs to prevent errors

  • Re-release to force inclusion of IAB changes

v0.26.4

Released 2024-06-06

Patch Changes

  • Fix React Native biometrics policy to correctly respect developers intention for fallback

v0.26.3

Released 2024-05-29

Patch Changes

  • Require non-null session_token in updateSession()

  • Added IDP type to SSO connections

v0.26.2

Released 2024-05-13

Patch Changes

  • Update RN Subscription manager to better match vanilla-js

v0.26.1

Released 2024-05-07

Patch Changes

  • Loosen typings for various options to accept both string literals and TypeScript enums

v0.26.0

Released 2024-04-26

Minor Changes

  • Add stytch.organization.getBySlug method to B2B clients

v0.25.0

Released 2024-04-25

Migration guide

Due to necessary updates to underlying Google packages to support Google Credential Manager on Android 14, Android builds now require a compileSdk version of 34. This necessitates an upgrade of the Android Gradle Plugin to >= 8.1.1. The easiest way to accomplish this is to upgrade to React Native >= 0.73.0, or Expo >= 50.

If you have an existing, bare React Native project (ie: you have an android folder in your codebase), you can edit your android/build.gradle file to specify a compileSdk version of 34, and follow the Android Studio AGP upgrade assistant (Tools > AGP Upgrade Assistant...) to upgrade your project.

To use the redirect-based OAuth flows for Google and Apple, use the new startWithRedirect() methods, like so:

  • stytch.oauth.google.startWithRedirect()
  • stytch.oauth.apple.startWithRedirect()

Minor Changes

  • Migrate from the deprecated Google One Tap implementation to Google Credential Manager

  • Add methods for using redirect based OAuth flows for Google and Apple, instead of the native flows

v0.24.3

Released 2024-04-25

Patch Changes

  • Updated dependencies

v0.24.2

Released 2024-04-23

Patch Changes

  • Remove result check and rely on intent handling to handle user cancellations for Android Google OneTap

v0.24.1

Released 2024-04-19

Patch Changes

  • Remove import of unavailable dependency introduced in previous release

v0.24.0

Released 2024-04-18

Minor Changes

  • Add stytch.onStateChange event listener to headless clients

  • Add getInfo method to user, session, member, and organization

v0.23.6

Released 2024-04-12

Patch Changes

  • Updated dependencies

v0.23.5

Released 2024-04-02

Patch Changes

  • Updated dependencies

v0.23.4

Released 2024-04-02

Patch Changes

  • Updated dependencies

v0.23.3

Released 2024-03-22

Patch Changes

  • Updated dependencies

v0.23.2

Released 2024-03-18

Patch Changes

  • Updated dependencies

v0.23.1

Released 2024-03-18

Patch Changes

  • Added DFP functionality to users search in passwords screen

v0.23.0

Released 2024-03-12

Minor Changes

  • Release RN B2C UI

v0.22.7

Released 2024-03-04

Patch Changes

  • Updated dependencies

v0.22.6

Released 2024-02-27

Patch Changes

  • Fix incorrect imports

v0.22.5

Released 2024-02-13

Patch Changes

  • Fix transient keystore issues in RN Android

v0.22.4

Released 2024-02-08

Patch Changes

  • Fix handling of SSO authentication when MFA is required

v0.22.3

Released 2024-02-06

Patch Changes

  • Updated dependencies

v0.22.2

Released 2024-02-05

Patch Changes

  • Update react-native resolution path to be platform agnostic when doing replacement so it works on windows

v0.22.1

Released 2024-02-02

Patch Changes

  • Changes to React Native iOS DFP client

v0.22.0

Released 2024-02-02

Minor Changes

  • Bump Recaptcha Version

Patch Changes

  • Fixed session not refreshing after app reopening

v0.21.2

Released 2024-01-31

Patch Changes

  • Updated dependencies

v0.21.1

Released 2024-01-29

NOTE: From v0.21.1 onwards, in order to use Apple OAuth, you must toggle Manage user data setting ON in the Frontend SDK settings of your Dashboard.

Patch Changes

  • Fixed React Native Sign in with Apple not returning name values

v0.21.0

Released 2024-01-24

Minor Changes

  • Fix biometrics issues in iOS

v0.20.0

Released 2024-01-22

Minor Changes

  • Adds headless methods for interacting with b2b recovery codes

v0.19.4

Released 2024-01-19

Patch Changes

  • Updated dependencies

v0.19.3

Released 2024-01-18

Patch Changes

  • Updated dependencies

v0.19.2

Released 2024-01-12

Patch Changes

  • Updated dependencies

v0.19.1

Released 2024-01-09

Patch Changes

  • Updated dependencies

v0.19.0

Released 2024-01-04

Minor Changes

  • Add useStytchOrganization hook for B2B

v0.18.1

Released 2024-01-03

Patch Changes

  • Fix packaging issue for RN iOS

v0.18.0

Released 2024-01-02

Minor Changes

  • Add B2B TOTPs (Create/Authenticate)

v0.17.0

Released 2023-12-18

Minor Changes

  • Improvements to error types in the JS and React Native SDKs

  • Mark stytch.member as deprecated in favor of stytch.self Adds RBAC functionality

Patch Changes

  • Remove unused dependencies from package manifest

v0.16.1

Released 2023-12-04

Patch Changes

  • Add DFP Protected Auth to the React Native B2B SDK

v0.16.0

Released 2023-12-01

Minor Changes

  • Migrate RN iOS keys to be available after unlock

v0.15.1

Released 2023-11-27

Patch Changes

  • Updated dependencies

v0.15.0

Released 2023-11-22

Minor Changes

  • Added Passkeys in React Native SDK

v0.14.4

Released 2023-11-20

Patch Changes

  • Add a toplevel DFP client to RN SDK

v0.14.3

Released 2023-11-14

Patch Changes

  • Updated dependencies

v0.14.2

Released 2023-11-07

Patch Changes

  • Updated dependencies

v0.14.1

Released 2023-10-31

Patch Changes

  • Resolved a critical severity vulnerability with the @babel/traverse dependency

v0.14.0

Released 2023-10-26

Minor Changes

  • Export DFP type for use in RN; Embed Recaptcha dependencies to avoid forcing a dynamic framework on developers

v0.13.1

Released 2023-10-13

Patch Changes

  • Add a getPKCEPair util method to react-native StytchClient

v0.13.0

Released 2023-09-22

Minor Changes

  • Revert DFP on RN

v0.12.2

Released 2023-09-21

Patch Changes

  • Make the React Native StytchClient params optional

v0.12.1

Released 2023-09-21

Patch Changes

  • Adds fallback to redirect-based OAuth when native OAuth fails (Google One Tap or Sign in with Apple) in the React Native SDK

v0.12.0

Released 2023-09-20

Minor Changes

  • Add Device Fingerprinting to the React Native SDK

Patch Changes

  • Add support for Observation and decisioning mode for DFP

v0.11.1

Released 2023-09-19

Patch Changes

  • Updated dependencies

v0.11.0

Released 2023-09-19

Minor Changes

  • Add Device Fingerprinting Bot Detection to SDKs

  • Added separate methods for native OAuth (googleOneTap and signInWithApple) in the React Native SDK.

v0.10.4

Released 2023-09-06

Patch Changes

  • Updated dependencies

v0.10.3

Released 2023-08-30

Patch Changes

  • Fix PKCE logic for password resets log in without password flow

v0.10.2

Released 2023-08-29

Patch Changes

  • Updated dependencies

v0.10.1

Released 2023-08-28

Patch Changes

  • Updated dependencies

v0.10.0

Released 2023-08-08

Minor Changes

  • Breaking Changes: The intermediate session token (IST) will no longer be accepted as an argument for the discovery list organizations, intermediate sessions exchange, and create organization via discovery endpoints. The IST will be passed in automatically. ISTs are stored as browser cookies or persisted on device when they are generated after calls to discovery authenticate endpoints, such as email magic link discovery authenticate, or primary authenticate endpoints in the case where MFA is required, such as email magic link authenticate or SSO authenticate.

    New Features: Our B2B product now supports multi-factor authentication (MFA) with one-time passcodes (OTPs) via SMS. MFA policies can be set on the Organization level or on the Member level. See the Stytch docs for more information.

v0.9.6

Released 2023-08-03

Patch Changes

  • Updated dependencies

v0.9.5

Released 2023-08-02

Patch Changes

  • Add a flag to disable the URLCache on iOS

v0.9.4

Released 2023-08-01

Patch Changes

  • Updated types for the password strength method. Updated UI for the password strength check while using LUDS

v0.9.3

Released 2023-07-19

Patch Changes

  • Yahoo OAuth Fix (build)

v0.9.2

Released 2023-07-19

Patch Changes

  • Yahoo OAuth

v0.9.1

Released 2023-07-17

Patch Changes

  • Add B2B for ReactNative

v0.9.0

Released 2023-07-14

Minor Changes

  • The intermediate session token will now be stored as a cookie after calls to the B2B magic link discovery authenticate endpoint and the OAuth discovery authenticate endpoint.

v0.8.14

Released 2023-07-12

Patch Changes

  • Added new OAuth Providers

v0.8.13

Released 2023-07-12

Patch Changes

  • Add OAuthStartResponse type to Headless OAuth start calls

v0.8.12

Released 2023-07-10

Patch Changes

  • Update dependency to stytch named fork

v0.8.11

Released 2023-06-29

Patch Changes

  • Match BC dependency to expo-updates to alleviate issues with EAS builds

v0.8.10

Released 2023-06-28

Patch Changes

  • Robustify react-native dependency resolution

v0.8.9

Released 2023-06-27

Patch Changes

  • Updated dependencies

v0.8.8

Released 2023-06-26

Patch Changes

  • Import React in SessionMigrationHelper, which is needed for some reason in bare RN projects?

v0.8.7

Released 2023-06-23

Patch Changes

  • Updated dependencies

v0.8.6

Released 2023-06-14

Patch Changes

  • Get timezone from native code

v0.8.5

Released 2023-06-13

Patch Changes

  • Update targetSDK version

v0.8.4

Released 2023-06-09

Patch Changes

  • Add the podspec for StytchReactNativeModule

v0.8.3

Released 2023-06-08

Patch Changes

  • Add Android test files to npmignore to reduce package size

v0.8.2

Released 2023-06-07

Patch Changes

  • Include native modules in react-native package

v0.8.1

Released 2023-06-06

Patch Changes

  • Update package README

v0.8.0

Released 2023-06-06

Migration guide

We have made significant changes to the Stytch React Native SDK to make installation and configuration easier for developers. This is a migration guide for all developers using the Stytch React Native and React Native Expo SDKs prior to v0.8.

  • If you are currently using Expo Go, start at Development builds below.
  • If you are currently using Expo development builds, start at Stytch React Native Expo SDK below.
  • Otherwise, start at Stytch React Native SDK near the bottom of this section.

Development builds

The Stytch React Native SDK requires the use of custom native code for the best auth experience. Expo Go does not allow custom native code, and as a result, we no longer support apps using Expo Go.

We recommend moving to development builds to support custom native code and to continue using the Stytch React Native SDK. You may want to complete the steps in Stytch React Native Expo SDK and Stytch React Native SDK before starting to create a development build to have the correct dependencies set up. The Expo documentation provides an in-depth guide for creating a development build, but these are the main steps:

  1. Create an Expo account if you don't already have one.
  2. Install the eas-cli package globally.
    npm install -g eas-cli
  3. Log into your Expo account.
    eas login
  4. Install the expo-dev-client package in your project.
    npx expo install expo-dev-client
  5. Create a development build using EAS Build.
    eas build

Stytch React Native Expo SDK

All React Native and Expo projects can now use @stytch/react-native. The @stytch/react-native-expo package will no longer be maintained but is still available for existing customers using this version.

To migrate your Expo project to @stytch/react-native, the only changes that you'll need to make to your are installing the @stytch/react-native package and uninstalling the @stytch/react-native-expo package (along with other dependencies that are no longer required):

# Remove old package and dependencies
npm uninstall @stytch/react-native-expo @stytch/react-native-modules react-native-keychain react-native-device-info react-native-get-random-values

# Install new package
npm install @stytch/react-native @stytch/react-native-inappbrowser-reborn

Stytch React Native SDK

The @stytch/react-native-modules package is now included in @stytch/react-native by default.

Some of the previous dependencies for @stytch/react-native can be removed, this includes react-native-keychain, react-native-device-info, and react-native-get-random-values.

We recommend removing these old dependencies and adding the new @stytch/react-native-inappbrowser-reborn dependency to keep your build clean:

# Remove old dependencies
npm uninstall @stytch/react-native-modules react-native-keychain react-native-device-info react-native-get-random-values

# Install new dependency
npm install @stytch/react-native-inappbrowser-reborn

Minor Changes

  • Unify React Native and Expo SDKs

v0.7.6

Released 2023-06-06

Patch Changes

  • Updated dependencies

v0.7.5

Released 2023-06-06

Patch Changes

  • Updated dependencies

v0.7.4

Released 2023-05-31

Patch Changes

  • Updated dependencies

v0.7.3

Released 2023-05-26

Patch Changes

  • Updated dependencies

v0.7.2

Released 2023-05-22

Patch Changes

  • Updated dependencies

v0.7.1

Released 2023-05-05

Patch Changes

  • Expose Biometric Registration ID in BiometricsClients

v0.7.0

Released 2023-04-28

Minor Changes

  • Releasing UI components for our B2B SDKs.

v0.6.4

Released 2023-04-27

Patch Changes

  • Fix broken React Native OAuth redirect

v0.6.3

Released 2023-04-25

Patch Changes

  • Updated dependencies

v0.6.2

Released 2023-04-24

Patch Changes

  • Updated dependencies

v0.6.1

Released 2023-04-17

Patch Changes

  • Updated dependencies

v0.6.0

Released 2023-04-12

@stytch/react-native@0.6.0 updates the useStytchUser and useStytchSession hooks. The useStytchUser and useStytchSession hooks now return envelope objects, {(user, fromCache)} and {(session, fromCache)} respectively. On first render, the SDK will read the user or session out of local storage, and serve them with fromCache: true. The SDK will make network requests to update the user and session objects, and serve them with fromCache: false.

Minor Changes

  • Add ability to tell if user is new/returning for native OAuth

  • Adds fromCache value into User and Session objects

v0.5.13

Released 2023-04-12

Patch Changes

  • Updated dependencies

v0.5.12

Released 2023-04-11

Patch Changes

  • Switch to using an in-app browser for non-native OAuth flows

v0.5.11

Released 2023-04-05

Patch Changes

  • Clear Stytch Keychain items from iOS on fresh install

v0.5.10

Released 2023-03-31

Patch Changes

  • Add Session.updateSession to hydrate sessions from the backend

v0.5.9

Released 2023-03-30

Patch Changes

  • initialize user and session in StytchProvider

v0.5.8

Released 2023-03-29

Patch Changes

  • Updated dependencies

v0.5.7

Released 2023-03-23

Patch Changes

  • Updated dependencies

v0.5.6

Released 2023-03-23

Patch Changes

  • Updated dependencies

v0.5.5

Released 2023-03-21

Patch Changes

  • Fix session/user persisting after logging out

v0.5.4

Released 2023-03-21

Patch Changes

  • SDK-877 Fix session/user persisting after logging out

v0.5.3

Released 2023-03-15

Patch Changes

  • Fixed PKCE mismatch and session revoke bugs in React Native

  • Add sessionDurationMinutes parameter for biometrics.register()

v0.5.2

Released 2023-03-09

Patch Changes

  • Updated dependencies

v0.5.1

Released 2023-03-07

Patch Changes

  • Add React Native OAuth callback, PKCE fix

v0.5.0

Released 2023-03-01

Minor Changes

  • Launching B2B SDKs

v0.4.2

Released 2023-02-22

Patch Changes

  • Updated dependencies

v0.4.1

Released 2023-02-21

Patch Changes

  • Updated dependencies

v0.4.0

Released 2023-02-17

Minor Changes

  • Add React Native OAuth

v0.3.1

Released 2023-02-07

Patch Changes

  • Updated dependencies

v0.3.0

Released 2023-01-20

Minor Changes

  • Add support for template ID parameters to Magic link Login or create and Send methods, Email OTP Login or create and Send methods, and Reset Password Start

v0.2.12

Released 2023-01-17

Patch Changes

  • Fix bug with PKCE code verifiers being shared over multiple methods

v0.2.11

Released 2022-12-22

Patch Changes

  • Add React Native biometrics

v0.2.9

Released 2022-12-13

Patch Changes

  • Updated dependencies

v0.2.8

Released 2022-12-13

Patch Changes

  • Fixes an issue where the isLoaded property was prematurely returning 'true'

v0.2.7

Released 2022-11-07

Patch Changes

  • Updated dependencies

v0.2.6

Released 2022-10-31

Patch Changes

  • Add type definitions for User Metadata fields

v0.2.5

Released 2022-10-07

Patch Changes

  • Updated dependencies

v0.2.4

Released 2022-10-03

Patch Changes

  • Add support for password client

v0.2.3

Released 2022-09-30

Patch Changes

  • Updated dependencies