• Expo SDK 53 or higher (react-native-auth0 v5.x requires Expo 53+)
• React 19 and React Native 0.78.0 or higher
• Auth0 account with a Native application configured
• If Auth0 is not set up yet, use the

  auth0-quickstart

  skill first
• Not compatible with Expo Go — requires custom development client or EAS Build

Agent instruction: Before installing the Auth0 SDK, check if the project has

expo-dev-client

installed. Read the project's

package.json

and look for

expo-dev-client

in

dependencies

or

devDependencies

.

• If

  expo-dev-client

  is found: Proceed to step 3.
• If

  expo-dev-client

  is NOT found: Use

  AskUserQuestion

  with the following message:
  "The

  react-native-auth0

  SDK requires a custom Expo development client — it does not work with Expo Go. Your project does not have

  expo-dev-client

  installed.
  How would you like to proceed?
  1. Install it for me — I'll run

     npx expo install expo-dev-client

     and continue setup
  2. I'll set it up myself — skip this step and continue to Auth0 SDK installation"
  If the user picks option 1, run:
  bash

  npx expo install expo-dev-client

  Then proceed to step 3. If option 2, proceed to step 3 directly.

Auth0Provider

useAuth0

Agent instruction: Before adding new UI elements, search the project for existing click handlers for login, logout, sign-in, or sign-out buttons. If existing handlers are found, hook the Auth0 code into them. Only create new buttons if no existing handlers are found.

import React from 'react';
import { Auth0Provider, useAuth0 } from 'react-native-auth0';
import { View, Button, Text, ActivityIndicator } from 'react-native';

function HomeScreen() {
  const { authorize, clearSession, user, isLoading, error } = useAuth0();

  const login = async () => {
    try {
      await authorize(
        { scope: 'openid profile email' },
        { customScheme: 'YOUR_CUSTOM_SCHEME' }
      );
    } catch (e) {
      console.error('Login error:', e);
    }
  };

  const logout = async () => {
    try {
      await clearSession({ customScheme: 'YOUR_CUSTOM_SCHEME' });
    } catch (e) {
      console.error('Logout error:', e);
    }
  };

  if (isLoading) {
    return <ActivityIndicator size="large" />;
  }

  return (
    <View>
      {user ? (
        <>
          <Text>Welcome, {user.name}!</Text>
          <Text>{user.email}</Text>
          <Button title="Log Out" onPress={logout} />
        </>
      ) : (
        <Button title="Log In" onPress={login} />
      )}
      {error && <Text>{error.message}</Text>}
    </View>
  );
}

export default function App() {
  return (
    <Auth0Provider
      domain="YOUR_AUTH0_DOMAIN"
      clientId="YOUR_AUTH0_CLIENT_ID"
    >
      <HomeScreen />
    </Auth0Provider>
  );
}

Agent instruction: After completing the integration, build the project to verify it compiles:

bash

npx expo prebuild --clean
npx expo run:ios
# or
npx expo run:android

If the build fails, analyze the error output. Common integration build failures include:

• "Invariant Violation: Native module cannot be null": Using Expo Go instead of a development build — run

  npx expo run:ios

  or

  npx expo run:android

  instead of

  npx expo start

• Plugin not applied: Missing

  react-native-auth0

  in app.json plugins array — verify the plugin configuration
• Pod install fails (iOS): Run

  npx expo prebuild --clean

  to regenerate native projects
• Manifest merge failure (Android): Conflicting auth0Domain placeholder — ensure only the config plugin sets the domain

Re-run the build after each fix. Track the number of build-fix iterations.

Failcheck: If the build still fails after 5–6 fix attempts, stop and ask the user using

AskUserQuestion

: "The build is still failing after several fix attempts. How would you like to proceed?"

• Let the skill continue fixing iteratively
• Fix it manually — show the remaining errors
• Skip build verification — proceed without a successful build

• Setup Guide — Dev client requirement, automated setup, Expo config plugin, callback URLs, EAS Build, secret management
• Integration Patterns — Login/logout, credential management, biometric auth, token refresh, organizations, DPoP, error handling
• API Reference & Testing — Configuration options, useAuth0 hook API, testing checklist, common issues, security

• auth0-quickstart — Set up an Auth0 account and application
• auth0-react-native — Bare React Native CLI projects
• auth0-mfa — Configure multi-factor authentication
• auth0-cli — Manage Auth0 resources from the terminal

• Auth0 Expo Quickstart
• react-native-auth0 GitHub Repository
• react-native-auth0 API Documentation
• Expo Sample App
• EXAMPLES.md