React Native SDK

The Teardown React Native SDK provides everything you need to manage device identity, force app updates, and collect analytics in your mobile applications.

Features

• Device & User Identity - Unique device fingerprinting and user session management
• Force Updates - Automatic version checking with optional, recommended, or required update flows
• Device Information - Comprehensive device, OS, and app information collection
• Storage - Namespaced persistent storage with platform adapters
• Logging - Structured logging system with configurable log levels
• Type Safety - Full TypeScript support with Zod runtime validation

Quick Start

bun add @teardown/react-native

import { TeardownCore, TeardownProvider } from '@teardown/react-native';
import { ExpoDeviceAdapter } from '@teardown/react-native/adapters/expo';
import { MMKVStorageAdapter } from '@teardown/react-native/adapters/mmkv';

const teardown = new TeardownCore({
  org_id: 'your-org-id',
  project_id: 'your-project-id',
  api_key: 'your-api-key',
  storageAdapter: new MMKVStorageAdapter(),
  deviceAdapter: new ExpoDeviceAdapter(),
});

export default function App() {
  return (
    <TeardownProvider core={teardown}>
      <YourApp />
    </TeardownProvider>
  );
}

Platform Support

Documentation

• Getting Started - Installation and setup
• Core Concepts - Architecture overview
• Identity - User and device identification
• Force Updates - Version management
• Storage Adapters - Persistent storage adapters
• API Reference - Complete API documentation
• Hooks Reference - React hooks