rainbow-me
[bug] RainbowKit Mobile – No redirect or message when wallet app is not installe
Is there an existing issue for this?
- [x] I have searched the existing issues
RainbowKit Version
2.1.6
wagmi Version
2.12.13
Current Behavior
Description
On mobile browsers (iOS & Android), when a user selects Rainbow Wallet (or MetaMask) from the RainbowKit “Connect Wallet” modal, and the wallet app is not installed, the SDK attempts to open a deep link such as:
rainbow://wc?uri=...
The browser then blocks the attempt with:
Not allowed to launch 'rainbow://...' because a user gesture is required.
After that, nothing happens on the UI: • No message is displayed to the user • No fallback link is shown • No redirect to the App Store / Play Store • No guidance to install the missing wallet
This results in a confusing UX: the user clicks the wallet, and nothing happens.
Expected Behavior
When the Rainbow wallet app is not installed, RainbowKit should:
✔ Detect that the wallet app is not installed ✔ Show an informative message (e.g. “Rainbow Wallet not detected”) ✔ Offer a fallback option: • Redirect to the App Store / Play Store • Or provide a link to install the wallet • Or automatically fall back to the WalletConnect modal
Steps To Reproduce
1. Open any RainbowKit-enabled app on a mobile browser (Safari/Chrome)
2. Ensure Rainbow Wallet is not installed
3. Click Connect Wallet → Rainbow
4. Browser blocks the deep link
5. Nothing else happens
Link to Minimal Reproducible Example (CodeSandbox, StackBlitz, etc.)
No response
Anything else?
Is there any recommended way to fix or work around this behaviour, or plans to add a fallback for users who don’t have the wallet app installed?
