docs(react-native): Expo cross-platform social sign-in with complete example (#38178)

* docs(react-native): create the basic expo project * docs(react-native): cross-platform Apple social sign-in * docs(react-native): cross-platform Google social sign-in * docs(react-native): fix typos * docs(react-native): remove wrong entry in the `Connection` component * Correct typos * Prettier * Draft * Draft * docs(react-native): use kebab-case file naming convention in Expo guide - use kebab-case file naming convention in Expo guide - add trailing semicolon to align with the standard Expo template conventions * docs(react-native): use kebab-case file naming convention in Expo social auth example * docs(react-native): update the packages of the Expo social auth example * Fix * Draft * Changes * Correct log message --------- Co-authored-by: Chris Chinchilla <chris.ward@supabase.io> Co-authored-by: Chris Chinchilla <chris@chrischinchilla.com>
2025-09-19 16:53:35 +02:00
parent 19cfa66d9e
commit 3139f85b5d
59 changed files with 16857 additions and 0 deletions
--- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
+++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
@@ -620,6 +620,10 @@ export const auth: NavMenuConstant = {
          name: 'React Native',
          url: '/guides/auth/quickstarts/react-native' as `/${string}`,
        },
+        {
+          name: 'React Native with Expo & Social Auth',
+          url: '/guides/auth/quickstarts/with-expo-react-native-social-auth',
+        },
      ],
    },

--- a/apps/docs/content/guides/auth/quickstarts/with-expo-react-native-social-auth.mdx
+++ b/apps/docs/content/guides/auth/quickstarts/with-expo-react-native-social-auth.mdx
--- a/apps/docs/content/guides/getting-started.mdx
+++ b/apps/docs/content/guides/getting-started.mdx
@@ -321,6 +321,14 @@ hideToc: true
      hasLightIcon: true,
      enabled: true
    },
+    {
+      title: 'Expo React Native Social Auth',
+      href: '/guides/getting-started/tutorials/with-expo-react-native-social-auth',
+      description:
+        'Learn how to implement social authentication in an app with Expo React Native and Supabase Database and Auth functionality.',
+      icon: '/docs/img/icons/expo-icon',
+      hasLightIcon: true
+    },
    {
      title: 'Android Kotlin',
      href: '/guides/getting-started/tutorials/with-kotlin',
--- a/apps/docs/public/img/supabase-expo-social-auth-login.png
+++ b/apps/docs/public/img/supabase-expo-social-auth-login.png
--- a/apps/docs/public/img/supabase-expo-social-auth-tabs.png
+++ b/apps/docs/public/img/supabase-expo-social-auth-tabs.png
--- a/apps/www/lib/redirects.js
+++ b/apps/www/lib/redirects.js
@@ -1831,11 +1831,21 @@ module.exports = [
    source: '/docs/guides/with-expo',
    destination: '/docs/guides/getting-started/tutorials/with-expo-react-native',
  },
+  {
+    permanent: true,
+    source: '/docs/guides/with-expo-social-auth',
+    destination: '/docs/guides/getting-started/tutorials/with-expo-react-native-social-auth',
+  },
  {
    permanent: true,
    source: '/docs/guides/getting-started/tutorials/with-expo',
    destination: '/docs/guides/getting-started/tutorials/with-expo-react-native',
  },
+  {
+    permanent: true,
+    source: '/docs/guides/getting-started/tutorials/with-expo-social-auth',
+    destination: '/docs/guides/getting-started/tutorials/with-expo-react-native-social-auth',
+  },
  {
    permanent: true,
    source: '/docs/guides/with-kotlin',
--- a/examples/auth/expo-social-auth/.env.template
+++ b/examples/auth/expo-social-auth/.env.template
@@ -0,0 +1,5 @@
+EXPO_PUBLIC_SUPABASE_URL=""
+EXPO_PUBLIC_SUPABASE_ANON_KEY=""
+EXPO_PUBLIC_APPLE_AUTH_SERVICE_ID=""
+EXPO_PUBLIC_APPLE_AUTH_REDIRECT_URI=""
+EXPO_PUBLIC_GOOGLE_AUTH_WEB_CLIENT_ID=""
--- a/examples/auth/expo-social-auth/.gitignore
+++ b/examples/auth/expo-social-auth/.gitignore
@@ -0,0 +1,39 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+
+# Native
+.kotlin/
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+app-example
--- a/examples/auth/expo-social-auth/README.md
+++ b/examples/auth/expo-social-auth/README.md
@@ -0,0 +1,52 @@
+# Welcome to your Expo app 👋
+
+This is an [Expo](https://expo.dev) project created with [`create-expo-app`](https://www.npmjs.com/package/create-expo-app).
+
+## Get started
+
+1. Install dependencies
+
+   ```bash
+   npm install
+   ```
+
+2. Update the `.env` file with your Supabase project's URL and Anon Key.
+
+3. Start the app
+
+   ```bash
+   npx expo start
+   ```
+
+In the output, you'll find options to open the app in a
+
+- [development build](https://docs.expo.dev/develop/development-builds/introduction/)
+- [Android emulator](https://docs.expo.dev/workflow/android-studio-emulator/)
+- [iOS simulator](https://docs.expo.dev/workflow/ios-simulator/)
+- [Expo Go](https://expo.dev/go), a limited sandbox for trying out app development with Expo
+
+You can start developing by editing the files inside the **app** directory. This project uses [file-based routing](https://docs.expo.dev/router/introduction).
+
+## Get a fresh project
+
+When you're ready, run:
+
+```bash
+npm run reset-project
+```
+
+This command will move the starter code to the **app-example** directory and create a blank **app** directory where you can start developing.
+
+## Learn more
+
+To learn more about developing your project with Expo, look at the following resources:
+
+- [Expo documentation](https://docs.expo.dev/): Learn fundamentals, or go into advanced topics with our [guides](https://docs.expo.dev/guides).
+- [Learn Expo tutorial](https://docs.expo.dev/tutorial/introduction/): Follow a step-by-step tutorial where you'll create a project that runs on Android, iOS, and the web.
+
+## Join the community
+
+Join our community of developers creating universal apps.
+
+- [Expo on GitHub](https://github.com/expo/expo): View our open source platform and contribute.
+- [Discord community](https://chat.expo.dev): Chat with Expo users and ask questions.
--- a/examples/auth/expo-social-auth/app.json
+++ b/examples/auth/expo-social-auth/app.json
@@ -0,0 +1,54 @@
+{
+  "expo": {
+    "name": "expo-social-auth",
+    "slug": "expo-social-auth",
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "icon": "./assets/images/icon.png",
+    "scheme": "exposocialauth",
+    "userInterfaceStyle": "automatic",
+    "newArchEnabled": true,
+    "ios": {
+      "bundleIdentifier": "com.anonymous.exposocialauth",
+      "supportsTablet": true,
+      "usesAppleSignIn": true
+    },
+    "android": {
+      "adaptiveIcon": {
+        "backgroundColor": "#ffffff",
+        "foregroundImage": "./assets/images/adaptive-icon.png"
+      },
+      "edgeToEdgeEnabled": true,
+      "package": "com.anonymous.exposocialauth"
+    },
+    "web": {
+      "bundler": "metro",
+      "favicon": "./assets/images/favicon.png",
+      "output": "single"
+    },
+    "plugins": [
+      "expo-router",
+      [
+        "expo-splash-screen",
+        {
+          "backgroundColor": "#ffffff",
+          "image": "./assets/images/splash-icon.png",
+          "imageWidth": 200,
+          "resizeMode": "contain"
+        }
+      ],
+      "expo-secure-store",
+      "expo-apple-authentication",
+      [
+        "expo-web-browser",
+        {
+          "experimentalLauncherActivity": false
+        }
+      ]
+    ],
+    "experiments": {
+      "typedRoutes": true,
+      "reactCompiler": true
+    }
+  }
+}
--- a/examples/auth/expo-social-auth/app/(tabs)/_layout.tsx
+++ b/examples/auth/expo-social-auth/app/(tabs)/_layout.tsx
@@ -0,0 +1,45 @@
+import { Tabs } from 'expo-router';
+import React from 'react';
+import { Platform } from 'react-native';
+
+import { HapticTab } from '@/components/haptic-tab';
+import { IconSymbol } from '@/components/ui/icon-symbol';
+import TabBarBackground from '@/components/ui/tab-bar-background';
+import { Colors } from '@/constants/colors';
+import { useColorScheme } from '@/hooks/use-color-scheme';
+
+export default function TabLayout() {
+  const colorScheme = useColorScheme();
+
+  return (
+    <Tabs
+      screenOptions={{
+        tabBarActiveTintColor: Colors[colorScheme ?? 'light'].tint,
+        headerShown: false,
+        tabBarButton: HapticTab,
+        tabBarBackground: TabBarBackground,
+        tabBarStyle: Platform.select({
+          ios: {
+            // Use a transparent background on iOS to show the blur effect
+            position: 'absolute',
+          },
+          default: {},
+        }),
+      }}>
+      <Tabs.Screen
+        name="index"
+        options={{
+          title: 'Home',
+          tabBarIcon: ({ color }) => <IconSymbol size={28} name="house.fill" color={color} />,
+        }}
+      />
+      <Tabs.Screen
+        name="explore"
+        options={{
+          title: 'Explore',
+          tabBarIcon: ({ color }) => <IconSymbol size={28} name="paperplane.fill" color={color} />,
+        }}
+      />
+    </Tabs>
+  );
+}
--- a/examples/auth/expo-social-auth/app/(tabs)/explore.tsx
+++ b/examples/auth/expo-social-auth/app/(tabs)/explore.tsx
@@ -0,0 +1,110 @@
+import { Image } from 'expo-image';
+import { Platform, StyleSheet } from 'react-native';
+
+import { Collapsible } from '@/components/collapsible';
+import { ExternalLink } from '@/components/external-link';
+import ParallaxScrollView from '@/components/parallax-scroll-view';
+import { ThemedText } from '@/components/themed-text';
+import { ThemedView } from '@/components/themed-view';
+import { IconSymbol } from '@/components/ui/icon-symbol';
+
+export default function TabTwoScreen() {
+  return (
+    <ParallaxScrollView
+      headerBackgroundColor={{ light: '#D0D0D0', dark: '#353636' }}
+      headerImage={
+        <IconSymbol
+          size={310}
+          color="#808080"
+          name="chevron.left.forwardslash.chevron.right"
+          style={styles.headerImage}
+        />
+      }>
+      <ThemedView style={styles.titleContainer}>
+        <ThemedText type="title">Explore</ThemedText>
+      </ThemedView>
+      <ThemedText>This app includes example code to help you get started.</ThemedText>
+      <Collapsible title="File-based routing">
+        <ThemedText>
+          This app has two screens:{' '}
+          <ThemedText type="defaultSemiBold">app/(tabs)/index.tsx</ThemedText> and{' '}
+          <ThemedText type="defaultSemiBold">app/(tabs)/explore.tsx</ThemedText>
+        </ThemedText>
+        <ThemedText>
+          The layout file in <ThemedText type="defaultSemiBold">app/(tabs)/_layout.tsx</ThemedText>{' '}
+          sets up the tab navigator.
+        </ThemedText>
+        <ExternalLink href="https://docs.expo.dev/router/introduction">
+          <ThemedText type="link">Learn more</ThemedText>
+        </ExternalLink>
+      </Collapsible>
+      <Collapsible title="Android, iOS, and web support">
+        <ThemedText>
+          You can open this project on Android, iOS, and the web. To open the web version, press{' '}
+          <ThemedText type="defaultSemiBold">w</ThemedText> in the terminal running this project.
+        </ThemedText>
+      </Collapsible>
+      <Collapsible title="Images">
+        <ThemedText>
+          For static images, you can use the <ThemedText type="defaultSemiBold">@2x</ThemedText> and{' '}
+          <ThemedText type="defaultSemiBold">@3x</ThemedText> suffixes to provide files for
+          different screen densities
+        </ThemedText>
+        <Image source={require('@/assets/images/react-logo.png')} style={{ alignSelf: 'center' }} />
+        <ExternalLink href="https://reactnative.dev/docs/images">
+          <ThemedText type="link">Learn more</ThemedText>
+        </ExternalLink>
+      </Collapsible>
+      <Collapsible title="Custom fonts">
+        <ThemedText>
+          Open <ThemedText type="defaultSemiBold">app/_layout.tsx</ThemedText> to see how to load{' '}
+          <ThemedText style={{ fontFamily: 'SpaceMono' }}>
+            custom fonts such as this one.
+          </ThemedText>
+        </ThemedText>
+        <ExternalLink href="https://docs.expo.dev/versions/latest/sdk/font">
+          <ThemedText type="link">Learn more</ThemedText>
+        </ExternalLink>
+      </Collapsible>
+      <Collapsible title="Light and dark mode components">
+        <ThemedText>
+          This template has light and dark mode support. The{' '}
+          <ThemedText type="defaultSemiBold">useColorScheme()</ThemedText> hook lets you inspect
+          what the user&apos;s current color scheme is, and so you can adjust UI colors accordingly.
+        </ThemedText>
+        <ExternalLink href="https://docs.expo.dev/develop/user-interface/color-themes/">
+          <ThemedText type="link">Learn more</ThemedText>
+        </ExternalLink>
+      </Collapsible>
+      <Collapsible title="Animations">
+        <ThemedText>
+          This template includes an example of an animated component. The{' '}
+          <ThemedText type="defaultSemiBold">components/HelloWave.tsx</ThemedText> component uses
+          the powerful <ThemedText type="defaultSemiBold">react-native-reanimated</ThemedText>{' '}
+          library to create a waving hand animation.
+        </ThemedText>
+        {Platform.select({
+          ios: (
+            <ThemedText>
+              The <ThemedText type="defaultSemiBold">components/ParallaxScrollView.tsx</ThemedText>{' '}
+              component provides a parallax effect for the header image.
+            </ThemedText>
+          ),
+        })}
+      </Collapsible>
+    </ParallaxScrollView>
+  );
+}
+
+const styles = StyleSheet.create({
+  headerImage: {
+    color: '#808080',
+    bottom: -90,
+    left: -35,
+    position: 'absolute',
+  },
+  titleContainer: {
+    flexDirection: 'row',
+    gap: 8,
+  },
+});
--- a/examples/auth/expo-social-auth/app/(tabs)/index.tsx
+++ b/examples/auth/expo-social-auth/app/(tabs)/index.tsx
@@ -0,0 +1,56 @@
+import { Image } from 'expo-image';
+import { StyleSheet } from 'react-native';
+
+import { HelloWave } from '@/components/hello-wave';
+import ParallaxScrollView from '@/components/parallax-scroll-view';
+import { ThemedText } from '@/components/themed-text';
+import { ThemedView } from '@/components/themed-view';
+import SignOutButton from '@/components/social-auth-buttons/sign-out-button';
+import { useAuthContext } from '@/hooks/use-auth-context';
+
+export default function HomeScreen() {
+
+  const { profile } = useAuthContext();
+
+  return (
+    <ParallaxScrollView
+      headerBackgroundColor={{ light: '#A1CEDC', dark: '#1D3D47' }}
+      headerImage={
+        <Image
+          source={require('@/assets/images/partial-react-logo.png')}
+          style={styles.reactLogo}
+        />
+      }>
+      <ThemedView style={styles.titleContainer}>
+        <ThemedText type="title">Welcome!</ThemedText>
+        <HelloWave />
+      </ThemedView>
+      <ThemedView style={styles.stepContainer}>
+        <ThemedText type="subtitle">Username</ThemedText>
+        <ThemedText>{profile?.username}</ThemedText>
+        <ThemedText type="subtitle">Full name</ThemedText>
+        <ThemedText>{profile?.full_name}</ThemedText>
+      </ThemedView>
+      <SignOutButton />
+    </ParallaxScrollView>
+  );
+}
+
+const styles = StyleSheet.create({
+  titleContainer: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    gap: 8,
+  },
+  stepContainer: {
+    gap: 8,
+    marginBottom: 8,
+  },
+  reactLogo: {
+    height: 178,
+    width: 290,
+    bottom: 0,
+    left: 0,
+    position: 'absolute',
+  },
+});
--- a/examples/auth/expo-social-auth/app/+not-found.tsx
+++ b/examples/auth/expo-social-auth/app/+not-found.tsx
@@ -0,0 +1,32 @@
+import { Link, Stack } from 'expo-router';
+import { StyleSheet } from 'react-native';
+
+import { ThemedText } from '@/components/themed-text';
+import { ThemedView } from '@/components/themed-view';
+
+export default function NotFoundScreen() {
+  return (
+    <>
+      <Stack.Screen options={{ title: 'Oops!' }} />
+      <ThemedView style={styles.container}>
+        <ThemedText type="title">This screen does not exist.</ThemedText>
+        <Link href="/" style={styles.link}>
+          <ThemedText type="link">Go to home screen!</ThemedText>
+        </Link>
+      </ThemedView>
+    </>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    alignItems: 'center',
+    justifyContent: 'center',
+    padding: 20,
+  },
+  link: {
+    marginTop: 15,
+    paddingVertical: 15,
+  },
+});
--- a/examples/auth/expo-social-auth/app/_layout.tsx
+++ b/examples/auth/expo-social-auth/app/_layout.tsx
@@ -0,0 +1,52 @@
+import { DarkTheme, DefaultTheme, ThemeProvider } from '@react-navigation/native';
+import { useFonts } from 'expo-font';
+import { Stack } from 'expo-router';
+import { StatusBar } from 'expo-status-bar';
+import 'react-native-reanimated';
+
+import { SplashScreenController } from '@/components/splash-screen-controller';
+
+import { useAuthContext } from '@/hooks/use-auth-context';
+import { useColorScheme } from '@/hooks/use-color-scheme';
+import AuthProvider from '@/providers/auth-provider';
+
+// Separate RootNavigator so we can access the AuthContext
+function RootNavigator() {
+  const { isLoggedIn } = useAuthContext();
+
+  return (
+    <Stack>
+      <Stack.Protected guard={isLoggedIn}>
+        <Stack.Screen name="(tabs)" options={{ headerShown: false }} />
+      </Stack.Protected>
+      <Stack.Protected guard={!isLoggedIn}>
+        <Stack.Screen name="login" options={{ headerShown: false }} />
+      </Stack.Protected>
+      <Stack.Screen name="+not-found" />
+    </Stack>
+  );
+}
+
+export default function RootLayout() {
+  const colorScheme = useColorScheme();
+
+  const [loaded] = useFonts({
+    SpaceMono: require('../assets/fonts/SpaceMono-Regular.ttf'),
+  });
+
+  if (!loaded) {
+    // Async font loading only occurs in development.
+    return null;
+  }
+
+  return (
+    <ThemeProvider value={colorScheme === 'dark' ? DarkTheme : DefaultTheme}>
+      <AuthProvider>
+        <SplashScreenController />
+        <RootNavigator />
+        <StatusBar style="auto" />
+      </AuthProvider>
+    </ThemeProvider>
+  );
+}
+  
--- a/examples/auth/expo-social-auth/app/login.tsx
+++ b/examples/auth/expo-social-auth/app/login.tsx
@@ -0,0 +1,56 @@
+import { Link, Stack } from 'expo-router';
+import { Platform, StyleSheet } from 'react-native';
+
+import { ThemedText } from '@/components/themed-text';
+import { ThemedView } from '@/components/themed-view';
+
+import AppleSignInButton from '@/components/social-auth-buttons/apple/apple-sign-in-button';
+import ExpoAppleSignInButton from '@/components/social-auth-buttons/apple/expo-apple-sign-in-button';
+import GoogleSignInButton from '@/components/social-auth-buttons/google/google-sign-in-button';
+import { Image } from 'expo-image';
+
+export default function LoginScreen() {
+  return (
+    <>
+      <Stack.Screen options={{ title: 'Login' }} />
+      <ThemedView style={styles.container}>
+        <Image style={styles.image} source={require('@/assets/supabase-logo-icon.svg')} />
+        <ThemedText type="title">Login</ThemedText>
+        <Link href="/(tabs)/explore" style={styles.link}>
+          <ThemedText type="link">Try to navigate to home screen!</ThemedText>
+        </Link>
+
+        <ThemedView style={styles.socialAuthButtonsContainer}>
+          {Platform.OS === 'ios' && (
+              <>
+              <ThemedText type="default">Invertase Apple Sign In</ThemedText>
+              <AppleSignInButton />
+              <ThemedText type="default">Expo Apple Sign In</ThemedText>
+              <ExpoAppleSignInButton />
+            </>
+          )}
+          {Platform.OS !== 'ios' && (<AppleSignInButton />)}
+          <GoogleSignInButton />
+        </ThemedView>
+      </ThemedView>
+    </>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    alignItems: 'center',
+    justifyContent: 'center',
+    padding: 20,
+    gap: 20,
+  },
+  socialAuthButtonsContainer: {
+    display: 'flex',
+    gap: 10,
+  },
+  image: {
+    width: 100,
+    height: 100,
+  },
+});
--- a/examples/auth/expo-social-auth/assets/fonts/SpaceMono-Regular.ttf
+++ b/examples/auth/expo-social-auth/assets/fonts/SpaceMono-Regular.ttf
--- a/examples/auth/expo-social-auth/assets/images/adaptive-icon.png
+++ b/examples/auth/expo-social-auth/assets/images/adaptive-icon.png
--- a/examples/auth/expo-social-auth/assets/images/favicon.png
+++ b/examples/auth/expo-social-auth/assets/images/favicon.png
--- a/examples/auth/expo-social-auth/assets/images/icon.png
+++ b/examples/auth/expo-social-auth/assets/images/icon.png
--- a/examples/auth/expo-social-auth/assets/images/partial-react-logo.png
+++ b/examples/auth/expo-social-auth/assets/images/partial-react-logo.png
--- a/examples/auth/expo-social-auth/assets/images/react-logo.png
+++ b/examples/auth/expo-social-auth/assets/images/react-logo.png
--- a/examples/auth/expo-social-auth/assets/images/react-logo@2x.png
+++ b/examples/auth/expo-social-auth/assets/images/react-logo@2x.png
--- a/examples/auth/expo-social-auth/assets/images/react-logo@3x.png
+++ b/examples/auth/expo-social-auth/assets/images/react-logo@3x.png
--- a/examples/auth/expo-social-auth/assets/images/splash-icon.png
+++ b/examples/auth/expo-social-auth/assets/images/splash-icon.png
--- a/examples/auth/expo-social-auth/assets/supabase-logo-icon.svg
+++ b/examples/auth/expo-social-auth/assets/supabase-logo-icon.svg
@@ -0,0 +1,15 @@
+<svg width="109" height="113" viewBox="0 0 109 113" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M63.7076 110.284C60.8481 113.885 55.0502 111.912 54.9813 107.314L53.9738 40.0627L99.1935 40.0627C107.384 40.0627 111.952 49.5228 106.859 55.9374L63.7076 110.284Z" fill="url(#paint0_linear)"/>
+<path d="M63.7076 110.284C60.8481 113.885 55.0502 111.912 54.9813 107.314L53.9738 40.0627L99.1935 40.0627C107.384 40.0627 111.952 49.5228 106.859 55.9374L63.7076 110.284Z" fill="url(#paint1_linear)" fill-opacity="0.2"/>
+<path d="M45.317 2.07103C48.1765 -1.53037 53.9745 0.442937 54.0434 5.041L54.4849 72.2922H9.83113C1.64038 72.2922 -2.92775 62.8321 2.1655 56.4175L45.317 2.07103Z" fill="#3ECF8E"/>
+<defs>
+<linearGradient id="paint0_linear" x1="53.9738" y1="54.974" x2="94.1635" y2="71.8295" gradientUnits="userSpaceOnUse">
+<stop stop-color="#249361"/>
+<stop offset="1" stop-color="#3ECF8E"/>
+</linearGradient>
+<linearGradient id="paint1_linear" x1="36.1558" y1="30.578" x2="54.4844" y2="65.0806" gradientUnits="userSpaceOnUse">
+<stop/>
+<stop offset="1" stop-opacity="0"/>
+</linearGradient>
+</defs>
+</svg>
--- a/examples/auth/expo-social-auth/components/collapsible.tsx
+++ b/examples/auth/expo-social-auth/components/collapsible.tsx
@@ -0,0 +1,45 @@
+import { PropsWithChildren, useState } from 'react';
+import { StyleSheet, TouchableOpacity } from 'react-native';
+
+import { ThemedText } from '@/components/themed-text';
+import { ThemedView } from '@/components/themed-view';
+import { IconSymbol } from '@/components/ui/icon-symbol';
+import { Colors } from '@/constants/colors';
+import { useColorScheme } from '@/hooks/use-color-scheme';
+
+export function Collapsible({ children, title }: PropsWithChildren & { title: string }) {
+  const [isOpen, setIsOpen] = useState(false);
+  const theme = useColorScheme() ?? 'light';
+
+  return (
+    <ThemedView>
+      <TouchableOpacity
+        style={styles.heading}
+        onPress={() => setIsOpen((value) => !value)}
+        activeOpacity={0.8}>
+        <IconSymbol
+          name="chevron.right"
+          size={18}
+          weight="medium"
+          color={theme === 'light' ? Colors.light.icon : Colors.dark.icon}
+          style={{ transform: [{ rotate: isOpen ? '90deg' : '0deg' }] }}
+        />
+
+        <ThemedText type="defaultSemiBold">{title}</ThemedText>
+      </TouchableOpacity>
+      {isOpen && <ThemedView style={styles.content}>{children}</ThemedView>}
+    </ThemedView>
+  );
+}
+
+const styles = StyleSheet.create({
+  heading: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    gap: 6,
+  },
+  content: {
+    marginTop: 6,
+    marginLeft: 24,
+  },
+});
--- a/examples/auth/expo-social-auth/components/external-link.tsx
+++ b/examples/auth/expo-social-auth/components/external-link.tsx
@@ -0,0 +1,24 @@
+import { Href, Link } from 'expo-router';
+import { openBrowserAsync } from 'expo-web-browser';
+import { type ComponentProps } from 'react';
+import { Platform } from 'react-native';
+
+type Props = Omit<ComponentProps<typeof Link>, 'href'> & { href: Href & string };
+
+export function ExternalLink({ href, ...rest }: Props) {
+  return (
+    <Link
+      target="_blank"
+      {...rest}
+      href={href}
+      onPress={async (event) => {
+        if (Platform.OS !== 'web') {
+          // Prevent the default behavior of linking to the default browser on native.
+          event.preventDefault();
+          // Open the link in an in-app browser.
+          await openBrowserAsync(href);
+        }
+      }}
+    />
+  );
+}
--- a/examples/auth/expo-social-auth/components/haptic-tab.tsx
+++ b/examples/auth/expo-social-auth/components/haptic-tab.tsx
@@ -0,0 +1,18 @@
+import { BottomTabBarButtonProps } from '@react-navigation/bottom-tabs';
+import { PlatformPressable } from '@react-navigation/elements';
+import * as Haptics from 'expo-haptics';
+
+export function HapticTab(props: BottomTabBarButtonProps) {
+  return (
+    <PlatformPressable
+      {...props}
+      onPressIn={(ev) => {
+        if (process.env.EXPO_OS === 'ios') {
+          // Add a soft haptic feedback when pressing down on the tabs.
+          Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Light);
+        }
+        props.onPressIn?.(ev);
+      }}
+    />
+  );
+}
--- a/examples/auth/expo-social-auth/components/hello-wave.tsx
+++ b/examples/auth/expo-social-auth/components/hello-wave.tsx
@@ -0,0 +1,40 @@
+import { useEffect } from 'react';
+import { StyleSheet } from 'react-native';
+import Animated, {
+  useAnimatedStyle,
+  useSharedValue,
+  withRepeat,
+  withSequence,
+  withTiming,
+} from 'react-native-reanimated';
+
+import { ThemedText } from '@/components/themed-text';
+
+export function HelloWave() {
+  const rotationAnimation = useSharedValue(0);
+
+  useEffect(() => {
+    rotationAnimation.value = withRepeat(
+      withSequence(withTiming(25, { duration: 150 }), withTiming(0, { duration: 150 })),
+      4 // Run the animation 4 times
+    );
+  }, [rotationAnimation]);
+
+  const animatedStyle = useAnimatedStyle(() => ({
+    transform: [{ rotate: `${rotationAnimation.value}deg` }],
+  }));
+
+  return (
+    <Animated.View style={animatedStyle}>
+      <ThemedText style={styles.text}>👋</ThemedText>
+    </Animated.View>
+  );
+}
+
+const styles = StyleSheet.create({
+  text: {
+    fontSize: 28,
+    lineHeight: 32,
+    marginTop: -6,
+  },
+});
--- a/examples/auth/expo-social-auth/components/parallax-scroll-view.tsx
+++ b/examples/auth/expo-social-auth/components/parallax-scroll-view.tsx
@@ -0,0 +1,82 @@
+import type { PropsWithChildren, ReactElement } from 'react';
+import { StyleSheet } from 'react-native';
+import Animated, {
+  interpolate,
+  useAnimatedRef,
+  useAnimatedStyle,
+  useScrollViewOffset,
+} from 'react-native-reanimated';
+
+import { ThemedView } from '@/components/themed-view';
+import { useBottomTabOverflow } from '@/components/ui/tab-bar-background';
+import { useColorScheme } from '@/hooks/use-color-scheme';
+
+const HEADER_HEIGHT = 250;
+
+type Props = PropsWithChildren<{
+  headerImage: ReactElement;
+  headerBackgroundColor: { dark: string; light: string };
+}>;
+
+export default function ParallaxScrollView({
+  children,
+  headerImage,
+  headerBackgroundColor,
+}: Props) {
+  const colorScheme = useColorScheme() ?? 'light';
+  const scrollRef = useAnimatedRef<Animated.ScrollView>();
+  const scrollOffset = useScrollViewOffset(scrollRef);
+  const bottom = useBottomTabOverflow();
+  const headerAnimatedStyle = useAnimatedStyle(() => {
+    return {
+      transform: [
+        {
+          translateY: interpolate(
+            scrollOffset.value,
+            [-HEADER_HEIGHT, 0, HEADER_HEIGHT],
+            [-HEADER_HEIGHT / 2, 0, HEADER_HEIGHT * 0.75]
+          ),
+        },
+        {
+          scale: interpolate(scrollOffset.value, [-HEADER_HEIGHT, 0, HEADER_HEIGHT], [2, 1, 1]),
+        },
+      ],
+    };
+  });
+
+  return (
+    <ThemedView style={styles.container}>
+      <Animated.ScrollView
+        ref={scrollRef}
+        scrollEventThrottle={16}
+        scrollIndicatorInsets={{ bottom }}
+        contentContainerStyle={{ paddingBottom: bottom }}>
+        <Animated.View
+          style={[
+            styles.header,
+            { backgroundColor: headerBackgroundColor[colorScheme] },
+            headerAnimatedStyle,
+          ]}>
+          {headerImage}
+        </Animated.View>
+        <ThemedView style={styles.content}>{children}</ThemedView>
+      </Animated.ScrollView>
+    </ThemedView>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+  },
+  header: {
+    height: HEADER_HEIGHT,
+    overflow: 'hidden',
+  },
+  content: {
+    flex: 1,
+    padding: 32,
+    gap: 16,
+    overflow: 'hidden',
+  },
+});
--- a/examples/auth/expo-social-auth/components/social-auth-buttons/apple/apple-sign-in-button.android.tsx
+++ b/examples/auth/expo-social-auth/components/social-auth-buttons/apple/apple-sign-in-button.android.tsx
@@ -0,0 +1,67 @@
+import { supabase } from '@/lib/supabase';
+import { appleAuthAndroid, AppleButton } from '@invertase/react-native-apple-authentication';
+import { SignInWithIdTokenCredentials } from '@supabase/supabase-js';
+import { Platform } from 'react-native';
+import 'react-native-get-random-values';
+import { v4 as uuid } from 'uuid';
+
+async function onAppleButtonPress() {
+  // Generate secure, random values for state and nonce
+  const rawNonce = uuid();
+  const state = uuid();
+
+  // Configure the request
+  appleAuthAndroid.configure({
+    // The Service ID you registered with Apple
+    clientId: process.env.EXPO_PUBLIC_APPLE_AUTH_SERVICE_ID ?? '',
+
+    // Return URL added to your Apple dev console. We intercept this redirect, but it must still match
+    // the URL you provided to Apple. It can be an empty route on your backend as it's never called.
+    redirectUri: process.env.EXPO_PUBLIC_APPLE_AUTH_REDIRECT_URI ?? '',
+
+    // The type of response requested - code, id_token, or both.
+    responseType: appleAuthAndroid.ResponseType.ALL,
+
+    // The amount of user information requested from Apple.
+    scope: appleAuthAndroid.Scope.ALL,
+
+    // Random nonce value that will be SHA256 hashed before sending to Apple.
+    nonce: rawNonce,
+
+    // Unique state value used to prevent CSRF attacks. A UUID will be generated if nothing is provided.
+    state,
+  });
+
+  // Open the browser window for user sign in
+  const credentialState = await appleAuthAndroid.signIn();
+  console.log('Apple sign in successful:', credentialState)
+
+  if (credentialState.id_token && credentialState.code && credentialState.nonce) {
+    const signInWithIdTokenCredentials: SignInWithIdTokenCredentials = {
+      provider: 'apple',
+      token: credentialState.id_token,
+      nonce: credentialState.nonce,
+      access_token: credentialState.code,
+    }
+
+    const { data, error } = await supabase.auth.signInWithIdToken(signInWithIdTokenCredentials)
+
+    if (error) {
+      console.error('Error signing in with Apple:', error)
+    }
+
+    if (data) {
+      console.log('Apple sign in successful:', data)
+    }
+  }
+}
+
+export default function AppleSignInButton() {
+  if (Platform.OS !== 'android' || appleAuthAndroid.isSupported !== true) { return <></> }
+
+  return <AppleButton
+    buttonStyle={AppleButton.Style.BLACK}
+    buttonType={AppleButton.Type.SIGN_IN}
+    onPress={() => onAppleButtonPress()}
+  />;
+}
--- a/examples/auth/expo-social-auth/components/social-auth-buttons/apple/apple-sign-in-button.ios.tsx
+++ b/examples/auth/expo-social-auth/components/social-auth-buttons/apple/apple-sign-in-button.ios.tsx
@@ -0,0 +1,51 @@
+import { supabase } from '@/lib/supabase';
+import { AppleButton, appleAuth } from '@invertase/react-native-apple-authentication';
+import type { SignInWithIdTokenCredentials } from '@supabase/supabase-js';
+import { router } from 'expo-router';
+import { Platform } from 'react-native';
+
+async function onAppleButtonPress() {
+  // Performs login request
+  const appleAuthRequestResponse = await appleAuth.performRequest({
+    requestedOperation: appleAuth.Operation.LOGIN,
+    // Note: it appears putting FULL_NAME first is important, see issue #293
+    requestedScopes: [appleAuth.Scope.FULL_NAME, appleAuth.Scope.EMAIL],
+  });
+
+  // Get the current authentication state for user
+  // Note: This method must be tested on a real device. On the iOS simulator it always throws an error.
+  const credentialState = await appleAuth.getCredentialStateForUser(appleAuthRequestResponse.user);
+
+  console.log('Apple sign in successful:', { credentialState, appleAuthRequestResponse })
+
+  if (credentialState === appleAuth.State.AUTHORIZED && appleAuthRequestResponse.identityToken && appleAuthRequestResponse.authorizationCode) {
+    const signInWithIdTokenCredentials: SignInWithIdTokenCredentials = {
+      provider: 'apple',
+      token: appleAuthRequestResponse.identityToken,
+      nonce: appleAuthRequestResponse.nonce,
+      access_token: appleAuthRequestResponse.authorizationCode,
+    }
+
+    const { data, error } = await supabase.auth.signInWithIdToken(signInWithIdTokenCredentials)
+
+    if (error) {
+      console.error('Error signing in with Apple:', error)
+    }
+
+    if (data) {
+      console.log('Apple sign in successful:', data)
+      router.navigate('/(tabs)/explore')
+    }
+  }
+}
+
+export default function AppleSignInButton() {
+  if (Platform.OS !== 'ios') { return <></> }
+  
+  return <AppleButton
+    buttonStyle={AppleButton.Style.BLACK}
+    buttonType={AppleButton.Type.SIGN_IN}
+    style={{ width: 160, height: 45 }}
+    onPress={() => onAppleButtonPress()}
+  />;
+}
--- a/examples/auth/expo-social-auth/components/social-auth-buttons/apple/apple-sign-in-button.tsx
+++ b/examples/auth/expo-social-auth/components/social-auth-buttons/apple/apple-sign-in-button.tsx
@@ -0,0 +1,69 @@
+import { supabase } from '@/lib/supabase';
+import type { SignInWithIdTokenCredentials } from '@supabase/supabase-js';
+import { useEffect, useState } from 'react';
+import AppleSignin, { type AppleAuthResponse } from 'react-apple-signin-auth';
+import { Platform } from 'react-native';
+
+/**
+ * This is the Apple sign in button for the web.
+ */
+export default function AppleSignInButton() {
+  const [nonce, setNonce] = useState('');
+  const [sha256Nonce, setSha256Nonce] = useState('');
+  
+  async function onAppleButtonSuccess(appleAuthRequestResponse: AppleAuthResponse) {
+    console.debug('Apple sign in successful:', { appleAuthRequestResponse })
+    if (appleAuthRequestResponse.authorization && appleAuthRequestResponse.authorization.id_token && appleAuthRequestResponse.authorization.code) {
+      const signInWithIdTokenCredentials: SignInWithIdTokenCredentials = {
+        provider: 'apple',
+        token: appleAuthRequestResponse.authorization.id_token,
+        nonce,
+        access_token: appleAuthRequestResponse.authorization.code,
+      }
+
+      const { data, error } = await supabase.auth.signInWithIdToken(signInWithIdTokenCredentials)
+
+      if (error) {
+        console.error('Error signing in with Apple:', error)
+      }
+
+      if (data) {
+        console.log('Apple sign in successful:', data)
+      }
+    }
+  }
+
+  useEffect(() => {
+    function generateNonce(): string {
+      const array = new Uint32Array(1);
+      window.crypto.getRandomValues(array);
+      return array[0].toString();
+    };
+
+    async function generateSha256Nonce(nonce: string): Promise<string> {
+      const buffer = await window.crypto.subtle.digest('sha-256', new TextEncoder().encode(nonce));
+      const array = Array.from(new Uint8Array(buffer));
+      return array.map(b => b.toString(16).padStart(2, '0')).join('');
+    }
+  
+    let nonce = generateNonce();
+    setNonce(nonce);
+    
+    generateSha256Nonce(nonce)
+      .then((sha256Nonce) => { setSha256Nonce(sha256Nonce) });
+  }, []);
+
+  if (Platform.OS !== 'web') { return <></> }
+  
+  return <AppleSignin
+    authOptions={{
+      clientId: process.env.EXPO_PUBLIC_APPLE_AUTH_SERVICE_ID ?? '',
+      redirectURI: process.env.EXPO_PUBLIC_APPLE_AUTH_REDIRECT_URI ?? '',
+      scope: 'email name',
+      state: 'state',
+      nonce: sha256Nonce,
+      usePopup: true,
+    }}
+    onSuccess={onAppleButtonSuccess}
+  />;
+}
--- a/examples/auth/expo-social-auth/components/social-auth-buttons/apple/expo-apple-sign-in-button.tsx
+++ b/examples/auth/expo-social-auth/components/social-auth-buttons/apple/expo-apple-sign-in-button.tsx
@@ -0,0 +1,69 @@
+import { supabase } from '@/lib/supabase';
+import type { SignInWithIdTokenCredentials } from '@supabase/supabase-js';
+import * as AppleAuthentication from 'expo-apple-authentication';
+import { router } from 'expo-router';
+import { Platform, StyleSheet } from 'react-native';
+
+async function onAppleButtonPress() {
+  // Performs login request
+  try {
+    const appleAuthRequestResponse = await AppleAuthentication.signInAsync({
+      requestedScopes: [
+        AppleAuthentication.AppleAuthenticationScope.FULL_NAME,
+        AppleAuthentication.AppleAuthenticationScope.EMAIL,
+      ],
+    });
+    
+    console.log('Apple sign in successful:', { appleAuthRequestResponse })
+    
+    if (appleAuthRequestResponse.identityToken && appleAuthRequestResponse.authorizationCode) {
+      const signInWithIdTokenCredentials: SignInWithIdTokenCredentials = {
+        provider: 'apple',
+        token: appleAuthRequestResponse.identityToken,
+        access_token: appleAuthRequestResponse.authorizationCode,
+      }
+  
+      const { data, error } = await supabase.auth.signInWithIdToken(signInWithIdTokenCredentials)
+  
+      if (error) {
+        console.error('Error signing in with Apple:', error)
+      }
+  
+      if (data) {
+        console.log('Apple sign in successful:', data)
+        router.navigate('/(tabs)/explore')
+      }
+    }
+
+  } catch (e: any) {
+    if (e.code === 'ERR_REQUEST_CANCELED') {
+      console.error('Error signing in with Apple:', e)
+    } else {
+      console.error('Error signing in with Apple:', e)
+    }
+  }
+}
+
+export default function ExpoAppleSignInButton() {
+  if (Platform.OS !== 'ios') { return <></> }
+  
+  return <AppleAuthentication.AppleAuthenticationButton
+    buttonType={AppleAuthentication.AppleAuthenticationButtonType.SIGN_IN}
+    buttonStyle={AppleAuthentication.AppleAuthenticationButtonStyle.BLACK}
+    cornerRadius={5}
+    style={styles.button}
+    onPress={() => onAppleButtonPress()}
+  />
+}
+
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    alignItems: 'center',
+    justifyContent: 'center',
+  },
+  button: {
+    width: 160, height: 45
+  },
+});
--- a/examples/auth/expo-social-auth/components/social-auth-buttons/google/google-sign-in-button.tsx
+++ b/examples/auth/expo-social-auth/components/social-auth-buttons/google/google-sign-in-button.tsx
@@ -0,0 +1,126 @@
+import { supabase } from '@/lib/supabase';
+import { useEffect } from 'react';
+import { TouchableOpacity } from 'react-native';
+
+import { expo } from '@/app.json';
+import { Text } from '@react-navigation/elements';
+import { Image } from 'expo-image';
+import * as WebBrowser from "expo-web-browser";
+
+WebBrowser.maybeCompleteAuthSession();
+
+export default function GoogleSignInButton() {
+
+  function extractParamsFromUrl(url: string) {
+    const parsedUrl = new URL(url);
+    const hash = parsedUrl.hash.substring(1); // Remove the leading '#'
+    const params = new URLSearchParams(hash);
+  
+    return {
+      access_token: params.get("access_token"),
+      expires_in: parseInt(params.get("expires_in") || "0"),
+      refresh_token: params.get("refresh_token"),
+      token_type: params.get("token_type"),
+      provider_token: params.get("provider_token"),
+      code: params.get("code"),
+    };
+  };
+  
+  async function onSignInButtonPress() {
+    console.debug('onSignInButtonPress - start');
+    const res = await supabase.auth.signInWithOAuth({
+      provider: "google",
+      options: {
+        redirectTo: `${expo.scheme}://google-auth`,
+        queryParams: { prompt: "consent" },
+        skipBrowserRedirect: true,
+      },
+    });
+
+    const googleOAuthUrl = res.data.url;
+
+    if (!googleOAuthUrl) { 
+      console.error("no oauth url found!");
+      return;
+    }
+
+    const result = await WebBrowser.openAuthSessionAsync(
+      googleOAuthUrl,
+      `${expo.scheme}://google-auth`,
+      { showInRecents: true },
+    ).catch((err) => {
+      console.error('onSignInButtonPress - openAuthSessionAsync - error', { err })
+      console.log(err);
+    });
+
+    console.debug('onSignInButtonPress - openAuthSessionAsync - result', { result });
+
+    if (result && result.type === "success") {
+      console.debug('onSignInButtonPress - openAuthSessionAsync - success');
+      const params = extractParamsFromUrl(result.url);
+      console.debug('onSignInButtonPress - openAuthSessionAsync - success', { params });
+
+      if (params.access_token && params.refresh_token) {
+        console.debug('onSignInButtonPress - setSession');
+        const { data, error } = await supabase.auth.setSession({
+          access_token: params.access_token,
+          refresh_token: params.refresh_token,
+        });
+        console.debug('onSignInButtonPress - setSession - success', { data, error });
+        return;
+      } else {
+        console.error('onSignInButtonPress - setSession - failed');
+        // sign in/up failed
+      }
+    } else {
+      console.error('onSignInButtonPress - openAuthSessionAsync - failed');
+    }
+  }
+
+  // to warm up the browser
+  useEffect(() => {
+    WebBrowser.warmUpAsync();
+
+    return () => {
+      WebBrowser.coolDownAsync();
+    };
+  }, []);
+
+  return (
+    <TouchableOpacity
+      onPress={onSignInButtonPress}
+      style={{
+        flexDirection: 'row',
+        alignItems: 'center',
+        backgroundColor: '#ffffff',
+        borderWidth: 1,
+        borderColor: '#dbdbdb',
+        borderRadius: 4,
+        paddingVertical: 10,
+        paddingHorizontal: 15,
+        justifyContent: 'center',
+        shadowColor: '#000',
+        shadowOffset: { width: 0, height: 1 },
+        shadowOpacity: 0.1,
+        shadowRadius: 2,
+        elevation: 2, // For Android shadow
+      }}
+      activeOpacity={0.8}
+    >
+      <Image
+        source={{ uri: 'https://developers.google.com/identity/images/g-logo.png' }}
+        style={{ width: 24, height: 24, marginRight: 10 }}
+      />
+      <Text
+        style={{
+          fontSize: 16,
+          color: '#757575',
+          fontFamily: 'Roboto-Regular', // Assuming Roboto is available; install via expo-google-fonts or similar if needed
+          fontWeight: '500',
+        }}
+      >
+        Sign in with Google
+      </Text>
+    </TouchableOpacity>
+  );
+}
--- a/examples/auth/expo-social-auth/components/social-auth-buttons/google/google-sign-in-button.web.tsx
+++ b/examples/auth/expo-social-auth/components/social-auth-buttons/google/google-sign-in-button.web.tsx
@@ -0,0 +1,73 @@
+import { supabase } from '@/lib/supabase';
+import { CredentialResponse, GoogleLogin, GoogleOAuthProvider } from '@react-oauth/google';
+import { SignInWithIdTokenCredentials } from '@supabase/supabase-js';
+import { useEffect, useState } from 'react';
+
+import 'react-native-get-random-values';
+
+export default function GoogleSignInButton() {
+
+  // Generate secure, random values for state and nonce
+  const [nonce, setNonce] = useState('');
+  const [sha256Nonce, setSha256Nonce] = useState('');
+
+  async function onGoogleButtonSuccess(authRequestResponse: CredentialResponse) {
+    console.debug('Google sign in successful:', { authRequestResponse })
+    if (authRequestResponse.clientId && authRequestResponse.credential) {
+      const signInWithIdTokenCredentials: SignInWithIdTokenCredentials = {
+        provider: 'google',
+        token: authRequestResponse.credential,
+        nonce: nonce,
+      }
+
+      const { data, error } = await supabase.auth.signInWithIdToken(signInWithIdTokenCredentials)
+
+      if (error) {
+        console.error('Error signing in with Google:', error)
+      }
+
+      if (data) {
+        console.log('Google sign in successful:', data)
+      }
+    }
+  }
+
+  function onGoogleButtonFailure() {
+    console.error('Error signing in with Google')
+  }
+
+  useEffect(() => {
+    function generateNonce(): string {
+      const array = new Uint32Array(1);
+      window.crypto.getRandomValues(array);
+      return array[0].toString();
+    };
+
+    async function generateSha256Nonce(nonce: string): Promise<string> {
+      const buffer = await window.crypto.subtle.digest('sha-256', new TextEncoder().encode(nonce));
+      const array = Array.from(new Uint8Array(buffer));
+      return array.map(b => b.toString(16).padStart(2, '0')).join('');
+    }
+
+    let nonce = generateNonce();
+    setNonce(nonce);
+
+    generateSha256Nonce(nonce)
+      .then((sha256Nonce) => { setSha256Nonce(sha256Nonce) });
+  }, []);
+
+  return (
+    <GoogleOAuthProvider
+      clientId={process.env.EXPO_PUBLIC_GOOGLE_AUTH_WEB_CLIENT_ID ?? ''}
+      nonce={sha256Nonce}
+    >
+      <GoogleLogin
+        nonce={sha256Nonce}
+        onSuccess={onGoogleButtonSuccess}
+        onError={onGoogleButtonFailure}
+        useOneTap={true}
+        auto_select={true}
+      />
+    </GoogleOAuthProvider>
+  );
+}
--- a/examples/auth/expo-social-auth/components/social-auth-buttons/sign-out-button.tsx
+++ b/examples/auth/expo-social-auth/components/social-auth-buttons/sign-out-button.tsx
@@ -0,0 +1,24 @@
+import { useAuthContext } from '@/hooks/use-auth-context';
+import { supabase } from '@/lib/supabase';
+import React from 'react';
+import { Button } from 'react-native';
+
+async function onSignOutButtonPress() {
+ const { error } = await supabase.auth.signOut()
+
+ if (error) {
+   console.error('Error signing out:', error)
+ }
+}
+
+export default function SignOutButton() {
+  const { isLoggedIn } = useAuthContext();
+
+  return (
+    <Button
+      disabled={!isLoggedIn}
+      title="Sign out"
+      onPress={onSignOutButtonPress}
+    />
+  );
+}
--- a/examples/auth/expo-social-auth/components/splash-screen-controller.tsx
+++ b/examples/auth/expo-social-auth/components/splash-screen-controller.tsx
@@ -0,0 +1,15 @@
+import { useAuthContext } from '@/hooks/use-auth-context';
+import { SplashScreen } from 'expo-router';
+
+SplashScreen.preventAutoHideAsync();
+
+export function SplashScreenController() {
+  const { isLoading } = useAuthContext();
+
+  if (!isLoading) {
+    console.log('SplashScreenController - Hiding splash screen');
+    SplashScreen.hideAsync();
+  }
+
+  return null;
+}
--- a/examples/auth/expo-social-auth/components/themed-text.tsx
+++ b/examples/auth/expo-social-auth/components/themed-text.tsx
@@ -0,0 +1,60 @@
+import { StyleSheet, Text, type TextProps } from 'react-native';
+
+import { useThemeColor } from '@/hooks/use-theme-color';
+
+export type ThemedTextProps = TextProps & {
+  lightColor?: string;
+  darkColor?: string;
+  type?: 'default' | 'title' | 'defaultSemiBold' | 'subtitle' | 'link';
+};
+
+export function ThemedText({
+  style,
+  lightColor,
+  darkColor,
+  type = 'default',
+  ...rest
+}: ThemedTextProps) {
+  const color = useThemeColor({ light: lightColor, dark: darkColor }, 'text');
+
+  return (
+    <Text
+      style={[
+        { color },
+        type === 'default' ? styles.default : undefined,
+        type === 'title' ? styles.title : undefined,
+        type === 'defaultSemiBold' ? styles.defaultSemiBold : undefined,
+        type === 'subtitle' ? styles.subtitle : undefined,
+        type === 'link' ? styles.link : undefined,
+        style,
+      ]}
+      {...rest}
+    />
+  );
+}
+
+const styles = StyleSheet.create({
+  default: {
+    fontSize: 16,
+    lineHeight: 24,
+  },
+  defaultSemiBold: {
+    fontSize: 16,
+    lineHeight: 24,
+    fontWeight: '600',
+  },
+  title: {
+    fontSize: 32,
+    fontWeight: 'bold',
+    lineHeight: 32,
+  },
+  subtitle: {
+    fontSize: 20,
+    fontWeight: 'bold',
+  },
+  link: {
+    lineHeight: 30,
+    fontSize: 16,
+    color: '#0a7ea4',
+  },
+});
--- a/examples/auth/expo-social-auth/components/themed-view.tsx
+++ b/examples/auth/expo-social-auth/components/themed-view.tsx
@@ -0,0 +1,14 @@
+import { View, type ViewProps } from 'react-native';
+
+import { useThemeColor } from '@/hooks/use-theme-color';
+
+export type ThemedViewProps = ViewProps & {
+  lightColor?: string;
+  darkColor?: string;
+};
+
+export function ThemedView({ style, lightColor, darkColor, ...otherProps }: ThemedViewProps) {
+  const backgroundColor = useThemeColor({ light: lightColor, dark: darkColor }, 'background');
+
+  return <View style={[{ backgroundColor }, style]} {...otherProps} />;
+}
--- a/examples/auth/expo-social-auth/components/ui/icon-symbol.ios.tsx
+++ b/examples/auth/expo-social-auth/components/ui/icon-symbol.ios.tsx
@@ -0,0 +1,32 @@
+import { SymbolView, SymbolViewProps, SymbolWeight } from 'expo-symbols';
+import { StyleProp, ViewStyle } from 'react-native';
+
+export function IconSymbol({
+  name,
+  size = 24,
+  color,
+  style,
+  weight = 'regular',
+}: {
+  name: SymbolViewProps['name'];
+  size?: number;
+  color: string;
+  style?: StyleProp<ViewStyle>;
+  weight?: SymbolWeight;
+}) {
+  return (
+    <SymbolView
+      weight={weight}
+      tintColor={color}
+      resizeMode="scaleAspectFit"
+      name={name}
+      style={[
+        {
+          width: size,
+          height: size,
+        },
+        style,
+      ]}
+    />
+  );
+}
--- a/examples/auth/expo-social-auth/components/ui/icon-symbol.tsx
+++ b/examples/auth/expo-social-auth/components/ui/icon-symbol.tsx
@@ -0,0 +1,41 @@
+// Fallback for using MaterialIcons on Android and web.
+
+import MaterialIcons from '@expo/vector-icons/MaterialIcons';
+import { SymbolWeight, SymbolViewProps } from 'expo-symbols';
+import { ComponentProps } from 'react';
+import { OpaqueColorValue, type StyleProp, type TextStyle } from 'react-native';
+
+type IconMapping = Record<SymbolViewProps['name'], ComponentProps<typeof MaterialIcons>['name']>;
+type IconSymbolName = keyof typeof MAPPING;
+
+/**
+ * Add your SF Symbols to Material Icons mappings here.
+ * - see Material Icons in the [Icons Directory](https://icons.expo.fyi).
+ * - see SF Symbols in the [SF Symbols](https://developer.apple.com/sf-symbols/) app.
+ */
+const MAPPING = {
+  'house.fill': 'home',
+  'paperplane.fill': 'send',
+  'chevron.left.forwardslash.chevron.right': 'code',
+  'chevron.right': 'chevron-right',
+} as IconMapping;
+
+/**
+ * An icon component that uses native SF Symbols on iOS, and Material Icons on Android and web.
+ * This ensures a consistent look across platforms, and optimal resource usage.
+ * Icon `name`s are based on SF Symbols and require manual mapping to Material Icons.
+ */
+export function IconSymbol({
+  name,
+  size = 24,
+  color,
+  style,
+}: {
+  name: IconSymbolName;
+  size?: number;
+  color: string | OpaqueColorValue;
+  style?: StyleProp<TextStyle>;
+  weight?: SymbolWeight;
+}) {
+  return <MaterialIcons color={color} size={size} name={MAPPING[name]} style={style} />;
+}
--- a/examples/auth/expo-social-auth/components/ui/tab-bar-background.ios.tsx
+++ b/examples/auth/expo-social-auth/components/ui/tab-bar-background.ios.tsx
@@ -0,0 +1,19 @@
+import { useBottomTabBarHeight } from '@react-navigation/bottom-tabs';
+import { BlurView } from 'expo-blur';
+import { StyleSheet } from 'react-native';
+
+export default function BlurTabBarBackground() {
+  return (
+    <BlurView
+      // System chrome material automatically adapts to the system's theme
+      // and matches the native tab bar appearance on iOS.
+      tint="systemChromeMaterial"
+      intensity={100}
+      style={StyleSheet.absoluteFill}
+    />
+  );
+}
+
+export function useBottomTabOverflow() {
+  return useBottomTabBarHeight();
+}
--- a/examples/auth/expo-social-auth/components/ui/tab-bar-background.tsx
+++ b/examples/auth/expo-social-auth/components/ui/tab-bar-background.tsx
@@ -0,0 +1,6 @@
+// This is a shim for web and Android where the tab bar is generally opaque.
+export default undefined;
+
+export function useBottomTabOverflow() {
+  return 0;
+}
--- a/examples/auth/expo-social-auth/constants/colors.ts
+++ b/examples/auth/expo-social-auth/constants/colors.ts
@@ -0,0 +1,26 @@
+/**
+ * Below are the colors that are used in the app. The colors are defined in the light and dark mode.
+ * There are many other ways to style your app. For example, [Nativewind](https://www.nativewind.dev/), [Tamagui](https://tamagui.dev/), [unistyles](https://reactnativeunistyles.vercel.app), etc.
+ */
+
+const tintColorLight = '#0a7ea4';
+const tintColorDark = '#fff';
+
+export const Colors = {
+  light: {
+    text: '#11181C',
+    background: '#fff',
+    tint: tintColorLight,
+    icon: '#687076',
+    tabIconDefault: '#687076',
+    tabIconSelected: tintColorLight,
+  },
+  dark: {
+    text: '#ECEDEE',
+    background: '#151718',
+    tint: tintColorDark,
+    icon: '#9BA1A6',
+    tabIconDefault: '#9BA1A6',
+    tabIconSelected: tintColorDark,
+  },
+};
--- a/examples/auth/expo-social-auth/eslint.config.js
+++ b/examples/auth/expo-social-auth/eslint.config.js
@@ -0,0 +1,10 @@
+// https://docs.expo.dev/guides/using-eslint/
+const { defineConfig } = require('eslint/config');
+const expoConfig = require('eslint-config-expo/flat');
+
+module.exports = defineConfig([
+  expoConfig,
+  {
+    ignores: ['dist/*'],
+  },
+]);
--- a/examples/auth/expo-social-auth/hooks/use-auth-context.ts
+++ b/examples/auth/expo-social-auth/hooks/use-auth-context.ts
@@ -0,0 +1,18 @@
+import { Session } from '@supabase/supabase-js'
+import { createContext, useContext } from 'react'
+
+export type AuthData = {
+  session?: Session | null
+  profile?: any | null
+  isLoading: boolean
+  isLoggedIn: boolean
+}
+
+export const AuthContext = createContext<AuthData>({
+  session: undefined,
+  profile: undefined,
+  isLoading: true,
+  isLoggedIn: false
+})
+
+export const useAuthContext = () => useContext(AuthContext)
--- a/examples/auth/expo-social-auth/hooks/use-color-scheme.ts
+++ b/examples/auth/expo-social-auth/hooks/use-color-scheme.ts
@@ -0,0 +1 @@
+export { useColorScheme } from 'react-native';
--- a/examples/auth/expo-social-auth/hooks/use-color-scheme.web.ts
+++ b/examples/auth/expo-social-auth/hooks/use-color-scheme.web.ts
@@ -0,0 +1,21 @@
+import { useEffect, useState } from 'react';
+import { useColorScheme as useRNColorScheme } from 'react-native';
+
+/**
+ * To support static rendering, this value needs to be re-calculated on the client side for web
+ */
+export function useColorScheme() {
+  const [hasHydrated, setHasHydrated] = useState(false);
+
+  useEffect(() => {
+    setHasHydrated(true);
+  }, []);
+
+  const colorScheme = useRNColorScheme();
+
+  if (hasHydrated) {
+    return colorScheme;
+  }
+
+  return 'light';
+}
--- a/examples/auth/expo-social-auth/hooks/use-theme-color.ts
+++ b/examples/auth/expo-social-auth/hooks/use-theme-color.ts
@@ -0,0 +1,21 @@
+/**
+ * Learn more about light and dark modes:
+ * https://docs.expo.dev/guides/color-schemes/
+ */
+
+import { Colors } from '@/constants/colors';
+import { useColorScheme } from '@/hooks/use-color-scheme';
+
+export function useThemeColor(
+  props: { light?: string; dark?: string },
+  colorName: keyof typeof Colors.light & keyof typeof Colors.dark
+) {
+  const theme = useColorScheme() ?? 'light';
+  const colorFromProps = props[theme];
+
+  if (colorFromProps) {
+    return colorFromProps;
+  } else {
+    return Colors[theme][colorName];
+  }
+}
--- a/examples/auth/expo-social-auth/lib/supabase.ts
+++ b/examples/auth/expo-social-auth/lib/supabase.ts
@@ -0,0 +1,31 @@
+import { createClient } from '@supabase/supabase-js';
+import { deleteItemAsync, getItemAsync, setItemAsync } from 'expo-secure-store';
+
+const ExpoSecureStoreAdapter = {
+  getItem: (key: string) => {
+    console.debug("getItem", { key, getItemAsync })
+    return getItemAsync(key)
+  },
+  setItem: (key: string, value: string) => {
+    if (value.length > 2048) {
+      console.warn('Value being stored in SecureStore is larger than 2048 bytes and it may not be stored successfully. In a future SDK version, this call may throw an error.')
+    }
+    return setItemAsync(key, value)
+  },
+  removeItem: (key: string) => {
+    return deleteItemAsync(key)
+  },
+}
+
+export const supabase = createClient(
+  process.env.EXPO_PUBLIC_SUPABASE_URL ?? '',
+  process.env.EXPO_PUBLIC_SUPABASE_ANON_KEY ?? '',
+  {
+    auth: {
+      storage: ExpoSecureStoreAdapter as any,
+      autoRefreshToken: true,
+      persistSession: true,
+      detectSessionInUrl: false,
+    },
+  },
+);
--- a/examples/auth/expo-social-auth/lib/supabase.web.ts
+++ b/examples/auth/expo-social-auth/lib/supabase.web.ts
@@ -0,0 +1,29 @@
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { createClient } from '@supabase/supabase-js';
+import 'react-native-url-polyfill/auto';
+
+const ExpoWebSecureStoreAdapter = {
+  getItem: (key: string) => {
+    console.debug("getItem", { key })
+    return AsyncStorage.getItem(key)
+  },
+  setItem: (key: string, value: string) => {
+    return AsyncStorage.setItem(key, value)
+  },
+  removeItem: (key: string) => {
+    return AsyncStorage.removeItem(key)
+  },
+}
+
+export const supabase = createClient(
+  process.env.EXPO_PUBLIC_SUPABASE_URL ?? '',
+  process.env.EXPO_PUBLIC_SUPABASE_ANON_KEY ?? '',
+  {
+    auth: {
+      storage: ExpoWebSecureStoreAdapter,
+      autoRefreshToken: true,
+      persistSession: true,
+      detectSessionInUrl: false,
+    },
+  },
+);
--- a/examples/auth/expo-social-auth/package-lock.json
+++ b/examples/auth/expo-social-auth/package-lock.json
--- a/examples/auth/expo-social-auth/package.json
+++ b/examples/auth/expo-social-auth/package.json
@@ -0,0 +1,60 @@
+{
+  "name": "expo-social-auth",
+  "main": "expo-router/entry",
+  "version": "1.0.0",
+  "scripts": {
+    "start": "expo start",
+    "reset-project": "node ./scripts/reset-project.js",
+    "android": "expo start --android",
+    "ios": "expo start --ios",
+    "web": "expo start --web",
+    "lint": "expo lint"
+  },
+  "dependencies": {
+    "@expo/vector-icons": "^15.0.2",
+    "@invertase/react-native-apple-authentication": "^2.4.1",
+    "@react-native-async-storage/async-storage": "2.2.0",
+    "@react-navigation/bottom-tabs": "^7.4.0",
+    "@react-navigation/elements": "^2.6.3",
+    "@react-navigation/native": "^7.1.8",
+    "@react-oauth/google": "^0.12.2",
+    "@supabase/supabase-js": "^2.57.4",
+    "expo-apple-authentication": "~7.2.4",
+    "expo-blur": "~14.1.5",
+    "expo-constants": "~18.0.8",
+    "expo-font": "~14.0.8",
+    "expo-haptics": "~15.0.7",
+    "expo-image": "~3.0.8",
+    "expo-linking": "~8.0.8",
+    "expo-router": "~6.0.1",
+    "expo-secure-store": "~14.2.4",
+    "expo-splash-screen": "~31.0.9",
+    "expo-status-bar": "~3.0.8",
+    "expo-symbols": "~1.0.7",
+    "expo-system-ui": "~6.0.7",
+    "expo-web-browser": "~15.0.7",
+    "expo": "~54.0.2",
+    "react-apple-signin-auth": "^1.1.2",
+    "react-dom": "19.1.0",
+    "react-native-gesture-handler": "~2.28.0",
+    "react-native-get-random-values": "~1.11.0",
+    "react-native-reanimated": "~4.1.0",
+    "react-native-safe-area-context": "~5.6.0",
+    "react-native-screens": "~4.16.0",
+    "react-native-url-polyfill": "^2.0.0",
+    "react-native-web": "~0.21.0",
+    "react-native-webview": "13.16.0",
+    "react-native-worklets": "0.5.1",
+    "react-native": "0.81.4",
+    "react": "19.1.0",
+    "uuid": "^11.1.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.28.4",
+    "@types/react": "~19.1.0",
+    "eslint-config-expo": "~10.0.0",
+    "eslint": "^9.25.0",
+    "typescript": "~5.9.2"
+  },
+  "private": true
+}
--- a/examples/auth/expo-social-auth/providers/auth-provider.tsx
+++ b/examples/auth/expo-social-auth/providers/auth-provider.tsx
@@ -0,0 +1,74 @@
+import { AuthContext } from '@/hooks/use-auth-context'
+import { supabase } from '@/lib/supabase'
+import type { Session } from '@supabase/supabase-js'
+import { PropsWithChildren, useEffect, useState } from 'react'
+
+export default function AuthProvider({ children }: PropsWithChildren) {
+  const [session, setSession] = useState<Session | undefined | null>()
+  const [profile, setProfile] = useState<any>()
+  const [isLoading, setIsLoading] = useState<boolean>(true)
+
+  // Fetch the session once, and subscribe to auth state changes
+  useEffect(() => {
+    const fetchSession = async () => {
+      setIsLoading(true)
+  
+      const { data: { session }, error } = await supabase.auth.getSession()
+
+      if (error) {
+        console.error('Error fetching session:', error)
+      }
+
+      setSession(session)
+      setIsLoading(false)
+    }
+
+    fetchSession()
+
+    const { data: { subscription } } = supabase.auth.onAuthStateChange((_event, session) => {
+      console.log('Auth state changed:', { event: _event, session })
+      setSession(session)
+    })
+
+    // Cleanup subscription on unmount
+    return () => {
+      subscription.unsubscribe()
+    }
+  }, [])
+
+  // Fetch the profile when the session changes
+  useEffect(() => {
+    const fetchProfile = async () => {
+      setIsLoading(true)
+
+      if (session) {
+        const { data } = await supabase
+          .from('profiles')
+          .select('*')
+          .eq('id', session.user.id)
+          .single()
+
+        setProfile(data)
+      } else {
+        setProfile(null)
+      }
+
+      setIsLoading(false)
+    }
+
+    fetchProfile()
+  }, [session])
+
+  return (
+    <AuthContext.Provider
+      value={{
+        session,
+        isLoading,
+        profile,
+        isLoggedIn: session != undefined
+      }}
+    >
+      {children}
+    </AuthContext.Provider>
+  )
+}
--- a/examples/auth/expo-social-auth/scripts/reset-project.js
+++ b/examples/auth/expo-social-auth/scripts/reset-project.js
@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+
+/**
+ * This script is used to reset the project to a blank state.
+ * It deletes or moves the /app, /components, /hooks, /scripts, and /constants directories to /app-example based on user input and creates a new /app directory with an index.tsx and _layout.tsx file.
+ * You can remove the `reset-project` script from package.json and safely delete this file after running it.
+ */
+
+const fs = require("fs");
+const path = require("path");
+const readline = require("readline");
+
+const root = process.cwd();
+const oldDirs = ["app", "components", "hooks", "constants", "scripts"];
+const exampleDir = "app-example";
+const newAppDir = "app";
+const exampleDirPath = path.join(root, exampleDir);
+
+const indexContent = `import { Text, View } from "react-native";
+
+export default function Index() {
+  return (
+    <View
+      style={{
+        flex: 1,
+        justifyContent: "center",
+        alignItems: "center",
+      }}
+    >
+      <Text>Edit app/index.tsx to edit this screen.</Text>
+    </View>
+  );
+}
+`;
+
+const layoutContent = `import { Stack } from "expo-router";
+
+export default function RootLayout() {
+  return <Stack />;
+}
+`;
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+const moveDirectories = async (userInput) => {
+  try {
+    if (userInput === "y") {
+      // Create the app-example directory
+      await fs.promises.mkdir(exampleDirPath, { recursive: true });
+      console.log(`📁 /${exampleDir} directory created.`);
+    }
+
+    // Move old directories to new app-example directory or delete them
+    for (const dir of oldDirs) {
+      const oldDirPath = path.join(root, dir);
+      if (fs.existsSync(oldDirPath)) {
+        if (userInput === "y") {
+          const newDirPath = path.join(root, exampleDir, dir);
+          await fs.promises.rename(oldDirPath, newDirPath);
+          console.log(`➡️ /${dir} moved to /${exampleDir}/${dir}.`);
+        } else {
+          await fs.promises.rm(oldDirPath, { recursive: true, force: true });
+          console.log(`❌ /${dir} deleted.`);
+        }
+      } else {
+        console.log(`➡️ /${dir} does not exist, skipping.`);
+      }
+    }
+
+    // Create new /app directory
+    const newAppDirPath = path.join(root, newAppDir);
+    await fs.promises.mkdir(newAppDirPath, { recursive: true });
+    console.log("\n📁 New /app directory created.");
+
+    // Create index.tsx
+    const indexPath = path.join(newAppDirPath, "index.tsx");
+    await fs.promises.writeFile(indexPath, indexContent);
+    console.log("📄 app/index.tsx created.");
+
+    // Create _layout.tsx
+    const layoutPath = path.join(newAppDirPath, "_layout.tsx");
+    await fs.promises.writeFile(layoutPath, layoutContent);
+    console.log("📄 app/_layout.tsx created.");
+
+    console.log("\n✅ Project reset complete. Next steps:");
+    console.log(
+      `1. Run \`npx expo start\` to start a development server.\n2. Edit app/index.tsx to edit the main screen.${
+        userInput === "y"
+          ? `\n3. Delete the /${exampleDir} directory when you're done referencing it.`
+          : ""
+      }`
+    );
+  } catch (error) {
+    console.error(`❌ Error during script execution: ${error.message}`);
+  }
+};
+
+rl.question(
+  "Do you want to move existing files to /app-example instead of deleting them? (Y/n): ",
+  (answer) => {
+    const userInput = answer.trim().toLowerCase() || "y";
+    if (userInput === "y" || userInput === "n") {
+      moveDirectories(userInput).finally(() => rl.close());
+    } else {
+      console.log("❌ Invalid input. Please enter 'Y' or 'N'.");
+      rl.close();
+    }
+  }
+);
--- a/examples/auth/expo-social-auth/tsconfig.json
+++ b/examples/auth/expo-social-auth/tsconfig.json
@@ -0,0 +1,17 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "strict": true,
+    "paths": {
+      "@/*": [
+        "./*"
+      ]
+    }
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    ".expo/types/**/*.ts",
+    "expo-env.d.ts"
+  ]
+}
--- a/supa-mdx-lint/Rule003Spelling.toml
+++ b/supa-mdx-lint/Rule003Spelling.toml
@@ -278,6 +278,7 @@ allow_list = [
    "TextLocal",
    "TimescaleDB",
    "Transformers.js",
+    "[Tt]unneled",
    "Twilio",
    "Undici",
    "UnionPay",
				`@@ -0,0 +1 @@`
				`export { useColorScheme } from 'react-native';`