🔧 NitroModules "file not found" error while building

[JustJoostNL]

How were you trying to build the app?

expo run:ios

Full build logs

❌  (node_modules/react-native-quick-crypto/cpp/utils/HybridUtils.cpp:3:10)

  1 | #include "HybridUtils.hpp"
  2 |
> 3 | #include <NitroModules/JSIConverter+ArrayBuffer.hpp>
    |          ^ 'NitroModules/JSIConverter+ArrayBuffer.hpp' file not found
  4 | #include <bit>
  5 | #include <cstring>
  6 | #include <openssl/crypto.h>

Project dependencies

{
  "dependencies": {
    "react-native-quick-crypto": "^1.1.1",
    "react-native-nitro-modules": "0.35.6",
    "expo": "~55.0.18",
    "react-native": "0.83.6",
  }
}

expo-env-info 2.0.12 environment info:
    System:
      OS: macOS 26.4.1
      Shell: 5.9 - /bin/zsh
    Binaries:
      Node: 22.18.0 - ~/.nvm/versions/node/v22.18.0/bin/node
      Yarn: 1.22.22 - ~/.bun/bin/yarn
      npm: 10.9.3 - ~/.nvm/versions/node/v22.18.0/bin/npm
    Managers:
      CocoaPods: 1.16.2 - /opt/homebrew/lib/ruby/gems/3.4.0/bin/pod
    SDKs:
      iOS SDK:
        Platforms: DriverKit 25.4, iOS 26.4, macOS 26.4, tvOS 26.4, visionOS 26.4, watchOS 26.4
      Android SDK:
        API Levels: 36
        Build Tools: 35.0.0, 35.0.1, 36.0.0, 36.1.0
        System Images: android-36 | Google TV ARM 64 v8a, android-36 | Google Play ARM 64 v8a
    IDEs:
      Android Studio: 2025.3 AI-253.30387.90.2532.14935130
      Xcode: 26.4.1/17E202 - /usr/bin/xcodebuild
    npmPackages:
      expo: ~55.0.18 => 55.0.18 
      expo-router: ~55.0.13 => 55.0.13 
      expo-updates: ~55.0.21 => 55.0.21 
      metro: ^0.83.6 => 0.83.6 
      react: 19.2.0 => 19.2.0 
      react-dom: 19.2.0 => 19.2.0 
      react-native: 0.83.6 => 0.83.6 
      react-native-web: ^0.21.2 => 0.21.2 
    Expo Workflow: bare

QuickCrypto Version

1.1.1

Target platforms

iOS

Operating system

MacOS

Can you build the QuickCrypto Example app?

I didn't try (⚠️ your issue might get ignored & closed if you don't try this)

Additional information

• I am using Expo
• I have read the Troubleshooting Guide
• I agree to follow this project's Code of Conduct
• I searched for similar issues in this repository and found none.

[nthtrung09it]

@wh201906 can you plz take a look at that issue 👍

[wh201906]

@nthtrung09it I cannot reproduce this issue on my environment, but it seems like NitroModules/JSIConverter+ArrayBuffer.hpp is not exported as a public header by react-native-nitro-modules and it could be invisible on some Xcode environment.
Could someone try changing #include <NitroModules/JSIConverter+ArrayBuffer.hpp> to #include <NitroModules/JSIConverter.hpp> in node_modules/react-native-quick-crypto/cpp/utils/HybridUtils.cpp and test if it fixes this issue? If so I can make a PR for this fix.

[MarcelSchweichlerKretzmann]

@wh201906 That worked for me

[wh201906]

@MarcelSchweichlerKretzmann Thanks! I've submitted the fix #1022

[boorad]

I'm asking @mrousavy :

Why our example app works but expo breaks:

• Default RN podspec config: Headers/Private is on the QuickCrypto target's HEADER_SEARCH_PATHS (verified in example/ios/Pods/Target Support Files/QuickCrypto/QuickCrypto.debug.xcconfig), so <NitroModules/JSIConverter+ArrayBuffer.hpp> resolves to the private symlink.
• With use_frameworks! (often pulled in by Expo via expo-modules-core), only public modulemap-listed headers are exposed under <NitroModules/...>, and the include fails.

Three fix options:

1. Refactor HybridUtils.cpp to drop the JSIConverter call and use only the public <NitroModules/ArrayBuffer.hpp> API (manual jsi::ArrayBuffer construction). Lines 245, 301, 305, 309, 314, 318 use JSIConverter<std::shared_ptr<ArrayBuffer>>::fromJSI/toJSI.

2. Workaround in QuickCrypto.podspec: add "$(PODS_ROOT)/../../node_modules/react-native-nitro-modules/cpp/jsi" to HEADER_SEARCH_PATHS. Hacky and won't work cleanly under static frameworks either.

3. Upstream fix to nitro: PR adding cpp/jsi/JSIConverter+*.hpp to public_header_files. Cleanest but blocks on Marc.

[wh201906]

Three fix options:

Would #1022 also be a valid fix option?

[mrousavy]

As a general rule of thumb, a Nitro Module shouldn't really use any JSI code on its own.
There are of course rare exceptions, like when you absolutely need very dynamic typing (e.g. if the Node Crypto API expects it) or have variadic parameters, and so on.

If you don't have to use raw JSI, don't.

If you do, then I guess import it via #include <NitroModules/JSIConverter.hpp> instead of the direct JSIConverter+ArrayBuffer.hpp import

[wh201906]

If you don't have to use raw JSI, don't.

I didn't find a better way to get/set the underlying UTF-16 data of JS string losslessly without accessing raw JSI, I thinks it's necessary for #981.

If you do, then I guess import it via #include <NitroModules/JSIConverter.hpp> instead of the direct JSIConverter+ArrayBuffer.hpp import

This should work! I've implemented it in #1022