React Native SDK
Integrate deep linking, attribution, and smart links into your React Native app with the Grovs SDK.
Deep linking, link generation, push campaigns, in-app messages, event and screen tracking, revenue and attribution for React Native. The react-native-grovs-wrapper package wraps the native iOS and Android SDKs, on the new architecture (TurboModules) or the legacy bridge. An Expo config plugin does the native setup.
Requirements: React Native 0.70+. The native SDKs need iOS 13.0 and Android 5.0 (API 21); your React Native version may need more.
| Wrapper | iOS SDK (CocoaPods) | Android SDK (Maven Central) |
|---|---|---|
| 3.1.0 | Grovs ~> 3.1 | io.grovs:Grovs:3.1.0 |
| 3.0.2 | Grovs ~> 3.0 | io.grovs:Grovs:3.0.1 |
| 3.0.0, 3.0.1 | Grovs ~> 3.0 | io.grovs:Grovs:3.0.0 |
- Quick Start: Install and configure the SDK
- Deep Linking: Handle incoming deep links
- Link Creation: Generate smart links and look them up
- Push notifications: Push campaign opens, links and images (3.1)
- In-app messages: Dashboard campaigns shown inside your app (3.1)
- Revenue: Track in-app purchases and custom payments
- Events & Screen Tracking: Track custom events and React Navigation screens
- Privacy & Consent: Gate collection on consent, and what the SDK collects
- API Reference: All methods and types
Upgrading
3.0.x to 3.1: wraps iOS SDK 3.1 and Android SDK 3.1.0. Adds push campaigns, in-app messages and linkDetails, and removes the messages inbox. Bump io.grovs:Grovs to 3.1.0, run pod install, and check code that reads DeeplinkResponse.link, which is now optional. See the upgrade guide.
1.x to 3.0: existing JavaScript keeps working except logInAppPurchase, which now takes an object. Pass autoTrackScreenViews: false and the wrapper's stored consent value to the native configure calls. See the 3.0 upgrade guide.
In Expo projects, re-run npx expo prebuild --clean after each upgrade.
Example apps
- Full integration demo: grovs-io/grovs-react-native-example-app
- New architecture and legacy bridge examples: grovs-io/grovs-react-native