Frontegg is a self-served user management platform for modern SaaS applications. Drop this SDK in and your app gets a production login screen, a live session, and a user object — without you writing an auth flow or touching a token.

| | | | --- | --- | | Hosted or embedded login | Frontegg's login box, or your own UI on top of the API | | Every method your tenants need | Email, social, SSO, magic link, passkeys, MFA and step-up | | Sessions that stay alive | Tokens refresh in the background, on both platforms | | Built for multi-tenant SaaS | Multi-tenancy, RBAC, entitlements and multi-region support |

Install

npm install @frontegg/react-native

Then the peer dependencies:

# Expo
npx expo install @react-native-async-storage/async-storage @react-navigation/native @react-navigation/native-stack react-native-screens react-native-safe-area-context

# Bare React Native
npm install @react-native-async-storage/async-storage @react-navigation/native @react-navigation/native-stack react-native-screens react-native-safe-area-context

Requirements: React Native 0.63+ · iOS deployment target 14+ · Android API 26+ with JDK 17 and AGP 7.4+. Passkeys additionally need iOS 15+ and Chrome Custom Tabs on Android.

Quick start

1 · Allow the redirect URLs. In the Frontegg Portal, under [ENVIRONMENT] → Authentication → Login method, turn hosted login on and add the shared URL plus one per platform:

{{FRONTEGG_BASE_URL}}/oauth/authorize

# iOS
{{IOS_BUNDLE_IDENTIFIER}}://{{FRONTEGG_BASE_URL}}/ios/oauth/callback

# Android
{{ANDROID_PACKAGE_NAME}}://{{FRONTEGG_BASE_URL}}/android/oauth/callback
https://{{FRONTEGG_BASE_URL}}/oauth/account/redirect/android/{{ANDROID_PACKAGE_NAME}}

2 · Configure the native projects. iOS reads a Frontegg.plist; Android takes its domain and client ID from build.gradle. Both are covered step by step in the Setup guide — this is the one part that is not JavaScript, and it differs per platform.

3 · Wrap your app.

import { NavigationContainer } from '@react-navigation/native';
import { FronteggWrapper } from '@frontegg/react-native';

export default function App() {
  return (
    <FronteggWrapper>
      <NavigationContainer>
        {/* your navigator */}
      </NavigationContainer>
    </FronteggWrapper>
  );
}

4 · Read the authentication state anywhere below it.

import { View, Button } from 'react-native';
import { useAuth, login } from '@frontegg/react-native';

export function MyScreen() {
  const { isAuthenticated } = useAuth();

  return (
    <View>
      {isAuthenticated ? <Profile /> : <Button title="Login" onPress={login} />}
    </View>
  );
}

Documentation

| Guide | What it covers | | --- | --- | | Get Started | Requirements, environment prep, installation | | Setup | iOS and Android native configuration | | Usage Examples | Hooks, login flows, error handling | | API Reference | Every method, hook and type the SDK exports | | Advanced Topics | Complex integration scenarios |

Full platform documentation lives at developers.frontegg.com.

Example app

A complete integration you can run: example.

Support

No Frontegg account yet? Sign up free.

Questions, or something broken? Reach the team at support.frontegg.com or open an issue.

Licensed under the LICENSE in this repository.