Skip to content

docs: troubleshoot 'QuickBase64 could not be found' (New Arch requirement)#1063

Merged
boorad merged 1 commit into
mainfrom
fix/document-new-arch-requirement
Jul 8, 2026
Merged

docs: troubleshoot 'QuickBase64 could not be found' (New Arch requirement)#1063
boorad merged 1 commit into
mainfrom
fix/document-new-arch-requirement

Conversation

@boorad

@boorad boorad commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator

Summary

Documents the TurboModuleRegistry.getEnforcing(...): 'QuickBase64' could not be found crash reported in #1052.

The error originates in react-native-quick-base64, a required dependency of react-native-quick-crypto. As of 3.0.0, react-native-quick-base64 is a pure C++ TurboModule that only registers under the New Architecture (it has no Old Architecture registration path). Since react-native-quick-crypto 1.x imports it at startup, an app running on the Old Architecture crashes on launch.

This is a documentation fix. No runtime change is required in react-native-quick-crypto: the requirement is inherent to targeting the New Architecture. The upstream from-source build bug and README note were handled separately in craftzdog/react-native-quick-base64#55.

Changes

  • Add a QuickBase64 could not be found section to .docs/troubleshooting.md covering:
    • Why it happens (pure C++ TurboModule, New Architecture only).
    • Fix: enable New Architecture (bare RN and Expo) and clean rebuild.
    • Fallback: pin react-native-quick-base64@2.2.2 for Old Architecture apps.
    • Note that the circulating ndkVersion patch targets the old 2.2.2 build.gradle and does not apply to 3.0.0.

Testing

Docs only. Verified upstream that react-native-quick-base64 registers and passes its suite (36/36) under the New Architecture on Android.

Closes #1052

…ment)

react-native-quick-base64 3.0.0+ is a pure C++ TurboModule that only
registers under the New Architecture. As a required dependency of
react-native-quick-crypto, it crashes the app on launch when the
consuming app runs on the Old Architecture. Document the cause and the
fixes (enable New Arch + clean rebuild, or pin quick-base64 2.2.2).

Closes #1052
@boorad boorad self-assigned this Jul 8, 2026
@vercel

vercel Bot commented Jul 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
react-native-quick-crypto Ready Ready Preview, Comment Jul 8, 2026 12:16am

Request Review

@boorad boorad merged commit 8e93758 into main Jul 8, 2026
2 checks passed
@boorad boorad deleted the fix/document-new-arch-requirement branch July 8, 2026 00:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant