Amply React Native SDK

React Native TurboModule bridge for the Amply SDK. Enables event tracking, deeplink campaigns, and real-time data collection in React Native apps.

Features

| Feature | Status | Platform | |---------|--------|----------| | Event tracking | ✅ | Android, iOS | | Deeplink campaigns | ✅ | Android, iOS | | System events API | ✅ | Android, iOS | | Data inspection | ✅ | Android, iOS | | Debug/Logging | ✅ | Android, iOS | | Advanced API (identify, setUserProperty, flush) | ⏳ | Android, iOS |

Requirements

• React Native >= 0.79 (New Architecture enabled)
• Expo SDK >= 53 (for Expo apps)
• Android API 24+ / iOS 13.0+

Installation

yarn add @amplytools/react-native-amply-sdk

For Expo, add the plugin to app.json:

{
  "expo": {
    "plugins": ["@amplytools/react-native-amply-sdk"]
  }
}

Quick Start

import Amply from '@amplytools/react-native-amply-sdk';

// Initialize
await Amply.initialize({
  appId: 'YOUR_APP_ID',
  apiKeyPublic: 'YOUR_PUBLIC_API_KEY',
  debug: true, // optional: enable debug logging
});

// Track events
await Amply.track({
  name: 'Button Tapped',
  properties: { screen: 'home' },
});

// Listen for campaign deeplinks
const unsubscribe = await Amply.addDeepLinkListener((event) => {
  console.log('Deeplink:', event.url);
});

Documentation

Full integration guides, API reference, and examples:

docs.amply.tools

Contributing

See docs/DEVELOPMENT.md for development setup and contribution guidelines.

License

Apache License 2.0 - see LICENSE for details.