Join Us For Equipping Mobile Teams With APM Alerting Webinar - Sign Up

The Complete Solution for React Native Apps

Take your app quality and stability to the next level with the Instabug SDK for React Native

Spot Bugs Related to Server-Side Requests

Make it easier for your beta testers and users to send feedback with Instabug's in-app user feedback and bug reporting SDK. We will automatically capture details like the network requests, repro steps, and session details to help you debug and fix issues easily.

See Native and JavaScript Crash Stack Trace

Get real-time crash reports with stack trace details, steps to reproduce the crash, device and session data, and more. You can also reply to affected users to update them about a fix or ask for more details.

Enhance Your User Experience Quality

Stay on top of critical issues affecting your users' experience before they even complain. With the help of mobile-focused performance metrics, confidently prioritize between fixing issues and building new features. Don't waste time debugging and spot the exact conditions leading to performance issues.

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/Instabug.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

Simple Steps To Get Started

1- Open the command line and navigate to your React Native directory. Then, run the following command.


npm install instabug-reactnative

2- Link the bridging files in the npm package to the ios project by running the following command. Make sure you have Ruby installed before running this last command.


react-native link instabug-reactnative

3- To start using Instabug, import it into your "index.ios.js” and "index.android.js" file. Starting from React Native version 0.49 you can import Instabug in your App.js only.


import Instabug from 'instabug-reactnative';

iOS Configuration

4-Then initialize it in the constructor or componentWillMount


Instabug.startWithToken( "YOUR_APP_TOKEN_HERE", [Instabug.invocationEvent.shake]);

Android Configuration

5-Open “android/app/src/main/java/[...]/MainApplication.java”, locate the getPackages method, and add your app token which you will get upon signup.


@Override
	protected List getPackages() {
		return Arrays.asList(
			new MainReactPackage(),
      new RNInstabugReactnativePackage.Builder("YOUR_APP_TOKEN_HERE",MainApplication.this)
			.setInvocationEvent("shake")
			.build()
	)
}

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

Text Link

25,000 Innovative Mobile Teams Rely on Instabug

Himadri Sarkar

Himadri Sarkar

T-Mobile

“Customers love our product, and they show their love with a 4.8/5.0 rating for SyncUP KIDS in the app store. We really appreciate Instabug which provides a mechanism to build a communication channel with our customers and is an active ear for our customers' feedback.”

Justin Ing

Justin Ing

Loblaw

“Instabug has allowed us to really connect to our store colleagues. We have given them an easy and simple method to provide feedback to our support teams. It helped us diagnose, triage, and solve problems affecting our stores easier and faster. Our colleagues love it!"

Alex Ma

Alex Ma

Poparazzi

"I would highly recommend Instabug to anyone on the product development journey. Listening to feedback from users, and making sure you're building an app that works and that is high quality, is critical and crucial to finding product-market fit."

Kimberly Kalb

Houseparty

"With the Instabug + Slack integration, the Houseparty team is always updated about incoming issues reported through Instabug. And with the Instabug + Front integration, Houseparty’s Trust and Safety Team can receive, sort, and address all Instabug reports."

Wells Riley

Wells Riley

Envoy

"I've had plenty of apps break on me and I try to take a screenshot so that I can send it to support and I always get a little disappointed when I don’t see Instabug. Instabug has made it easier for Envoy’s customers to report problems.”

Jamie Scanlon

Jamie Scanlon

CommentSold

"Instabug not only gave us the ability to obtain accurate data about the health of the apps in the wild, it gave us the ability to address issues quickly and proactively."

Shelby Kozlowski

Shelby Kozlowski

Unigroup

“Instabug has helped us better understand our users' feedback and opened a communication channel with our users to accommodate features and functionally they're looking for more effectively.”

Mohammad Hariri

Mohammad Hariri

Verizon

"If you look at our crash rate over the last two to four years, the trend was down, we were making headway, but not as fast as we wanted to, and Instabug provided us the ability to make a major impact in a rather short time.”

partner logos
partner logos
partner logos
partner logos
partner logos

Frequently Asked Questions

Start Your 14-Day Free Trial for Realtime Contextual Insights

In less than a minute, integrate the Instabug SDK for iOS, Android, React Native, Xamarin, Cordova, Flutter, and Unity mobile apps