react-native-rename-config
Rename react-native app with just one command and more
This package assumes that you created your react-native project using
react-native init
orexpo 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-config@latest "new_name"
With custom Bundle Identifier (or set environment variable called APP_NAME)
npx react-native-rename-config@latest "new_name" -b "bundle_identifier"
With custom icon to replace
npx react-native-rename-config <newName> -i <configPath>
With replace firebase config
npx react-native-rename-config <newName> --firebase-replace <configPath>
Path tree for configPath
.
└── configPath
└── ios
├── GoogleService-Info.plist
├── icon
│ └── AppIcon.appiconset
└── android
├── google-services.json
└── icon
└── android
├── mipmap-anydpi-v26
│ └── ic_launcher.xml
├── mipmap-hdpi
│ ├── ic_launcher_background.png
│ ├── ic_launcher_foreground.png
│ ├── ic_launcher_monochrome.png
│ └── ic_launcher.png
├── mipmap-mdpi
│ ├── ic_launcher_background.png
│ ├── ic_launcher_foreground.png
│ ├── ic_launcher_monochrome.png
│ └── ic_launcher.png
├── mipmap-xhdpi
│ ├── ic_launcher_background.png
│ ├── ic_launcher_foreground.png
│ ├── ic_launcher_monochrome.png
│ └── ic_launcher.png
├── mipmap-xxhdpi
│ ├── ic_launcher_background.png
│ ├── ic_launcher_foreground.png
│ ├── ic_launcher_monochrome.png
│ └── ic_launcher.png
└── mipmap-xxxhdpi
├── ic_launcher_background.png
├── ic_launcher_foreground.png
├── ic_launcher_monochrome.png
└── ic_launcher.png
Example
First, Switch to new branch (optional but recommended)
git checkout -b rename-app
Then, Rename your app
npx react-native-rename-config "Travel App"
With custom Bundle Identifier
npx react-native-rename-config "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-config
With npm:
npm install react-native-rename-config -g