> ## 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>;
};

export const Card = ({imgUrl, title, description, href, horizontal = false, newTab = false}) => {
  const [isHovered, setIsHovered] = useState(false);
  const handleClick = e => {
    e.preventDefault();
    if (newTab) {
      window.open(href, '_blank', 'noopener,noreferrer');
    } else {
      window.location.href = href;
    }
  };
  return <div className={`not-prose relative my-2 p-[1px] rounded-xl transition-all duration-300 ${isHovered ? 'bg-gradient-to-r from-[#FF4E00] to-[#874AE3]' : 'bg-gray-200'}`} onMouseEnter={() => setIsHovered(true)} onMouseLeave={() => setIsHovered(false)}>
      <a href={href} onClick={handleClick} className={`not-prose flex ${horizontal ? 'flex-row' : 'flex-col'} font-normal h-full bg-white overflow-hidden w-full cursor-pointer rounded-[11px] no-underline`}>
        {imgUrl && <div className={`relative overflow-hidden flex-shrink-0 ${horizontal ? 'w-[30%] rounded-l-[11px]' : 'w-full'}`} onClick={e => e.stopPropagation()}>
            <img src={imgUrl} alt={title} className="w-full h-full object-cover pointer-events-none select-none" draggable="false" />
            <div className="absolute inset-0 pointer-events-none" />
          </div>}
        <div className={`flex-grow px-6 py-5 ${horizontal ? 'w-[70%]' : 'w-full'} flex flex-col ${horizontal && imgUrl ? 'justify-center' : 'justify-start'}`}>
          {title && <h2 className="font-semibold text-base text-gray-800 m-0">{title}</h2>}
          {description && <div className={`font-normal text-gray-500 re leading-6 ${horizontal || !imgUrl ? 'mt-0' : 'mt-1'}`}>
              <p className="m-0 text-xs">{description}</p>
            </div>}
        </div>
      </a>
    </div>;
};

## 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="/v2/react-native/setup/react-native" icon="wrench">
    Platform-specific configuration for iOS and Android (passkeys, associated
    domains, etc.)
  </Card>

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

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

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