---
title: "@xid-kit/expo"
description: "Expo-SecureStore- und WebBrowser-Adapter für @xid-kit/react-native sowieein Expo-Router-Route-Guard-Hook."
locale: "de"
---

> Documentation Index
> Fetch the locale documentation index at: https://xid.dev/de/llms.txt
> Use this file to discover all available pages before exploring further.

# @xid-kit/expo

## Zustand

Paketstatus: **Aktuelles Paket**. Expo-SecureStore- undWebBrowser-Adapter, XidProvider und Expo-Router-Route-Guard-Hook sindimplementiert. Ein echter IdP-Round-Trip auf Produktionsinfrastruktursteht noch manuell aus.

Gesamte PKCE-Logik, Token-Tausch und Sitzungsverwaltung liegen in[@xid-kit/react-native](/de/sdks/react-native); dieses Paket stellt nur Adapter und dieExpo-Router-Integration bereit.

## Anbieter-Einrichtung

Injizieren Sie `createSecureStoreAdapter` und`createExpoWebBrowserAdapter` in `XidProvider`. Es ist keinTop-Level-Expo-Modulimport erforderlich; Adapter akzeptierenModulinstanzen, damit der CI-Typecheck ohne installierte Expo-Peer-Depssauber bleibt.

```tsx
import * as SecureStore from 'expo-secure-store'
import * as WebBrowser from 'expo-web-browser'
import { XidProvider, createSecureStoreAdapter, createExpoWebBrowserAdapter } from '@xid-kit/expo'

const tokenCache = createSecureStoreAdapter({ secureStore: SecureStore })
const browser = createExpoWebBrowserAdapter({ webBrowser: WebBrowser })

export default function App() {
  return (
<XidProvider
  publishableKey="pk_live_..."
  issuer="https://xid.dev"
  clientId="your_client_id"
  redirectUri="myapp://auth/callback"
  tokenCache={tokenCache}
  browser={browser}
>
  <RootLayout />
</XidProvider>
  )
}
```

## Anmelden und abmelden

```tsx
import { useSignIn, useSignOut } from '@xid-kit/expo'
import { Button } from 'react-native'

function SignInScreen() {
  const { signIn, signInState } = useSignIn()
  return (
<Button
  title={signInState.status === 'pending' ? 'Signing in...' : 'Sign In'}
  onPress={() => void signIn()}
/>
  )
}

function SignOutScreen() {
  const { signOut } = useSignOut()
  return <Button title="Sign Out" onPress={() => void signOut()} />
}
```

## Expo-Router-Route-Guard

Rufen Sie `useProtectedRoute` in einer Layout-Komponente auf. Esliest `isLoaded`/`isSignedIn` aus `useAuth` und ruft`replace` von Expo Router innerhalb eines `useEffect` auf.

```tsx
import { useProtectedRoute } from '@xid-kit/expo'
import { useRouter, usePathname } from 'expo-router'

export default function RootLayout() {
  const router = useRouter()
  const pathname = usePathname()

  useProtectedRoute({
signInRoute: '/sign-in',
protectedRoute: '/(app)',
pathname,
replace: router.replace,
  })

  return <Slot />
}
```

## SecureStore-Schlüssel-Namensgebung

Verwenden Sie `keyPrefix`, um Schlüssel unter einembenutzerdefinierten Prefix einzuordnen. Das Trennzeichen ist `.`(Punkt), das im erlaubten Zeichensatz von `expo-secure-store`enthalten ist.

```ts
const tokenCache = createSecureStoreAdapter({
  secureStore: SecureStore,
  keyPrefix: 'myapp',
  // keys: 'myapp.xid.access_token', 'myapp.xid.refresh_token', etc.
})
```

## Exportierte API

| Exportieren | Art | Zweck |
| --- | --- | --- |
| `XidProvider` | Komponente | Re-Export von @xid-kit/react-native XidProvider, der tokenCache undBrowser-Adapter akzeptiert |
| `createSecureStoreAdapter` | function | TokenCache-Adapter auf Basis von expo-secure-store; akzeptiertsecureStore-Instanz und optionales keyPrefix |
| `createExpoWebBrowserAdapter` | function | BrowserInterface-Adapter auf Basis von expo-web-browser |
| `useSignIn` | Hook | Re-Export aus @xid-kit/react-native: signIn, handleRedirect, signInState |
| `useSignOut` | Hook | Re-Export aus @xid-kit/react-native: signOut, signOutState |
| `useProtectedRoute` | Hook | Liest isLoaded/isSignedIn und ruft Expo Router replace für denRoutenschutz auf |

## Bekannte Einschränkungen

- `useAuth().isSignedIn` spiegelt den`XidClient`-Web-Cookie-Sitzungsstatus wider, der nach demToken-Tausch nicht automatisch aus den lokalen SecureStore-Tokens befülltwird. Laden Sie den Client-Status nach einer erfolgreichen Anmeldungexplizit neu.
- Dieses Paket stellt nur Adapter und die Expo-Router-Integration bereit.Für den grundlegenden React-Native-PKCE-Flow siehe[@xid-kit/react-native](/de/sdks/react-native).

Source: https://xid.dev/de/sdks/expo/index.mdx