@xmtp/react-native-sdk

xmtp-react-native

This repo provides a package you can use to build with XMTP in a React Native or Expo app.

Is there a feature you need that's currently supported? Please open an issue.

Or better yet, open a PR and we'll get it reviewed and merged as soon as possible. If you contribute a PR that gets merged into this repo, you'll be eligible to claim this XMTP contributor POAP.

Documentation

To learn how to use the XMTP React Native SDK, see Get started with the XMTP React Native SDK.

SDK reference

Access the XMTP React Native SDK reference documentation.

Automated Documentation Updates

This repository includes an automated workflow that updates the XMTP documentation when new releases are published. The workflow:

Triggers on every tagged GitHub release
Analyzes changes in the release to detect API modifications
Updates version references in the xmtp/docs-xmtp-org repository
Validates React Native code samples in the documentation
Creates a pull request with the updates

Setup Requirements

To enable the documentation update workflow, ensure the following repository secrets are configured:

DOCS_SYNC_TOKEN: A GitHub personal access token with write access to the xmtp/docs-xmtp-org repository
ANTHROPIC_API_KEY: An Anthropic API key for Claude Code Actions integration

Manual Trigger

The workflow can also be triggered manually via the Actions tab with an optional tag name parameter to analyze a specific release.

The workflow will automatically run when releases are published and create PRs to keep the documentation current with the latest SDK changes.

Use the XMTP React Native example app as a tool to start building an app with XMTP. This basic messaging app has an intentionally unopinionated UI to help make it easier for you to build with. See example/README.md for more instructions.

Example app quickstart

Follow the React Native guide to set up a CLI environment.

yarn
cd example
yarn
yarn run [ios or android]

Install in a managed Expo project

npx expo prebuild

Install in a bare React Native project

Install and configure the expo package.

Add the required babel plugin.

yarn add @babel/plugin-proposal-export-namespace-from -D

Add the plugin to your babel.config.js.

module.exports = {
  presets: ['module:@react-native/babel-preset'],
  plugins: [
    '@babel/plugin-proposal-export-namespace-from',
    // ... other plugins
  ],
};

Add the package to your dependencies

yarn add @xmtp/react-native-sdk

Configure for iOS

In the ios directory, update your Podfile file to set this value: platform :ios, '16.0'. This is required by XMTP.
Run:
```
npx pod-install
```

If you get the error The SQLCipher Sqlite extension is not present, but an encryption key is given, at the project configuration level in XCode, ensure that xmtpV3 is loaded before all other packages by setting Other Linker Flags first item to -l"xmtpv3".

The network will not support and eventually actively reject connections from clients using deprecated versions.
Bugs will not be fixed in deprecated versions.

The following table provides the deprecation schedule.

Announced	Effective	Minimum Version	Rationale
No more support for XMTP V2	May 1, 2025	>=4.0.2	In a move toward better security with MLS and the ability to decentralize, we will be shutting down XMTP V2 and moving entirely to XMTP V3. To learn more about V2 deprecation, see XIP-53: XMTP V2 deprecation plan. To learn how to upgrade, see xmtp-react-native v4.0.2. For reference, you can view the legacy branch.

Issues and PRs are welcome in accordance with XMTP contribution guidelines.