Home › Build error fixes › iOS / Xcode

Header/module not found

iOS / Xcode · last reviewed 2026-11-10

The error looks like this

'React/RCTBridgeModule.h' file not found

Why it happens

Most often the .xcodeproj was opened instead of the .xcworkspace, or pods are not installed.

How to fix it

  1. Close Xcode, run cd ios && pod install.
  2. Open the .xcworkspace file.
  3. Product > Clean Build Folder, build again.

Not sure this is your error? Let ReleaseMedic read the whole log

Build logs are long and the last line is rarely the real cause. ReleaseMedic finds the first real error, explains it and gives the steps — free, and the log never leaves your computer.

$ npx releasemedic log build.log

Or pipe a build straight in: cd android && ./gradlew bundleRelease 2>&1 | npx releasemedic log -

Catch it before you build

Most release errors come from project settings you can check in seconds — signing, SDK levels, privacy manifests, permissions, push and login setup.

$ npx releasemedic

Related iOS / Xcode errors