FlutterFire configure command is failing with error: 'TimeoutException after 0:00:15.000000: Future not completed' when trying to configure project.

[jozenua]

Describe your environment

Operating System version: MacOs Sequoia 15.0.1
Browser version: Google chrome 129.0.6668.90
Firebase SDK version: 10.14.1
Firebase Product: flutterfire, firestore
Flutter version: 3.24.3 for web
Firebase-cli version: 13.22.0(problem also persists with 13.7.0)

Describe the problem

So I'm having an issue with flutterfire configuring my app to work with its respective prod firebase project.

I merged the codebase that was tied to another firebase project into a new branch to commence the move to prod.

I then created a firestore DB with the tables I needed in the new project, pointed my local gcloud and firebase cli project configs to the prod project and ran the 'flutterfire configure' command.

It runs for a while and then gives me this error: "TimeoutException after 0:00:15.000000: Future not completed" every time I try to overwrite at least one of the files and completely hangs when I don't try to overwrite firebase.json. Also my my app isn't connecting to firestore and is giving me this error: ' [cloud_firestore/unavailable] Failed to get document because the client is offline.', but I'm pretty sure that the issue is related to this configuration issue

So far, I've tried

• manually changing the information in the visible config files(firebase.json, firestore.indexes.json, firestore.rules, etc) to match the new project info
• logging out of both cli environments and then logging back in and trying again
• deleting firebase sdk plugins and running flutter clean(in case there were any saved caches) and starting the config process from scratch all over again( that only seemed to halfway work since it generated the firebase_options.dart and firebase.json files but firebase.json was missing configs for firestore )
• and finally, checking my system for cached project config info(haven't been able to find any yet). There also isn't much documentation on flutterfire and it breaking and the issues I've found so far are different from this one.

I would greatly appreciate any assistance I can get on this issue. Thanks in advance!

[ThaerM]

The timeout and the Firestore error might be related, but I'd troubleshoot them separately before assuming they have the same cause.

Since you're migrating between Firebase projects, I'd start by checking whether the CLI is resolving the correct project and whether the generated Flutter configuration matches it.

1. Verify the active Firebase project

Run:

firebase projects:list
firebase use
firebase --version
flutterfire --version

Then try specifying the project explicitly:

flutterfire configure \
  --project=YOUR_FIREBASE_PROJECT_ID

Replace YOUR_FIREBASE_PROJECT_ID with the actual Firebase project ID, not its display name.

This removes one possible source of confusion when multiple Firebase projects are involved.

2. Run the configuration with verbose logging

flutterfire configure \
  --project=YOUR_FIREBASE_PROJECT_ID \
  --verbose

The important part is identifying which operation times out.

For example:

Where it fails	What I'd investigate
Project discovery	Firebase CLI authentication or API connectivity
App registration	Permissions and existing Firebase app registrations
Configuration generation	Local CLI state or configuration conflicts
Network request	Proxy, VPN, firewall, DNS or connectivity

A timeout alone doesn't tell us which of these is responsible.

3. Check the generated Firebase options

Since you've migrated from another Firebase project, inspect:

lib/firebase_options.dart
firebase.json

Verify that the generated options refer to the intended project.

In Flutter, initialization should use the generated options:

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );

  runApp(const MyApp());
}

Make sure the required Firebase imports are present.

4. Verify Firestore independently

Once configuration succeeds, test a simple Firestore read.

try {
  final snapshot = await FirebaseFirestore.instance
      .collection('test')
      .limit(1)
      .get(const GetOptions(source: Source.server));

  debugPrint('Documents: ${snapshot.docs.length}');
} on FirebaseException catch (e) {
  debugPrint('Firebase error: ${e.code}');
  debugPrint('Message: ${e.message}');
}

This explicitly requests data from the server rather than relying on cached results.

Also verify that Firestore is enabled in the correct Firebase project.

5. Check the environment

If the timeout continues:

• Try a different network.
• Temporarily disconnect any VPN or proxy, if allowed.
• Verify access to Firebase and Google APIs.
• Confirm the CLI has permission to access the target project.
• Try the same configuration in a clean Flutter project.

A couple of questions

1. Does the timeout happen during project discovery or while registering the Firebase app?
2. Does firebase projects:list successfully display the new production project?
3. Does the same problem happen on another network?

The verbose output around the timeout should help identify the next step.