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
| Option | Type | Default | Description |
|---|---|---|---|
apiKey | string | — | Required. Your API key (fm_live_...) |
baseUrl / baseURL | string / URL? | https://featurama.app | Custom API base URL |
timeout / timeoutInterval | number / TimeInterval | 10000 ms / 60 s | Request timeout |
appVersion | string / String? | auto-detected | Override app version sent with requests |
appBuild | string / String? | auto-detected | Override 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.