bhishaksanyal/react-native-build-orchestrator

react-native-build-orchestrator

[](https://codecov.io/github/bhishaksanyal/react-native-build-orchestrator) [](https://www.codefactor.io/repository/github/bhishaksanyal/react-native-build-orchestrator)

CLI workflow manager for React Native projects that standardizes environment handling, flavor-aware Android/iOS builds, version updates, and Fastlane uploads.

Why use it

React Native release pipelines often drift across projects because build commands, env files, schemes, and store steps are handled differently by each team. This package provides one command-line workflow to:

• Detect and manage environments (.env + custom vars)
• Manage Android flavors and iOS schemes
• Run debug and archive builds with guided prompts or flags
• Update Android and iOS versions consistently
• Upload artifacts through Fastlane with lane/track defaults
• Run build + upload in one release pipeline (rnbuild release)

Features

• Interactive and non-interactive CLI commands
• Typed runtime env exports for app code (src/config/env.ts)
• Native env export artifacts for Android and iOS
• Flavor-aware command rewriting for Gradle and iOS scheme usage
• Artifact-aware release pipeline (apk, aab, ipa)
• Fastlane setup wizard (Fastfile + Appfile generation)

Requirements

• Node.js =20.18.0
• Yarn 3+ recommended
• React Native CLI project structure (android/, ios/)
• Fastlane installed for upload steps (bundle exec fastlane preferred)

Installation

yarn add -D react-native-build-orchestrator

Run without installation:

yarn dlx react-native-build-orchestrator init

Quick Start

# 1) Initialize config
yarn rnbuild init

# 2) Verify project
yarn rnbuild doctor

# 3) Run debug app with selected env
yarn rnbuild run

# 4) Build and upload to store in one command
yarn rnbuild release --env production --platform android --type store

Commands

init