Module 'x' not found (iOS build) Flutter / Dart Origin: On your device OSI layer 7 · Application Last updated 4 Nov 2026

Xcode: Module 'firebase_core' not found — flutter build ios fails after adding a plugin

The iOS project cannot find a CocoaPods module, usually because Pods are missing, outdated, or the workspace was not used.

Exact message you may see Module 'firebase_core' not foundModule not found Flutter iOS buildXcode build failed Module not foundfatal error: module 'Flutter' not foundCould not build the application for the simulator Module not found
Seen on: Flutter iOS

Meaning

After adding plugins run pod install in ios/, open Runner.xcworkspace (not .xcodeproj), and clean stale artifacts. On Apple Silicon, mismatched architectures or an old Podfile.lock can also trigger this.

Common causes

  • pod install not run after pub get
  • Opening Runner.xcodeproj instead of the workspace
  • Stale Pods/Podfile.lock
  • Deployment target lower than the plugin requires
  • Architecture mismatch on Apple Silicon

⚡ Quick fix

  1. flutter clean && flutter pub get && cd ios && pod install --repo-update
  2. Open Runner.xcworkspace
  3. Raise the iOS deployment target in the Podfile

Detailed fix by platform

Flutter

  1. cd ios && rm -rf Pods Podfile.lock && pod install --repo-update

How to diagnose

  1. Workspace — Using .xcworkspace?
  2. Pods — Installed?
  3. Target — iOS version high enough?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: On your device. Errors that are often confused with or caused by this one (click to open):

Android license status unknown / licenses not accepted — flutter doctor: Android license status unknown. Run `flutter doctor --android-licenses` to accept the SDK licenses (Flutter / Dart)Android license statu…App Transport Security has blocked a cleartext HTTP load — iOS: The resource could not be loaded because the App Transport Security policy requires the use of a secure connection (NSURLErrorDomain -1022) (Flutter / Dart)App Transport Securit…BoxConstraints forces an infinite width — Flutter: BoxConstraints forces an infinite width. These invalid constraints were provided to RenderStack's layout() function (TextField in a Row) (Flutter / Dart)BoxConstraints forces…CDN: trunk URL couldn't be downloaded — [!] CDN: trunk URL couldn't be downloaded: https://cdn.cocoapods.org/... (iOS)CDN: trunk URL couldn…CocoaPods compatible versions — CocoaPods could not find compatible versions for pod (iOS)CocoaPods compatible …CocoaPods: pod install failed / not installed — Flutter iOS: Error running pod install — CocoaPods not installed or out of date / [!] CocoaPods could not find compatible versions for pod (Flutter / Dart)CocoaPods: pod instal…Dependency requires compileSdk 34 or later — Android Gradle: Execution failed for task ':app:checkDebugAarMetadata'. Dependency requires libraries and applications that depend on it to compile against version 34 or later of the Android APIs (Flutter / Dart)Dependency requires c…library not found for -lPods — ld: library not found for -lPods-AppName / framework not found Pods_App (iOS)library not found for…Module 'x…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.