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

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

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

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.

Diagnose and Handle Errors in Production

Crash Reporting

Diagnose and Handle Errors in Production

Save time and quickly figure out exactly why your app is crashing with detailed reports built by developers for developers. Reply to affected users to ask for more information or update them about a fix.

Enhance Your User Experience

App Performance Monitoring

Enhance Your User Experience

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.

See What Your Users Are Seeing

Session Replay

See What Your Users Are Seeing

See the user journey through your own eyes using Instabug’s Session Replay. Uncover the root cause of application errors and performance issues at lightning speed. You can now witness app hangs, network errors, and crashes as if you were virtually standing alongside your users.

Debug and Monitor Ratings and Reviews

App Ratings and Reviews

Debug and Monitor Ratings and Reviews

Master app ratings and debug your way to five-star reviews with Instabug's App Ratings and Reviews. We automatically identify sessions linked to app reviews, allowing you to seamlessly debug using session replay.

Take Control of Your Releases

Release Management

Take Control of Your Releases

Take full control of your mobile app's version rollouts, ensuring an optimized and high-quality user experience with Instabug's Release Management. Track version stability, performance, and user reviews in one place.

Explore
Instabug’s Sandbox

Try out Instabug in an interactive demo environment

Frequently Asked Questions

Seeing is Believing, Start Your 14-Day Free Trial

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