A Babel preset let you import application configs from .env file (zero runtime dependency)
Clone or download
Latest commit 057dfcd Jul 17, 2018
Failed to load latest commit information.
babel-plugin-dotenv Publish 0.1.1 Jan 14, 2018
.gitignore Initial commit Sep 5, 2016
.npmignore Ignore subpackage Sep 5, 2016
CHANGELOG.md Publish 0.2.0 Jul 17, 2018
LICENSE Initial commit Sep 5, 2016
README.md Clarify different setup for Babel 7 Jul 17, 2018
error.png Initial commit Sep 5, 2016
index.js Updates for RN 0.56.0 Jun 21, 2018
package.json Publish 0.2.0 Jul 17, 2018



Let you import environment variables from a .env file in React Native, don't need any native code integration.

CircleCI npm version npm downloads


$ npm install react-native-dotenv --save-dev

Add the react-native-dotenv preset to your .babelrc file at the project root.

RN (0.56+) (Babel 7)

  "presets": ["react-native", "module:react-native-dotenv"]

RN (<0.56)

  "presets": ["react-native", "react-native-dotenv"]

If you haven't got .babelrc set up for React Native, remember to install babel-preset-react-native first.

$ npm install babel-preset-react-native --save-dev


Add your app configuration in an .env file.


Now you can import it in your .js file.

import { API_KEY, ANOTHER_CONFIG } from 'react-native-dotenv'


How does it work?

As you can see, it's implemented as a babel plugin. All referenced imported members are replaced as the values specified in the .env file.

The example above will get compiled as below.

ApiClient.init('lorem', 'foobar')


Changes to .env file is not updated

Manually edit the file importing react-native-dotenv by either adding an empty line or whitespace will work.

Can I use different .env settings for production ?

Yes, simply create a separate .env.production file and the default release process of react-native will pickup the right config.


You can use the Release configuration to launch the Simulator. (Only supported in RN v0.39+)

react-native run-ios --configuration Release


  1. Command⌘ + M to launch the developer menu in Android emulator.
  2. Tap DevSettings.
  3. Toggle JS Dev Mode.

Can I have more than production & development environment configs?

Sadly, it's not available so far. One of the workaround is generating .env file before triggering RN's bundle script automatically using either shell script or your own custom build pipeline.


David Chang @zetachang


MIT License, see LICENSE file for detail.