General Troubleshooting Steps
Before addressing specific issues, try these general troubleshooting steps for both React Native and Expo projects:Clear Cache and Dependencies
Clear Cache and Dependencies
Rebuild iOS and Android folders (Expo)
Rebuild iOS and Android folders (Expo)
bash expo prebuild --clean Rebuild the project
Rebuild the project
Common Issues and Solutions
Missing Polyfills
Missing Polyfills
Error: Errors related to missing modules like
crypto, buffer, or stream.Solution: Update your metro.config.js to include necessary polyfills:Incomplete Shims
Incomplete Shims
Error: Errors persist despite Metro configuration, often related to global objects.Solution: Create a
shim.js file at the root of your project and import it in your entry file.For the complete shim.js setup, refer to the Polyfills and Shims section in the and setup guides.Missing Crypto Subtle API
Missing Crypto Subtle API
Error: Errors related to You can register both debug and release fingerprints in the Developer Portal to avoid this issue across build types.
crypto.subtle API or missing cryptographic functions.Solution: Add the PolyfillCrypto component to your root App component.Android: User Cancelled / No Credentials Available
Android: User Cancelled / No Credentials Available
Error:
UserCancelled or NoCredentialsSolutions:UserCancelled: The user dismissed the passkey prompt. This is expected behavior — handle it gracefully in your app by catching the error and allowing the user to retry.NoCredentials: No passkeys are stored on this device for the user. This typically means the user hasn’t registered a passkey yet or is on a different device than where the passkey was created. Ensure your auth flow callsregisterPasskey()for new users before attemptingloginWithPasskey().
iOS: Passkey Request Failed (Error 1004)
iOS: Passkey Request Failed (Error 1004)
Error:
RequestFailed from ASAuthorizationThis iOS error indicates the passkey operation failed at the system level.Common causes:- The associated domains entitlement is not configured correctly in Xcode (or
app.jsonfor Expo). - Your
teamId + bundleIdentifieris not registered with Para. - The device cannot reach Apple’s CDN to validate the Apple App Site Association file.
webcredentials:app.beta.usecapsule.com and webcredentials:app.usecapsule.com, and confirm your Team ID + Bundle ID is registered in the .Keychain Decryption Error After Rebuild
Keychain Decryption Error After Rebuild
Error:
com.oblador.keychain.exceptions.CryptoFailedException: Decryption failed: Authentication tag verification failed.This is expected during development when you rebuild or reinstall the app. The previous keychain data was encrypted with a key tied to the old app installation.Solution: Clear the app data or uninstall and reinstall the app. This will not affect production users since they won’t be reinstalling the app during normal use.Expo Go Limitations
Expo Go Limitations
Error: Native modules not working in Expo Go.Solution: Para is reliant on native modules and will not work with Expo Go. Use Expo’s build service to create a standalone app. You can do this by running
expo build:ios or expo build:android. This will create the corresponding iOS or Android folders in your project and link the native modules correctly. Alternative use expo prebuild to create the native folders for both platforms.Pod Linking Issues
Pod Linking Issues
Error: Native modules not linking correctly. Build errors related to missing pods. Build stalls at the linking stage.Solution: iOS in React Native projects requires manual linking of pods. Ensure the pods are correctly linked by running
pod install in the ios directory. Expo auto links the pods, but you can run expo prebuild --clean to ensure the pods are correctly linked.Storage-Related Errors
Storage-Related Errors
Best Practices
- Implement robust error handling for all Para operations.
- Use secure storage methods for sensitive data.
- Keep your project’s native code up to date with the latest Para SDK requirements.
Integration Support
If you’re experiencing issues that aren’t resolved by our troubleshooting resources, please contact our team for assistance. To help us resolve your issue quickly, please include the following information in your request:- 1
A detailed description of the problem you’re encountering.
- 2
Any relevant error messages or logs.
- 3
Steps to reproduce the issue.
- 4
Details about your system or environment (e.g., device, operating system, software version).