PLATFORMS

React Native

Optimize React Native Apps with Instabug's Complete SDK

Effortlessly test new features, elevate app quality, and collect actionable feedback throughout the React Native mobile development lifecycle with Instabug's seamless, out-of-the-box solution

Explore SandboxRequest a Demo

25,000+ Mobile Teams
Rely on Instabug

Figma Logo
Lyft logo
DoorDash logo
T-mobile logo
Emirates logo
Asana logo
Toyota logo

The Made-For-Mobile Platform for React Native Apps

Bug
Reporting

Actionable Bug Reports with Context

Crash
Reporting

Actionable Crash Logs and Severity Rating

App Performance
Monitoring

Quality Metric for Improved Performance

Session
Replay

Real-Time User Experience
View

Release
Management

Full Control of Mobile App Rollouts

App Ratings
and Reviews

Debug App Ratings & Reviews

Flows

Debug App Ratings & Reviews

Feature
Flags

Debug App Ratings & Reviews

In-App
Surveys

Receive contextual reports from users

Simple Steps to Get Started

Manual

Cocoapods

Carthage

Language:

1 - Download the SDK zip file and extract it to get the .framework file.

‍

2 - Drag & drop Instabug.framework to your project's "Embedded Binaries" section under the    "General" tab, and make sure that the "Copy items if needed" checkbox is checked.

‍

3 - Import the framework in the appDelegate.


import Instabug

‍

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


Instabug.start(withToken:"YOUR_APP_TOKEN_HERE", invocationEvents: [.shake, .screenshot])

‍

5 -If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your  app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

‍

6 - Create a new "Run Script Phase" in your project’s target "Build Phases" and add the following snippet


bash
"${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/Instabug.framework/Instabug.bundle/
strip-frameworks.sh"

‍

1 - Download the SDK zip file and extract it to get the .xcframework file.

‍

2 - Drag & drop Instabug.framework to your project's "Embedded Binaries" section under the "General" tab, and make sure that the "Copy items if needed" checkbox is checked.

‍

3 - Import the framework in the appDelegate.


#import <Instabug/Instabug.h>

‍

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


[Instabug startWithToken:@"YOUR_APP_TOKEN_HERE" invocationEvents: IBGInvocationEventShake | IBGInvocationEventScreenshot];

‍

5 -If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

‍

6 - Create a new "Run Script Phase" in your project’s target "Build Phases" and add the following snippet


bash "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/Instabug.framework/InstabugResources.bundle/strip-frameworks.sh"

‍

1 - Add the following line to your "Podfile":


pod 'Instabug'

‍

2 - Run pod install in your Xcode project directory. CocoaPods should download and install the SDK and all the required

‍

3 - Import the framework in the appDelegate.


#import <Instabug/Instabug.h>

‍

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


[Instabug startWithToken:@"YOUR_APP_TOKEN_HERE" invocationEvents: IBGInvocationEventShake | IBGInvocationEventScreenshot];

‍

5 - If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your 
 app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

‍

1 - Add the following line to your "Podfile":


pod 'Instabug'

‍

2 - Run pod install in your Xcode project directory. CocoaPods should download and install the SDK and all the required

‍

3 - Import the framework in the appDelegate.


import Instabug

‍

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


Instabug.start(withToken:"YOUR_APP_TOKEN_HERE", invocationEvents: [.shake, .screenshot])

‍

5 - If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your 
 app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

‍

1 - To integrate Instabug into your Xcode project using Carthage, add it to your Cartfile:


binary "https://raw.githubusercontent.com/Instabug/Instabug-iOS/master/Instabug.json"

‍

2 - Run the following command:


$ carthage update

‍

3 - Import the framework in the appDelegate


#import <Instabug/Instabug.h>

‍

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


[Instabug startWithToken:@"YOUR_TOKEN_HERE" invocationEvents:IBGInvocationEventFloatingButton | IBGInvocationEventShake];

‍

5 - If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your 
 app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

‍

1 - To integrate Instabug into your Xcode project using Carthage, add it to your Cartfile:


binary "https://raw.githubusercontent.com/Instabug/Instabug-iOS/master/Instabug.json"

‍

2 - Run the following command:


$ carthage update

‍

3 - Import the framework in the appDelegate


import Instabug

‍

4 - Call the SDK by including this line in "application didFinishLaunchingWithOptions"


Instabug.start(withToken:"YOUR_APP_TOKEN_HERE", invocationEvents: [.shake, .screenshot])

‍

5 - If your app doesn’t already access the microphone or photo library, you’ll need to add the following 2 keys to your 
 app’s info.plist file:


NSMicrophoneUsageDescription
NSPhotoLibraryUsageDescription

‍

1-In Terminal, navigate to your React Native directory and install the instabug-reactnative package:

‍


npm install instabug-reactnative

‍

Or if you prefer to use Yarn instead of npm:

‍


yarn add instabug-reactnative

‍

2-CocoaPods on iOS needs this extra step:

‍


cd ios && pod install && cd ..

‍

3-To start using Instabug, import it as follows, then initialize it in the constructor or componentWillMount. This line will let the SDK work with the default behavior. The SDK will be invoked when the device is shaken. You can customize this behavior through the APIs.

‍


import Instabug from 'instabug-reactnative';

Instabug.init({
  token: 'APP_TOKEN',
  invocationEvents: [InvocationEvent.shake],
});

You can find your app token by selecting the SDK tab from your Instabug dashboard.

You can also check out our API Reference for more detailed information about our SDK

Text Link
Get App Token

Balance Stability and Feature Development for React Native Apps

Debug and Fix Issues Faster

Bug Reporting

Debug and Fix Issues Faster

The most comprehensive bug reporting tool in the market for mobile development. Make it easier for your testers and users to submit bugs and get all the details you need to investigate, understand, and easily fix any issues.

Explore
Instabug’s Sandbox

Try out Instabug in an interactive demo environment

Try Sandbox

The Worlds's Most Loved Brands Rely on Instabug for Mobile Growth

More than 25,000+ of the top mobile teams in the world rely on Instabug to deliver 5-star apps

Balance Between Performance Improvements and New Features

Verizon uses Instabug to securely achieve 99.9% crash-free sessions

Mohammad Hariri
Mohammad Hariri
Distinguished Member of Technical Services
Balance Between Performance Improvements and New Features

Instabug + Figma: Mobile Performance Meets Mobile Design

Vivek Karuturi Native Apps Engineering Lead
Vivek Karuturi
Native Apps Engineering Lead
Balance Between Performance Improvements and New Features

Instabug reduces our mean time to repair while improving the App Store ratings

Decathlon employee
Maxime Harter
Engineering Manager
More Case Studies

Frequently Asked Questions

No items found.

Seeing is Believing, Start Your 14-Day Free Trial

Integrate the Instabug SDK seamlessly into your iOS, Android, React Native, or Flutter app in under a minute

Request a DemoGet Started

PRODUCT

OverviewBug ReportingCrash ReportingApp PerformanceSession ReplayRelease
ManagementIn-App SurveysApp Ratings
and ReviewsFlowsFeature Flags

Integrations

JiraSlackTrelloGitHubZendeskView All

Platforms

iOSAndroidReact NativeFlutter

Comparisons

App CenterBugsnagCrashlyticsFirebaseNew RelicSentryTestFairyEmbraceDatadog

RESOURCES

CustomersReviewsBlogNewsroomDocsHelp CenterFAQsResearch Program
Benchmark Report 2025

COMPANY

CareersCulture
Instabug Logo

Terms and Conditions / Website Terms of Use / Privacy Policy © 2025 Instabug, Inc.