Compatibility
Version matrix
This library’s published native code is built and tested against the versions below. Match them in your app for a reliable install.
| Package | Version | Notes |
|---|---|---|
react-native-alternate-app-icon | 1.0.0+ | Current release — uses Nitro 0.35.x |
react-native-alternate-app-icon | 0.8.0 | Legacy release — uses Nitro 0.32.x |
react-native-nitro-modules | 0.35.9 | Required for 1.0.0+ |
react-native-nitro-modules | 0.32.0 | Required for 0.9.x |
| React Native | 0.76.0+ | New Architecture (Fabric / TurboModules) |
| Node.js | 18.0.0+ | For CLI, Metro, and local tooling |
The example app in the repo uses React Native 0.84.1 with Nitro Modules 0.35.9.
Nitro toolchain
Native bindings under nitrogen/generated/ are produced with:
| Tool | Version |
|---|---|
| Nitrogen | 0.35.9 (v1.0.0) / 0.32.0 (v0.9.0) |
react-native-nitro-modules (codegen target) | 0.35.9 (v1.0.0) / 0.32.0 (v0.9.0) |
Nitrogen and Nitro Modules releases are paired.
- For v1.0.0+: Uses the 0.35.x line.
- For v0.9.x: Uses the 0.32.x line.
If you maintain a fork or run bun run codegen locally, ensure you match the version used by the library version you are on.
Architecture support
The library is built with Nitro Modules and supports React Native's New Architecture (Fabric and TurboModules).
Platform minimums
| Platform | Notes |
|---|---|
| iOS | iOS 10.3+ for alternate icons; test on a physical device — some recent simulators do not show the post-change alert reliably |
| Android | Standard launcher icon aliases via activity-alias |
Peer dependencies
Your app package.json should include:
{
"dependencies": {
"react-native-alternate-app-icon": "^1.0.0",
"react-native-nitro-modules": "0.35.9"
}
}
Use your package manager’s install command with an explicit Nitro version:
bun add react-native-alternate-app-icon react-native-nitro-modules
Upgrading Nitro later
When this library publishes support for a newer react-native-nitro-modules release, upgrade both packages together, reinstall pods, and rebuild native apps. Do not bump only Nitro Modules while staying on a release that was built for 0.35.x.