'react/utils/FollyConvert.h' file not found

[tomekzaw]

Describe and reproduce the Bug

Hi, thanks again for this wonderful library!

I'm getting the error 'react/utils/FollyConvert.h' file not found when building 11.0.0-alpha.17 for iOS with USE_FRAMEWORKS=static.

/Users/tomekzaw/MyApp/node_modules/@maplibre/maplibre-react-native/ios/components/map-view/MLRNMapViewComponentView.mm:11:9: fatal error: 'react/utils/FollyConvert.h' file not found
   11 | #import <react/utils/FollyConvert.h>
      |         ^~~~~~~~~~~~~~~~~~~~~~~~~~~~
/Users/tomekzaw/MyApp/node_modules/@maplibre/maplibre-react-native/ios/components/map-view/MLRNMapViewComponentView.mm:11:9: note: did not find header 'utils/FollyConvert.h' in framework 'react' (loaded from '/Users/tomekzaw/Library/Developer/Xcode/DerivedData/OdjazdowyKrk-gckrdcdsftcnfrdojyccguwpqmtq/Build/Products/Debug-iphonesimulator/React-Core')
1 error generated.

I was able to get it working by adding the following lines in MapLibreReactNative.podspec:

  install_modules_dependencies(s)
 
+  add_dependency(s, "React-utils", :additional_framework_paths => [
+    "react/utils/platform/ios",
+  ])
 end

I'm not sure if this should be fixed here or on React Native side.

@maplibre/maplibre-react-native Version

11.0.0-alpha.17

Which platforms does this occur on?

iOS Simulator

Which frameworks does this occur on?

Expo

Which architectures does this occur on?

New Architecture

Environment

expo-env-info 2.0.7 environment info:
    System:
      OS: macOS 15.7.2
      Shell: 5.9 - /bin/zsh
    Binaries:
      Node: 20.19.4 - ~/.nvm/versions/node/v20.19.4/bin/node
      Yarn: 1.22.22 - /opt/homebrew/bin/yarn
      npm: 10.8.2 - ~/.nvm/versions/node/v20.19.4/bin/npm
      Watchman: 2025.11.10.00 - /opt/homebrew/bin/watchman
    Managers:
      CocoaPods: 1.15.2 - /Users/tomekzaw/.rbenv/shims/pod
    SDKs:
      iOS SDK:
        Platforms: DriverKit 25.1, iOS 26.1, macOS 26.1, tvOS 26.1, visionOS 26.1, watchOS 26.1
      Android SDK:
        API Levels: 30, 31, 33, 34, 35, 36
        Build Tools: 30.0.2, 30.0.3, 31.0.0, 33.0.0, 33.0.1, 34.0.0, 35.0.0, 36.0.0
        System Images: android-33 | Google APIs ARM 64 v8a, android-34 | Google APIs ARM 64 v8a, android-35 | Google Play ARM 64 v8a, android-36 | Google APIs ARM 64 v8a, android-36 | Google Play ARM 64 v8a
    IDEs:
      Android Studio: 2025.2 AI-252.25557.131.2521.14344949
      Xcode: 26.1/17B55 - /usr/bin/xcodebuild

[KiwiKilian]

Thanks for the report! Which Expo and React Native versions are you using?

Did you eject/prebuilt once and modified this env or is it default for Expo?

[tomekzaw]

Currently I'm on React Native 0.81.4 and Expo 54.0.20.

I'm setting USE_FRAMEWORKS=static via expo-build-properties config plugin in app.json (as recommended in https://docs.expo.dev/versions/latest/sdk/build-properties/):

[
  "expo-build-properties",
  {
    "ios": {
      "useFrameworks": "static"
    }
  }
],

But I think the issue still persists without this setting (I think I was able to reproduce it also without USE_FRAMEWORKS=static).

[NikolakoG]

This happens with rn 0.82.1 and no expo too. I also use use_frameworks! :linkage => :static.

[KiwiKilian]

Could you both elaborate why you are setting this? Trying to decide how we should fix this.

[tomekzaw]

@KiwiKilian In most setups, USE_FRAMEWORKS=static is forced by Firebase:

For iOS only, since firebase-ios-sdk requires use_frameworks then you want to configure expo-build-properties app.json by adding "useFrameworks": "static". See the example configuration below.

https://rnfirebase.io/#configure-react-native-firebase-modules

[KiwiKilian]

I think we need to change something, feel free to investigate and to create a PR. These issues are similar, but I think still different, as we are only supporting new Arch with v11:

• Not building in Android & iOS For React Native 81.0 in new arch. rnmapbox/maps#3938
• RN 0.81 + use_frameworks! :linkage => :static → 'react/utils/FollyConvert.h' file not found stripe/stripe-react-native#2065

So our fix might only about adding the dependency, but not 100% sure yet.

[NikolakoG]

Removing the import in MLRNMapViewComponentView.mm and adding the function from Folly directly to the file fixes it.
I attach the patch for the actual code.

@maplibre+maplibre-react-native+11.0.0-alpha.17.patch