FlutterFlow Docs
Run Mode

Run Mode is not working.

If you see a black screen with no device pictured (example below):

Please follow these steps:
  • Right-click in the middle of the screen (where the device is usually shown) and select Reload Frame.
  • If this does not work, try changing the device (left side of your screen).
  • If this does not work, try refreshing the page.

I get a gray screen in Run Mode

If you see a device with a gray screen (example below):

Here are some common issues to check for:
  1. 1.
    Verify that you have completed all necessary steps for Firebase setup. Ensure you have added the following cloud permissions for [email protected]: Editor, Cloud Functions Admin, and Service Account User. Here are instructions on how to do this.
  2. 2.
    Regenerate the Firebase config files (Settings & Integrations --> Firebase). If you have changed the name of your FlutterFlow or Firebase project, this step is required.
  3. 3.
    Update your Firebase rules. Here are instructions on how to do this.
  4. 4.
    Double-check your collections and backend queries for setup issues.
  5. 5.
    Ensure you are on the latest version of FlutterFlow by selecting (ctrl/cmd + R). After you have done this, clear your browser cache and log out/in to FlutterFlow.
  6. 6.
    If you are using a custom widget, ensure that the package has web support.
If you have already enabled Firebase, we recommend downloading the code and testing it locally on your machine. This will allow you to identify the exact source of your error. Here are the instructions on how to test your app locally on your machine.

I see a loading spinner in run mode, how do I fix this?

If you see a loading spinner in run mode then please try to run the application once again after updating your project's Firestore rules.
Here are the steps to update Firestore rules:
  • Go to Firestore and then select Settings.
  • Copy the Firestore rules by selecting the copy icon (
  • Next, go to Firebase console and open you application. You can do this using the project list dropdown (
  • Select Firestore Database (
    ) and then select the Rules tab.
  • Paste the copied rules(from FlutterFlow) there.
  • Now return to FlutterFlow and re-run your project
Last modified 22d ago