> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getpara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# React Native Quickstart

> Get started with Para's React Native SDK in minutes

export const Link = ({href, label, newTab = false}) => {
  const [isHovered, setIsHovered] = useState(false);
  return <a href={href} target={newTab ? '_blank' : '_self'} rel={newTab ? 'noopener noreferrer' : undefined} className="not-prose inline-block relative text-black font-semibold cursor-pointer border-b-0 no-underline" onMouseEnter={() => setIsHovered(true)} onMouseLeave={() => setIsHovered(false)}>
      {label}
      <span className={`absolute left-0 bottom-0 w-full rounded-sm bg-gradient-to-r from-orange-600 to-purple-600 transition-all duration-300 ${isHovered ? 'h-0.5' : 'h-px'}`} />
    </a>;
};

## Prerequisites

Before integrating Para into your React Native app, make sure you have:

1. **An API key** — create your account at the <Link href="https://developer.getpara.com" label="Para Developer Portal" />
2. **A React Native project** — bare workflow or Expo development build (managed workflow is not supported)

## Install

<CodeGroup>
  ```bash yarn theme={null}
  yarn add @getpara/react-native-wallet @tanstack/react-query @react-native-async-storage/async-storage react-native-keychain react-native-modpow react-native-passkey react-native-quick-base64 @craftzdog/react-native-buffer react-native-quick-crypto
  ```

  ```bash npm theme={null}
  npm install @getpara/react-native-wallet @tanstack/react-query @react-native-async-storage/async-storage react-native-keychain react-native-modpow react-native-passkey react-native-quick-base64 @craftzdog/react-native-buffer react-native-quick-crypto
  ```
</CodeGroup>

<Warning>
  For iOS, run `cd ios && pod install` after installing to link native dependencies.
</Warning>

## Set Up the Provider

Import the crypto shim at your app's entry point, then wrap your app with `ParaProvider` and a React Query `QueryClientProvider`:

```tsx App.tsx theme={null}
import "@getpara/react-native-wallet/shim";

import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import { ParaProvider } from "@getpara/react-native-wallet";

const queryClient = new QueryClient();

export default function App() {
  return (
    <QueryClientProvider client={queryClient}>
      <ParaProvider
        paraClientConfig={{ apiKey: "YOUR_API_KEY" }}
        config={{ appName: "My App" }}
      >
        <AppContent />
      </ParaProvider>
    </QueryClientProvider>
  );
}
```

<Note>
  If you're using a legacy API key (one without an environment prefix), pass `env` explicitly: `paraClientConfig={{ apiKey: "YOUR_API_KEY", env: Environment.BETA }}`.
</Note>

## Authenticate a User

Use the built-in hooks to handle authentication:

```tsx AuthScreen.tsx theme={null}
import {
  useSignUpOrLogIn,
  useVerifyNewAccount,
  useIsFullyLoggedIn,
} from "@getpara/react-native-wallet";
import { useState } from "react";
import { View, TextInput, Button, Text } from "react-native";

export function AuthScreen() {
  const [email, setEmail] = useState("");
  const [code, setCode] = useState("");
  const { data: isFullyLoggedIn } = useIsFullyLoggedIn();
  const { signUpOrLogInAsync, isPending: isSending } = useSignUpOrLogIn();
  const { verifyNewAccountAsync, isPending: isVerifying } =
    useVerifyNewAccount();

  if (isFullyLoggedIn) {
    return <Text>You're logged in!</Text>;
  }

  const handleSendCode = async () => {
    await signUpOrLogInAsync({ email });
  };

  const handleVerify = async () => {
    await verifyNewAccountAsync({ verificationCode: code });
  };

  return (
    <View>
      <TextInput value={email} onChangeText={setEmail} placeholder="Email" />
      <Button
        title={isSending ? "Sending..." : "Send Code"}
        onPress={handleSendCode}
        disabled={isSending}
      />
      <TextInput
        value={code}
        onChangeText={setCode}
        placeholder="Verification code"
      />
      <Button
        title={isVerifying ? "Verifying..." : "Verify"}
        onPress={handleVerify}
        disabled={isVerifying}
      />
    </View>
  );
}
```

## Sign a Message

Once authenticated, use the `useSignMessage` hook:

```tsx SignScreen.tsx theme={null}
import { useSignMessage, useWallet } from "@getpara/react-native-wallet";
import { Button, Alert } from "react-native";

export function SignScreen() {
  const { data: wallet } = useWallet();
  const { signMessageAsync, isPending } = useSignMessage();

  const handleSign = async () => {
    if (!wallet) return;
    const result = await signMessageAsync({
      walletId: wallet.id,
      messageBase64: btoa("Hello, Para!"),
    });
    Alert.alert("Signature", `0x${result.signature}`);
  };

  return (
    <Button
      title={isPending ? "Signing..." : "Sign Message"}
      onPress={handleSign}
      disabled={isPending}
    />
  );
}
```

<Note>
  **Need an API Key?** Head to the <Link href="https://developer.getpara.com" label="Para Developer Portal" /> to create your account and get your API key.
</Note>

## Next Steps

<CardGroup cols={2}>
  <Card title="Full Setup Guide" href="/v3/react-native/setup/react-native" icon="wrench">
    Platform-specific configuration for iOS and Android (passkeys, associated
    domains, etc.)
  </Card>

  <Card title="EVM Integration" href="/v3/react-native/guides/web3-operations/evm/setup-libraries" icon="ethereum">
    Integrate Para with Viem for EVM chain operations
  </Card>

  <Card title="Session Management" href="/v3/react-native/guides/sessions" icon="clock">
    Manage user sessions and authentication state
  </Card>

  <Card title="All Hooks" href="/v3/react-native/guides/hooks/para-provider" icon="sparkles">
    Explore all available React Native hooks
  </Card>
</CardGroup>