Why are my Flutter iOS builds failing with "Scheme 'staging' not found" and how do I fix it?
Last updated: December 17, 2025
Context
When running Flutter iOS builds in CI, you may see the error: Scheme "staging" not found from repository! This typically happens when the Xcode scheme isn’t shared (and therefore not committed to your repository), or when dependencies aren’t fetched before the build runs.
Answer
Follow these steps to resolve the error:
Open your iOS project in Xcode
From your Flutter project, open ios/Runner.xcworkspace (or Runner.xcodeproj) in Xcode.
Verify the "staging" scheme exists and is shared
In Xcode, go to Product → Scheme → Manage Schemes…
Ensure there is a scheme named
staging.Select the staging scheme and check the Shared checkbox.
Close the dialog and make sure the changes create/update files under ios/Runner.xcodeproj/xcshareddata/xcschemes/ (or the workspace’s xcshareddata). Commit these files to your repository so CI can access the scheme.
Ensure dependencies are installed in CI
Add a step that runs Flutter dependency installation before building. For example, add this to your Post-clone script (the very first script at the top):
flutter pub get