Skip to content
Expose native build config to JS (android only for now)
Branch: master
Clone or download
Pull request Compare This branch is even with ismaeldcom:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

React Native - Build config access from JS (android only for now)

Module to expose build config variables set in Gradle to your javascript code in React Native.

Inspired from deprecated luggit/react-native-build-config.


npm i ismaeldcom/react-native-build-config

RN > 0.47 use 0.11 or higher

Automatically link

With React Native 0.27+

react-native link react-native-build-config

With older versions of React Native

You need rnpm (npm install -g rnpm)

rnpm link react-native-device-info

Manually link

  1. Include this module in android/settings.gradle:
include ':react-native-build-config'
include ':app'

project(':react-native-build-config').projectDir = new File(rootProject.projectDir,
  1. Add a dependency to your app build in android/app/build.gradle:
dependencies {
    compile project(':react-native-build-config')
  1. Change your main activity to add a new package, in android/app/src/main/.../
import com.ismaeld.RNBuildConfig.RNBuildConfigPackage; // add import

public class MainApplication extends Application implements ReactApplication {

  private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) {

      /* ... */

      protected List<ReactPackage> getPackages() {
          return Arrays.<ReactPackage>asList(
                  new MainReactPackage(),
                  new RNBuildConfigPackage(BuildConfig.class), // add the package here


Declare config variables in Gradle, under android/app/build.gradle:

android {
    defaultConfig {
        buildConfigField "String",  "API_URL",     '""'
        buildConfigField "Boolean", "SHOW_ERRORS", "true"

Then access those from javascript:

const BuildConfig = require('react-native-build-config');

BuildConfig.API_URL     // ""
BuildConfig.SHOW_ERRORS // true

Gradle sets some variables by default:

  • VERSION_NAME and VERSION_CODE, both coming from the build settings. Keep in mind the code is a number
  • APPLICATION_ID: Your package name, eg: com.Example
  • DEBUG: set to true when running the app locally
  • BUILD_TYPE and FLAVOR: more build settings
You can’t perform that action at this time.