Labsco — the lab for AI agents, MCP servers & skills

Use when adding authentication to React Native or Expo mobile apps (iOS/Android) with biometric support - integrates react-native-auth0 SDK with native deep…

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.

by auth0

Use when adding authentication to React Native or Expo mobile apps (iOS/Android) with biometric support - integrates react-native-auth0 SDK with native deep… npx skills add https://github.com/auth0/agent-skills --skill auth0-react-native Download ZIP GitHub37

Auth0 React Native Integration

Add authentication to React Native and Expo mobile applications using react-native-auth0.

When NOT to Use

Expo managed workflow - Use auth0-expo skill for Expo apps with config plugin
React web applications - Use auth0-react skill for SPAs (Vite/CRA)
React Server Components - Use auth0-nextjs for Next.js applications
Non-React native apps - Use platform-specific SDKs (Swift for iOS, Kotlin for Android)
Backend APIs - Use JWT validation libraries for your server language

Detailed Documentation

Setup Guide - Automated setup, native configuration, deep linking
Patterns Guide - Secure storage, biometric auth, token refresh
API Reference - Complete SDK API, methods, configuration options

Related Skills

auth0-quickstart - Basic Auth0 setup
auth0-migration - Migrate from another auth provider
auth0-mfa - Add Multi-Factor Authentication
auth0-cli - Manage Auth0 resources from the terminal

Quick Reference

Core Hook API:

useAuth0() - Main hook for authentication
authorize() - Initiate login
clearSession() - Logout
user - User profile object
getCredentials() - Get tokens for API calls
isLoading - Loading state

Common Use Cases:

Login/Logout → See Step 5 above
Secure token storage → Automatic with Auth0Provider
Biometric authentication → Patterns Guide
API calls with tokens → Patterns Guide
Token refresh → Automatic with getCredentials()

References

Copy & paste — that's it

npx expo install react-native-auth0

Run this in your project — your agent picks the skill up automatically.

Prerequisites

React Native or Expo application
Auth0 account and application configured as Native type
If you don't have Auth0 set up yet, use the auth0-quickstart skill first

Quick Start Workflow

1. Install SDK

Expo:

Copy & paste — that's it

npx expo install react-native-auth0

React Native CLI:

Copy & paste — that's it

npm install react-native-auth0
npx pod-install # iOS only

2. Configure Environment

For automated setup with Auth0 CLI, see Setup Guide for complete scripts.

For manual setup:

Create .env:

Copy & paste — that's it

AUTH0_DOMAIN=your-tenant.auth0.com
AUTH0_CLIENT_ID=your-client-id

3. Configure Native Platforms

iOS - Update ios/{YourApp}/Info.plist:

Copy & paste — that's it

 CFBundleURLTypes 
 
 
 CFBundleTypeRole 
 None 
 CFBundleURLName 
 auth0 
 CFBundleURLSchemes 
 
 $(PRODUCT_BUNDLE_IDENTIFIER).auth0

Android - Update android/app/src/main/AndroidManifest.xml:

Copy & paste — that's it

Expo - Update app.json:

Copy & paste — that's it

{
 "expo": {
 "scheme": "your-app-scheme",
 "ios": {
 "bundleIdentifier": "com.yourcompany.yourapp"
 },
 "android": {
 "package": "com.yourcompany.yourapp"
 }
 }
}

4. Add Authentication with Auth0Provider

Wrap your app with Auth0Provider:

Copy & paste — that's it

import React from 'react';
import { Auth0Provider } from 'react-native-auth0';
import App from './App';

export default function Root() {
 return (
 
 
 
 );
}

5. Use the useAuth0 Hook

Copy & paste — that's it

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

export default function App() {
 const { user, authorize, clearSession, isLoading } = useAuth0();

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

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

 if (isLoading) {
 return ;
 }

 return (
 
 {user ? (
 <>
 Welcome, {user.name}! 
 {user.email} 
 
 
 ) : (
 
 )}
 
 );
}

6. Test Authentication

Expo:

Copy & paste — that's it

npx expo start

React Native:

Copy & paste — that's it

npx react-native run-ios
# or
npx react-native run-android

Common Mistakes

Mistake Fix Forgot to wrap app with Auth0Provider All components using useAuth0() must be children of Auth0Provider Forgot to configure deep linking Add URL scheme to iOS Info.plist and Android AndroidManifest.xml (see Step 3) Callback URL mismatch Ensure callback URL in Auth0 Dashboard matches your app's URL scheme (e.g., com.yourapp.auth0://YOUR_DOMAIN/ios/com.yourapp/callback) iOS build fails after install Run npx pod-install to link native dependencies App created as SPA type in Auth0 Must be Native application type for mobile apps Not handling auth errors Wrap authorize/clearSession calls in try-catch blocks Deep link not working on Android Verify android:exported="true" is set on RedirectActivity