Installation

Install the package

Install the core SDK plus its two required peer dependencies:

npm install @feddyapp/react-native @react-native-async-storage/async-storage react-native-safe-area-context

For richer features, also install the optional Expo modules — each adds a specific capability and is gracefully no-op'd when missing:

npx expo install \
  expo-application expo-device expo-localization \
  expo-image-picker expo-image-manipulator expo-store-review \
  expo-iap

Get your Project ID

1. Sign up at feddy.app and create a workspace
2. Open Settings → API Keys
3. Copy the Project ID — it looks like fed_xxxxxxxxxxxx (the fed_ prefix followed by 12 alphanumeric characters)

Configure and mount FeddyProvider

Call Feddy.configure(...) once at app launch and mount <FeddyProvider /> at the root of your app. The provider mounts the built-in compose modal and Smart Review sheet so the imperative APIs (Feddy.openFeedback(), Feddy.requestReviewIfAppropriate()) work from anywhere in your tree.

import { Feddy, FeddyProvider } from '@feddyapp/react-native';
import { SafeAreaProvider } from 'react-native-safe-area-context';
import YourApp from './YourApp';

Feddy.configure({ apiKey: 'fed_xxxxxxxxxxxx' });

export default function App() {
  return (
    <SafeAreaProvider>
      <FeddyProvider>
        <YourApp />
      </FeddyProvider>
    </SafeAreaProvider>
  );
}

import { Feddy, FeddyProvider } from '@feddyapp/react-native';
import { Stack } from 'expo-router';
import { SafeAreaProvider } from 'react-native-safe-area-context';

Feddy.configure({ apiKey: 'fed_xxxxxxxxxxxx' });

export default function RootLayout() {
  return (
    <SafeAreaProvider>
      <FeddyProvider>
        <Stack />
      </FeddyProvider>
    </SafeAreaProvider>
  );
}

Feddy.configure() is synchronous, fire-and-forget, and never throws — invalid keys or network failures log to the console rather than surfacing as a thrown error.

Verify the install

Drop the button below into any screen to confirm the SDK is wired up. It opens the bundled feedback modal — submit a quick test message:

import { Pressable, Text } from 'react-native';
import { Feddy } from '@feddyapp/react-native';

export function VerifyButton() {
  return (
    <Pressable
      onPress={() => Feddy.openFeedback({ boardKey: 'features' })}
      style={{ padding: 12 }}
    >
      <Text>Send Feedback</Text>
    </Pressable>
  );
}

In the Feddy dashboard, navigate to Inbox — your test submission should appear at the top of the list within a second or two.