junedomingo / react-native-rename

Rename react-native app with just one command
MIT License
2.63k stars 261 forks source link
cli react-native react-native-rename rename

react-native-rename

NPM version NPM monthly downloads

Rename react-native app with just one command

react-native-rename

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.

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

Buy Me A Coffee