The Courier React Native SDK provides prebuilt components and TypeScript APIs for adding in-app notifications, push notifications, and notification preferences to your React Native app. It handles authentication, token management, and real-time message delivery across iOS and Android from a single codebase.
Requires iOS 15.0+, Android SDK 23+, and Gradle 8.4+.
npm install @trycourier/courier-react-native
cd ios && pod installIn React Native's Swift Package Manager mode, run npx react-native spm instead of pod install.
Notification service extension: add Courier_iOS to the extension target with Swift Package Manager. In Xcode, choose File > Add Package Dependencies, enter https://github.com/trycourier/courier-ios, and pick Up to Next Major Version. If the extension has pod 'Courier_iOS' in your Podfile, remove it.
import Courier, { CourierInboxView } from "@trycourier/courier-react-native";
// Sign in (JWT generated by your backend)
await Courier.shared.signIn({
userId: "user_123",
accessToken: jwt,
});
// Drop in a prebuilt Inbox view
<CourierInboxView
onClickInboxMessageAtIndex={(message) => {
message.read
? Courier.shared.unreadMessage({ messageId: message.messageId })
: Courier.shared.readMessage({ messageId: message.messageId });
}}
style={{ flex: 1 }}
/>Full documentation lives at courier.com/docs/sdk-libraries/react-native — installation, authentication, push setup (iOS CourierReactNativeDelegate + Android Firebase decoupling), theming, custom UI, Expo, and the CourierClient API reference.
Found a bug or want to request a feature? Open an issue.