# @wavemaker/wm-reactnative-cli > A command line utility to build react native apps created using WaveMaker product. Latest version **1.9.14** (published 2026-10-27) · ISC license · 0 weekly downloads ## Install ```sh npm install @wavemaker/wm-reactnative-cli pnpm add @wavemaker/wm-reactnative-cli yarn add @wavemaker/wm-reactnative-cli bun add @wavemaker/wm-reactnative-cli ``` Provides the command `wm-reactnative`. ## Health **Score 55/100 (C)** — status: active. Positive: no vulnerabilities; recently updated; high maintenance score. Warnings: low downloads; no types; no esm support. ## Facts | | | |---|---| | Version | 1.9.14 | | Published | 2026-10-27 | | First published | 2022-06-05 | | Weekly downloads | 0 | | License | ISC | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 22 | | Unpacked size | 930.9 KB | | Known vulnerabilities | 0 (+15 in 3 direct dependencies) | | Install scripts | no | | Maintainers | sboyina, wavemaker_devops, wmdocs, nareshr | ## Links - npm: https://www.npmjs.com/package/@wavemaker/wm-reactnative-cli - npm.io page: https://npm.io/package/@wavemaker/wm-reactnative-cli ## Dependencies (22) - [qs](https://npm.io/package/qs.md) 6.16.0 - [open](https://npm.io/package/open.md) 8.4.2 - [yarn](https://npm.io/package/yarn.md) 1.22.22 - [axios](https://npm.io/package/axios.md) 1.18.0 - [chalk](https://npm.io/package/chalk.md) 4.1.2 - [execa](https://npm.io/package/execa.md) 4.1.0 - [plist](https://npm.io/package/plist.md) 3.1.0 - [xcode](https://npm.io/package/xcode.md) 3.0.1 - [yargs](https://npm.io/package/yargs.md) 17.7.2 - [prompt](https://npm.io/package/prompt.md) 1.3.0 - [rimraf](https://npm.io/package/rimraf.md) 3.0.2 - [semver](https://npm.io/package/semver.md) 7.7.4 - [express](https://npm.io/package/express.md) 5.2.1 - [winston](https://npm.io/package/winston.md) 3.19.0 - [fs-extra](https://npm.io/package/fs-extra.md) 11.3.4 - [htmlencode](https://npm.io/package/htmlencode.md) 0.0.5 - [http-proxy](https://npm.io/package/http-proxy.md) ^1.18.1 - [extract-zip](https://npm.io/package/extract-zip.md) 2.0.1 - [update-notifier](https://npm.io/package/update-notifier.md) 7.3.1 - [node-localstorage](https://npm.io/package/node-localstorage.md) 3.0.5 - [properties-reader](https://npm.io/package/properties-reader.md) 2.3.0 - [shell-argument-escape](https://npm.io/package/shell-argument-escape.md) 0.1.2 ## Recent versions - 1.9.14 (latest) — 2026-10-27 - 1.9.9-beta (dev) — 2026-07-24 - 1.9.13 — 2026-10-26 - 1.9.12 — 2026-10-23 - 1.9.11 — 2026-10-22 - 1.9.10 — 2026-10-16 - 1.9.9 — 2026-10-16 - 1.9.8 — 2026-06-12 - 1.9.7 — 2026-03-12 - 1.9.6 — 2026-02-20 - 1.9.5 — 2025-11-18 - 1.9.4 — 2025-11-06 - 1.9.2 — 2025-10-14 - 1.9.1 — 2025-08-18 - 1.9.0 — 2025-08-06 - … 86 more at https://npm.io/package/@wavemaker/wm-reactnative-cli/versions ## README # wm-reactnative-cli A command line utility to build react native apps created using WaveMaker product. The main goal of wm-reactnative-cli is to simplify generation of APK or IPA for WaveMaker developers. ```wm-reactnative-cli``` combines multiple react-native commands into a single command. First, one has to make sure all the required hardware and software are available and installed. Then execute the command with the appropriate values for arguments. > [!NOTE] > wm-reactnative supports both AI and Classic (non-ai) projects. ### Command to Install ~~~ npm install -g @wavemaker/wm-reactnative-cli ~~~ ### Adding Environment Variable #### For Windows - Go to System Setting and Select Environment Variables. ![Windows System settings](./assets/EnvironmentVariable.png) - Select New Variable under the System section and add `WM_REACTNATIVE_CLI` and its respective path. ![CLI System Variable](./assets/CLI-EnvironmentVariable.png) #### For Linux/MAC - use nano ~/.bashrc then add the following at the end of the file (after updating the paths) and save it. ~~~ export WM_REACTNATIVE_CLI="$HOME/cli/" ~~~ **_NOTE:_** To avoid cmake errors caused due to long paths in Windows, we suggest making the cli path shorter using this variable ## Android Build ### Requirements - Linux or MAC or Windows - Node 22.22.3 ([https://nodejs.org/en/download/](https://nodejs.org/en/download/)) - GIT ([https://git-scm.com/download](https://git-scm.com/download)) - Java 17 ([https://openjdk.org/install/](https://openjdk.org/install/)) - Yarn (npm install -g yarn) - Gradle 8 ([https://gradle.org/releases/](https://gradle.org/releases/)) - Make sure JAVA_HOME, ANDROID_SDK and GRADLE_HOME are set in the environment variables and also in PATH. #### Adding Environment Variables #### For Windows - Go to System Setting and Select Environment Variables. ![Windows System settings](./assets/EnvironmentVariable.png) - Select New Variable under the System section and add variables and their respective paths. ![New System Variable](./assets/EnvironmentVariable1.png) #### For Linux/MAC - use nano ~/.bashrc then add the following at the end of the file (after updating the paths) and save it. ~~~ export JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64" export ANDROID_HOME="/usr/lib/android-sdk" export ANDROID_SDK="/usr/lib/android-sdk" export ANDROID_SDK_ROOT="/usr/lib/android-sdk" export GRADLE_HOME="$HOME/gradle/gradle-8.2.1" ~~~ ### Command wm-reactnative build android [additional_arguments] |                   **Argument**                   | **Description** | |--|--| | **src_dir** | **DEFAULT:** current working directory.
Path to the reactnative expo zip (or) path to the reactnative expo project folder. | |**\-\-dest**|**OPTIONAL:** directory where the app has to be copied and built. If it is not specified then .wm-reactnative-cli folder inside the home directory, will contain the build folders | |**\-\-auto-eject**|**OPTIONAL:** On setting this flag to true, expo eject will be invoke automatically.| |**\-\-aKeyStore**|Absolute path of the key store. If keystore is not given then android debug key is used.| |**\-\-aStorePassword**|Password to key store| |**\-\-aKeyAlias**|Alias name of the key| |**\-\-aKeyPassword**|Key Password| |**\-\-buildType**|**DEFAULT:** development
development or production
Use ‘production’ with keystore specified.| |**\-\-architecture**|Specifies the target Application Binary Interfaces (ABIs) for the build.
**DEFAULT:** All
**CHOICES:** armeabi-v7a, arm64-v8a, x86, x86_64.
**Example for single ABI:** --architecture=armeabi-v7a
**Example for multiple ABIs:** --architecture=armeabi-v7a --architecture=arm64-v8a | |**\-\-verbose**|**DEFAULT:** false
if true, then all the logs will be shown in the terminal. | ### Example 1 ~~~ wm-reactnative build android "/path/to/src" ~~~ ### Example 2 ~~~ wm-reactnative build android "/path/to/src" \ --dest="/path/to/dest" \ --aKeyStore="/path/to/file.keystore" \ --aStorePassword="store_password" \ --aKeyAlias="key_alias_name" \ --aKeyPassword="key" \ --buildType="production" --auto-eject=true ~~~ ## IOS build ### Requirements - MAC machine - Latest XCODE - CocoaPods ([https://guides.cocoapods.org/using/getting-started.html#toc_3](https://guides.cocoapods.org/using/getting-started.html#toc_3)) - Node 22.22.3 ([https://nodejs.org/en/blog/release/v12.22.0/](https://nodejs.org/en/download/)) - GIT ([https://git-scm.com/download/mac](https://git-scm.com/download/mac)) - Yarn (npm install -g yarn) - Apple developer or distribution P12 certificates - Provisioning profile - Install wm-reactnative-cli (npm install -g @wavemaker/wm-reactnative-cli) - For development build, development certificate and development provisioning file are required. - For production build, distribution certificate and distribution provisioning file are required. - Use Libre SSL (brew install libressl). Make sure openssl (openssl version) should use Libre ssl. **NOTE:** Before building an app, please make sure that neither iPhone nor iPad is not connected to Mac. ### Command wm-reactnative build ios [additional_arguments] |                   **Argument**                     | **Description** | |--|--| | **src_dir** | **DEFAULT:** current working directory.
Path to the reactnative expo zip (or) path to the reactnative expo project folder. | |**\-\-dest**|**OPTIONAL:** directory where the app has to be copied and built. If it is not specified then .wm-reactnative-cli folder inside the home directory, will contain the build folders | |**\-\-auto-eject**|**OPTIONAL:** On setting this flag to true, expo eject will be invoke automatically.| |**\-\-iCertificate**|Absolute path of P12 certificate location| |**\-\-iCertificatePassword**|Password to unlock the certificate.| |**\-\-iProvisioningFile**|Absolute path of provisioning file| |**\-\-buildType**|**DEFAULT:** development
development or production
Use ‘production’ with an AppStore distribution certificate.| |**\-\-verbose**|**DEFAULT:** false
if true, then all the logs will be shown in the terminal. | ### Example ~~~ wm-reactnative build ios "/path/to/src" \ --iCertificate="/path/to/distribution.p12" \ --iCertificatePassword="unlock_password" \ --iProvisioningFile="/path/to/profile.mobileprovision" \ --buildType="production" ~~~ ## Run web-preview ### Requirements - Node 22.22.3 - GIT ([https://git-scm.com/download](https://git-scm.com/download)) - Yarn (npm install -g yarn) - Expo cli (npm install -g expo-cli@latest) ### Command wm-reactnative run web-preview [additional_arguments] **_NOTE:_** The preview uses the Expo Metro bundler by default. |                   **Argument**                     | **Description** | |--|--| | **preview_url** | app preview url | |**\-\-clean**| With this flag, existing project directory is removed | |**\-\-esbuild**| With this flag, the preview uses the esbuild bundler instead of Expo Metro bundler. Use this for projects on older codegen versions. | |**\-\-metro**| With this flag, the preview uses the Metro split-bundle build. This is the standard preview mode used in Studio. | |**\-\-verbose**|**DEFAULT:** false
if true, then all the logs will be shown in the terminal. | ## Sync ### Requirements - Node 22.22.3 - GIT ([https://git-scm.com/download](https://git-scm.com/download)) - Yarn (npm install -g yarn) - Expo cli (npm install -g expo-cli@latest) ### Command wm-reactnative sync [additional_arguments] |                   **Argument**                     | **Description** | |--|--| | **preview_url** | app preview url | |**\-\-clean**|**DEFAULT:** false
if true, existing project directory is removed | |**\-\-useProxy**|**DEFAULT:** false
if true, then all preview requests are routed through a internal proxy server. | |**\-\-verbose**|**DEFAULT:** false
if true, then all the logs will be shown in the terminal. | After the build is complete: - Locate the directory where the Expo app has been generated in command logs. - Use the cd command to navigate to the generated Expo app directory: ~~~ cd ~~~ ## Expo Preview ### Start the Expo Metro bundler ~~~ npm start ~~~ ## React Native Preview Eject the Expo app to a React Native app by executing the below command (generate android and ios folders) ~~~ npx expo prebuild ~~~ ### Start the React Native Metro bundler ~~~ npx react-native start ~~~ ### Build and run the app on an Android device/emulator ~~~ npx react-native run-android ~~~ ### Build and run the app on an iOS device/simulator ~~~ npx react-native run-ios ~~~ ## Run Expo (Deprecated) ## Run Android (Deprecated) ## Run iOS (Deprecated) ## Additional Information 1. Destination folder path is logged at the start of the build. 2. Build log files are present at /output/logs 3. The artifact built is available at /output//. The complete path is printed in log also. --- _Source: https://npm.io/package/@wavemaker/wm-reactnative-cli · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._