FlutterFlow Build Failed

How to fix it

Try these in order — the most common fix is first.

1. 1. Check Pubspec Dependencies

   Copy steps
   1. Go to Project > App Settings > Custom Code > Pubspec Dependencies
   2. Replace exact pins and versions with build metadata such as ^1.2.3+1 with ^1.2.3
   3. Save and rebuild
   Did this fix it? Yes No

2. 2. Remove suspect custom code or Marketplace items

   Copy steps
   1. Temporarily remove the newest custom widget, action or Marketplace item
   2. Rebuild to confirm the cause
   Did this fix it? Yes No

3. 3. Try Local Run or contact support

   Copy steps
   1. Use Local Run on a device for the real error output
   2. Submit a bug report or email support@flutterflow.io if it still fails
   Did this fix it? Yes No

Symptoms

The build fails in test mode, run mode, code download or GitHub push although the project shows no errors or warnings.

Why it happens

• Conflicting or deprecated packages in Pubspec Dependencies
• Custom widget or action that does not compile
• Marketplace item adding a bad dependency
• Platform-side issue after an update

This guide also covers

• flutterflow build failed
• flutterflow build failed no errors
• flutterflow run mode build failure

The same problem in other apps

All export, render & quality loss guides →

• Bubble Can't Deploy to Live ('Behind Live' Error) (Bubble)
• Firebase Deploy Failed (Functions and Hosting) (Firebase)

Other FlutterFlow errors

• FlutterFlow Test Mode Not Loading
• FlutterFlow Firebase Connection and Permission Denied Error
• FlutterFlow Unknown Error Compiling Custom Code
• FlutterFlow Code Export Not Working
• FlutterFlow Version Solving Failed Package Conflict
• Why Is FlutterFlow So Slow
• FlutterFlow Firestore Permission Error in Run Mode
• FlutterFlow App Store and Google Play Release Errors