SDK Setup

Integrate Featurama into your React Native/Expo or Swift app.

Install

npm install @featurama/react-native

Configure

import { FeaturamaProvider } from '@featurama/react-native';

export default function App() {
  return (
    <FeaturamaProvider
      config={{
        apiKey: 'fm_live_your_api_key',
      }}
    >
      {/* your app */}
    </FeaturamaProvider>
  );
}

Configuration options

OptionTypeDefaultDescription
apiKeystringRequired. Your API key (fm_live_...)
baseUrl / baseURLstring / URL?https://featurama.appCustom API base URL
timeout / timeoutIntervalnumber / TimeInterval10000 ms / 60 sRequest timeout
appVersionstring / String?auto-detectedOverride app version sent with requests
appBuildstring / String?auto-detectedOverride build number sent with requests

Show the feature request screen

import { FeatureRequestsScreen } from '@featurama/react-native';

<FeatureRequestsScreen
  colorScheme="light"
  accentColor="#6366f1"
  onClose={() => navigation.goBack()}
/>

See SDK UI Component for full props, theming, and navigation examples.

Device info collection

The SDK automatically collects device metadata with each request:

  • Platform (iOS/Android), OS version
  • Device model, manufacturer, type
  • App version, build number
  • Locale, screen dimensions

For richer data on Expo, install expo-device and expo-constants as optional peer dependencies.

Notes

  • Keep your API key in a secure env setup for production builds.
  • Regenerate key in app details when needed.
  • If key changes, update your app configuration.