@vouch-in/react-native

Official Vouch SDK for React Native - Email validation and device fingerprinting for iOS and Android.

Installation

npm install @vouch-in/react-native
# or
yarn add @vouch-in/react-native
# or
pnpm add @vouch-in/react-native

iOS Setup

cd ios && pod install

Android Setup

No additional setup required. Add internet permission if not already present:

<!-- AndroidManifest.xml -->
<uses-permission android:name="android.permission.INTERNET" />

Quick Start

import { VouchProvider, useValidateEmail } from "@vouch-in/react-native";
import { View, TextInput, Button, Text } from "react-native";
import { useState } from "react";

function App() {
  return (
    <VouchProvider projectId="your-project-id" apiKey="your-client-api-key">
      <SignupForm />
    </VouchProvider>
  );
}

function SignupForm() {
  const { validate, loading, data } = useValidateEmail();
  const [email, setEmail] = useState("");

  const handleSubmit = async () => {
    const result = await validate(email);

    if (result.recommendation === "allow") {
      console.log("Email is valid!");
    } else {
      if (!result.checks.syntax?.pass) {
        console.log("Invalid email format");
      } else if (!result.checks.disposable?.pass) {
        console.log("Disposable emails not allowed");
      }
    }
  };

  return (
    <View>
      <TextInput
        value={email}
        onChangeText={setEmail}
        placeholder="Email address"
        keyboardType="email-address"
        autoCapitalize="none"
      />
      <Button
        title={loading ? "Validating..." : "Sign Up"}
        onPress={handleSubmit}
        disabled={loading}
      />
      {data && data.recommendation !== "allow" && (
        <Text>Email validation failed</Text>
      )}
    </View>
  );
}

Hooks

useValidateEmail

const { validate, loading, data, error, reset } = useValidateEmail();

useFingerprint

const { fingerprint, loading, error, generate } = useFingerprint();

useVouch

const vouch = useVouch();

Platform Support

| Platform | Minimum Version | | ------------ | --------------- | | iOS | 15.0+ | | Android | 8.0+ (API 26) | | React Native | 0.60.0+ |

Features

• Native device fingerprinting
• No dangerous permissions required
• TypeScript support
• Loading and error states
• Works with Expo

Documentation

For complete documentation, examples, and API reference, visit:

docs.vouch.expert/sdks/react-native

Related Packages

• @vouch-in/react - Web React SDK
• @vouch-in/node - Server-side validation

License

Proprietary. Copyright (c) Vouch. All rights reserved.

See the SDK License Agreement for terms.