React Native Android Fragment Save

DEPRECATED: A utility library for facilitating React Native development with Android Fragments.

Project README


This library has been deprecated and is no longer in use at Hudl. If you've been using this library, please consider adopting ReactFragment in the main react-native repo.


A utility library for facilitating React Native development with Android Fragments.

Getting started

$ npm install react-native-android-fragment --save


$ yarn add react-native-android-fragment

Mostly automatic installation

$ react-native link react-native-android-fragment

Manual installation


  1. Append the following lines to android/settings.gradle:
    include ':react-native-android-fragment'
    project(':react-native-android-fragment').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-android-fragment/android')
  2. Insert the following lines inside the dependencies block in android/app/build.gradle:
    compile project(':react-native-android-fragment')
  3. Open up android/app/src/main/java/[...]/
  • Add import com.hudl.oss.react.fragment.ReactFragment; to the imports at the top of the file


The primary component in this library is ReactFragment You can use this class directly if you wish, or you can extend from it to simplify your code.

A Builder pattern is provided out of the box for easy usage:

Fragment messagingFragment = new ReactFragment.Builder()
       .setLaunchOptions(launchOptions) // A Bundle of launch options

In your Activity make sure to override onKeyUp() in order to access the In-App Developer menu:

public boolean onKeyUp(int keyCode, KeyEvent event) {
    boolean handled = false;
    Fragment activeFragment = getSupportFragmentManager().findFragmentById(;
    if (activeFragment instanceof ReactFragment) {
        handled = ((ReactFragment) activeFragment).onKeyUp(keyCode, event);
    return handled || super.onKeyUp(keyCode, event);

Running Sample App

NOTE: Make sure your environment is set up for React Native and Android development.

  • Clone the repo
  • Open a terminal and navigate to the root directory of your checkout
  • yarn link
  • cd example
  • yarn link react-native-android-fragment
  • react-native link react-native-android-fragment
  • react-native run-android
Open Source Agenda is not affiliated with "React Native Android Fragment" Project. README Source: hudl/react-native-android-fragment
Open Issues
Last Commit
2 years ago

Open Source Agenda Badge

Open Source Agenda Rating