react-native-ultimate-config

react-native-ultimate-config

Configure all levels of your react-native app with a single file

Table of contents

1. Mission
2. Quickstart Guide
3. API
4. TypeScript Support
5. Competitors

Mission

React-Native brings together 3 platforms: ios, android, javascript each of which have different conventions and approaches how to manage environment settings.

react-native-ultimate-config exposes configuration from env files to all levels of the projects:

1. javascript
2. native code
   • java
   • objective-c
3. native build configuration
   • ios
     • build settings
     • infoplist
   • android
     • build config
     • string resources
     • project.ext

|-------------------------------------------------------|
|                                                       |
|                     javascript                        |
|                                                       |
|-------------------------------------------------------|
|                          |                            |
|       objective-c        |           java             |
|                          |                            |
|-------------------------------------------------------|
|                          |                            |
|      build settings      |     AndroidManifest.xml    |
|         infoplist        |        build.gradle        |
|                          |                            |
|-------------------------------------------------------|

react-native-ultimate-config offers a way to configure your projects on all levels and keep configuration data separate from code or project files: api urls, app names, feature flags. Anything you would typically put into environment can now be loaded from a separate file.

Consumption of the environment should be happening with explicit command without too much magic and complex integration steps.

TypeScript Support

index.d.ts is generated dynamically according to variables defined in envfile

Competitors

project	comparison
react-native-config	Allows configuring native and javascript but project seems to be abandoned.
react-native-dotenv	Javascript only. Does not allow configure native counterpart of the app.