Installation

Install the package together with its required peer dependency. Pin react-native-nitro-modules to 0.32.0 — see Compatibility for the full version matrix.

bun

bun add react-native-alternate-app-icon react-native-nitro-modules@0.32.0

npm

npm install react-native-alternate-app-icon react-native-nitro-modules@0.32.0

yarn

yarn add react-native-alternate-app-icon react-native-nitro-modules@0.32.0

iOS — CocoaPods

After installing JavaScript dependencies, install native pods:

cd ios && pod install

Rebuild native apps

Icon changes require native configuration. After setup, rebuild your app:

bun

# iOS
bunx react-native run-ios

# Android
bunx react-native run-android

npm

# iOS
npx react-native run-ios

# Android
npx react-native run-android

yarn

# iOS
yarn react-native run-ios

# Android
yarn react-native run-android

Next steps

Platform-specific setup is required before setIcon() will work:

• iOS setup
• Android setup

See the compatibility page for version requirements.