@klyo/react-native v0.3.5

Klyo React Native SDK

A React Native SDK for integrating Klyo's review collection and feedback system into your mobile applications. The primary focus is to help developers implement in-app review prompts that are strategically timed for maximum user engagement.

Key Features

• Smart Review Prompts: Show review prompts only when users are most likely to respond positively
• Automatic User Identification: Device-based user identification with no additional setup required
• Review Tracking: Track when users submit or dismiss reviews
• Multi-language Support: English and Arabic support with easy language switching
• Efficient State Management: Automatically stops tracking events after a user has taken action

Installation

# Install the Klyo SDK
npm install @klyo/react-native

# Install required peer dependencies
npm install @react-native-async-storage/async-storage
npm install react-native-get-random-values
npm install react-native-in-app-review

# For iOS, run pod install
cd ios && pod install && cd ..

Quick Start

Here's the minimum you need to integrate Klyo into your React Native app:

import React from 'react';
import { KlyoProvider, KlyoReviewModal } from '@klyo/react-native';

const apiKey = 'YOUR_API_KEY_HERE';

function App() {
  return (
    <KlyoProvider apiKey={apiKey}>
      <YourApp />
      <KlyoReviewModal />
    </KlyoProvider>
  );
}

Usage with Hooks

The SDK provides hooks to easily check eligibility and show reviews:

import { useKlyoReview } from '@klyo/react-native';

function ReviewButton() {
  const { isEligible, isLoading, showReview, checkEligibility } =
    useKlyoReview();

  // Check eligibility when component mounts (also auto-checks by default)
  useEffect(() => {
    checkEligibility();
  }, []);

  if (!isEligible) return null;

  return (
    <Button title="Rate our app" onPress={showReview} disabled={isLoading} />
  );
}

User Identification

Klyo SDK automatically handles user identification with a device-specific unique identifier. You don't need to provide any user data.

The auto-generated device UID is:

• Generated once per device
• Stored in AsyncStorage
• Persisted across app sessions
• Used for all tracking and eligibility checks
• Only cleared when the app is uninstalled or when manually reset

Event Lifecycle

The SDK follows this core principle: Once a user has taken an action (submitted or dismissed a review), the SDK stops initializing to prevent further tracking and prompting. This ensures users aren't repeatedly asked for reviews after they've already made a decision.

For developers who need to test the flow, the regenerateDeviceUID() method resets this state. This method works even when the SDK is not initialized, allowing you to reset user state and test review flows any time, regardless of initialization status.

Language Support

Klyo supports English and Arabic languages for its review prompts:

// Set language at provider level
<KlyoProvider
  apiKey="YOUR_API_KEY_HERE"
  language="ar" // Arabic language
>
  {/* ... */}
</KlyoProvider>

Supported languages:

• English (en) - default
• Arabic (ar)

Component Props

KlyoProvider Props

KlyoReviewModal Props

customStyles Object

API Reference

Klyo Singleton

KlyoContext (useKlyo hook)

useKlyoReview Hook

Example

Check out the example directory for a complete working example.

License

MIT