Skip to content
No description, website, or topics provided.
Java JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
android Updated build.gradle to v1..5.0 Nov 27, 2016
.gitignore Updated build.gradle to v1..5.0 Nov 27, 2016
.npmignore Initial Nov 26, 2016
LICENSE Initial commit Nov 26, 2016 Updated Linking Instructions Nov 26, 2016 Initial Nov 26, 2016
package.json Initial Nov 26, 2016

React Native Android Library Boilerplate

This project serves as a boilerplate to create custom React Native native modules that can later be installed through NPM and easily be used in production.

Getting started

  1. Clone the project
  2. Customize the project name by doing the following:
    • Edit author and name in package.json

    • Customize the Java package name (com.domain.package) as follows:

      1. Modify it in android/src/main/AndroidManifest.xml.
      2. Rename the folders starting from android/src/main/java to match your package name.
      3. Adjust package io.cmichel.boilerplate; in the top of the and files in android/src/main//java/package/path to match it.
    • Edit the name of your module in

      public String getName() {
          return "Boilerplate";

      and adjust it in

  3. Modify/Build the Project in Android Studio
    • Start Android Studio and select File -> New -> Import Project and select the android folder of this package.
    • If you get a Plugin with id 'android-library' not found Error, install android support repository.
    • If you get asked to upgrade gradle to a new version, you can skip it.

Installing it as a library in your main project

There are many ways to do this, here's the way I do it:

  1. Push it to GitHub.

  2. Do npm install --save git+ in your main project.

  3. Link the library:

    • Add the following to android/settings.gradle:

      include ':react-native-android-library-boilerplate'
      project(':react-native-android-library-boilerplate').projectDir = new File(settingsDir, '../node_modules/react-native-android-library-boilerplate/android')
    • Add the following to android/app/build.gradle:

      dependencies {
          compile project(':react-native-android-library-boilerplate')
    • Add the following to android/app/src/main/java/**/

      package com.motivation;
      import io.cmichel.boilerplate.Package;  // add this for react-native-android-library-boilerplate
      public class MainApplication extends Application implements ReactApplication {
          protected List<ReactPackage> getPackages() {
              return Arrays.<ReactPackage>asList(
                  new MainReactPackage(),
                  new Package()     // add this for react-native-android-library-boilerplate
  4. Simply import/require it by the name defined in your library's package.json:

    import Boilerplate from 'react-native-android-library-boilerplate''Boilerplate runs fine', Boilerplate.LONG)
  5. You can test and develop your library by importing the node_modules library into Android Studio if you don't want to install it from git all the time.

You can’t perform that action at this time.