Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

React Native Restart

npm version npm downloads Build Status

Sometimes you want to reload your app bundle during app runtime. This package will allow you to do it.

iOS GIF Android GIF


  • Using react-native < 0.62? install react-native-restart@0.0.17
  • Using react-native >= 0.62? install react-native-restart@0.0.20 and above

With yarn

$ yarn add react-native-restart

With npm

$ npm install --save react-native-restart

Auto-Linking Setup (react-native >= 0.60)


$ cd ios
$ pod install


No further steps should be taken

Automatic Installation (Without Auto-Linking)

react-native link react-native-restart or npm install -g rnpm && rnpm link react-native-restart

Manual Android Installation

In android/settings.gradle


include ':react-native-restart'
project(':react-native-restart').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-restart/android')

In android/app/build.gradle


dependencies {

    implementation project(':react-native-restart')

Register module (in

import com.reactnativerestart.RestartPackage;  // <--- Import

public class MainApplication extends Application implements ReactApplication {

	private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) {

	     * A list of packages used by the app. If the app uses additional views
	     * or modules besides the default ones, add more packages here.
	    protected List<ReactPackage> getPackages() {
	        return Arrays.<ReactPackage>asList(
	                new MainReactPackage(),
	                new RestartPackage() // Add this line

Manual iOS Installation

Importing The Library

  • Drag the file Restart.xcodeproj from /node_modules/react-native-restart/ios into the Libraries group in the Project navigator. Ensure that Copy items if needed is UNCHECKED!

Add Files To...

Library Imported Successfully

  • Ensure that libRestart.a is linked through Link Binary With Libraries on Build Phases:

Library Linked

  • Ensure that Header Search Paths on Build Settings has the path $(SRCROOT)/../node_modules/react-native-restart set to recursive:

  • You're All Set!

CocoaPod iOS Installation

In your ios/Podfile make sure to use react-native-restart from the local node_modules/. With that, only your project Pod needs to be linked and no extra configuration is required:

target 'MyReactApp' do
  # Make sure you're also using React-Native from ../node_modules
  pod 'React', :path => '../node_modules/react-native', :subspecs => [
	# ... whatever else you use
  # React-Native dependencies such as yoga:
  pod 'yoga', path: '../node_modules/react-native/ReactCommon/yoga'

  # The following line uses react-native-restart, linking with
  # the library and setting the Header Search Paths for you
  pod 'react-native-restart', :path => '../node_modules/react-native-restart'

Remember to run cd ios && pod install to update files used by Xcode.


import RNRestart from 'react-native-restart'; // Import package from node modules

// Immediately reload the React Native Bundle


Contributions are welcome. Please see if you like to contribute to this library.


Thanks to Microsoft CodePush library. I simply extracted the code from their library's logic to reload the React Native Bundle.