react-native-rename

react-native-rename

Rename react-native app with just one command

This package assumes that you created your react-native project using react-native init or expo bare workflow.

Note: This package does not attempt to properly rename build artifacts such as ios/build or Cocoa Pod installation targets. After renaming your project you should clean, build, and reinstall third party dependencies to get it running properly with the new name.

React Native version support

The actively tested support window is React Native 0.77+.

This package is tested against React Native 0.77.1, 0.81.6, and 0.85.3. Older React Native versions may still work, but they are best effort and are not part of the active test matrix. If you need support for an older version, please open an issue with a reproducible fixture or sample project.

This package requires Node.js 20.19.0 or newer.

Usage

$ npx react-native-rename@latest "new_name"

With custom Bundle Identifier

$ npx react-native-rename@latest "new_name" -b "bundle_identifier"

Example

First, Switch to new branch (optional but recommended)

$ git checkout -b rename-app

Then, Rename your app

$ npx react-native-rename "Travel App"

With custom Bundle Identifier

$ npx react-native-rename "Travel App" -b "com.junedomingo.travelapp"

CLI Options

Name Description -b or --bundleID [value] Set custom bundle identifier for both ios and android eg. "com.example.app" or "com.example". --iosBundleID [value] Set custom bundle identifier specifically for ios. --androidBundleID [value] Set custom bundle identifier specifically for android. -p or --pathContentStr [value] Path and content string that can be used in replacing folders, files and their content. Make sure it doesn't include any special characters. --skipGitStatusCheck Skip git repo status check

Local installation

With Yarn:

$ yarn global add react-native-rename

With npm:

$ npm install react-native-rename -g

Support