ProjectAJ14 · Sep 6, 2026 · Sep 6, 2026 · Sep 6, 2026
diff --git a/packages/nonstop_cli/CHANGELOG.md b/packages/nonstop_cli/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 0.0.8+2
+
+ - **FIX**(nonstop_cli): boot apps before flutterfire configure.
+
 ## 0.0.8+1
 
  - Update a dependency to the latest release.

diff --git a/packages/nonstop_cli/README.md b/packages/nonstop_cli/README.md
@@ -154,8 +154,9 @@ youtube/
 
 The generated workspace is bootstrapped, formatted and passes its own
 `melos lint` and `melos test` before you touch it. If you picked any Firebase
-module, run `flutterfire configure` in the app directory - the generated
-`firebase_options.dart` throws until you do.
+module, run `flutterfire configure` in the app directory when you want those
+features live. Until then the app still runs; Firebase-backed modules are
+skipped at startup.
 
 </details>
 

diff --git a/...ricks/flutter_project_with_mono_repo/__brick__/{{ name.snakeCase() }}/README.md b/...ricks/flutter_project_with_mono_repo/__brick__/{{ name.snakeCase() }}/README.md
@@ -45,8 +45,8 @@ melos bootstrap
 {{#firebase}}
 ### Firebase
 
-This project uses Firebase, so configure it before the first run - the
-generated `lib/firebase_options.dart` deliberately throws until you do:
+This project uses Firebase, so run this before those features will work.
+The rest of the app still boots without it:
 
 ```sh
 dart pub global activate flutterfire_cli

diff --git a/..._with_mono_repo/__brick__/{{ name.snakeCase() }}/apps/{{ name.snakeCase() }}/lib/app.dart b/..._with_mono_repo/__brick__/{{ name.snakeCase() }}/apps/{{ name.snakeCase() }}/lib/app.dart
@@ -24,6 +24,7 @@ class _AppState extends State<App> {
     // sign-in once you would rather ask a user who has committed to the app.
     _lifecycleListener = AppLifecycleListener(onResume: _clearBadge);
     WidgetsBinding.instance.addPostFrameCallback((_) async {
+      if (!di.has<NotificationClient>()) return;
       final logger = di.get<Logger>();
       try {
         await di.get<NotificationClient>().init();
@@ -34,6 +35,7 @@ class _AppState extends State<App> {
 {{/notifications}}  }
 {{#notifications}}
   void _clearBadge() {
+    if (!di.has<NotificationClient>()) return;
     final logger = di.get<Logger>();
     try {
       di.get<NotificationClient>().clearBadge();

diff --git a/...mono_repo/__brick__/{{ name.snakeCase() }}/apps/{{ name.snakeCase() }}/lib/bootstrap.dart b/...mono_repo/__brick__/{{ name.snakeCase() }}/apps/{{ name.snakeCase() }}/lib/bootstrap.dart
@@ -17,7 +17,8 @@ import 'package:core/core.dart' as core;
 ///
 /// Order matters: the logger is registered first so everything after it can
 /// report failures, and Firebase must be live before any Firebase-backed
-/// module initialises.
+/// module initialises. If `flutterfire configure` has not been run yet, those
+/// modules are skipped so the rest of the app still boots.
 Future<void> init() async {
   WidgetsFlutterBinding.ensureInitialized();
   final stopwatch = Stopwatch()..start();
@@ -28,32 +29,47 @@ Future<void> init() async {
 
   Bloc.observer = core.CoreBlocObserver();
 {{#firebase}}
-  final options = DefaultFirebaseOptions.currentPlatform;
-  await Firebase.initializeApp(options: options);
-
-  if (core.Environment.useEmulators) {
-    await emulators.init();
+  var firebaseReady = false;
+  try {
+    final options = DefaultFirebaseOptions.currentPlatform;
+    await Firebase.initializeApp(options: options);
+    firebaseReady = true;
+    if (core.Environment.useEmulators) {
+      await emulators.init();
+    }
+  } on UnsupportedError catch (error) {
+    logger.w('$error');
   }
+  logger.i(
+    firebaseReady
+        ? 'Firebase ready'
+        : 'Firebase not configured yet; skipping Firebase modules',
+  );
 {{/firebase}}
-{{#crashlytics}}  await crashlytics.init();
-{{/crashlytics}}{{#analytics}}  await analytics.init();
-{{/analytics}}{{#feature_flags}}  await feature_flags.init();
+{{#crashlytics}}  if (firebaseReady) await crashlytics.init();
+{{/crashlytics}}{{#analytics}}  if (firebaseReady) await analytics.init();
+{{/analytics}}{{#feature_flags}}  if (firebaseReady) await feature_flags.init();
 {{/feature_flags}}{{#auth}}
-  final clientId = options.iosClientId ?? options.androidClientId ?? '';
-  await auth.init(auth.DefaultAuthConfig(clientId: clientId));
+  if (firebaseReady) {
+    final options = DefaultFirebaseOptions.currentPlatform;
+    final clientId = options.iosClientId ?? options.androidClientId ?? '';
+    await auth.init(auth.DefaultAuthConfig(clientId: clientId));
+  }
 {{/auth}}{{#network}}
   await network.init(
     config: network.DefaultNetworkConfig(baseUrl: core.Environment.baseUrl),
   );
 {{/network}}{{#notifications}}
-  await notifications.init();
+  if (firebaseReady) await notifications.init();
 {{/notifications}}
   // TODO: initialise your own feature modules here.
 
   stopwatch.stop();
   logger.i('Bootstrap completed in ${stopwatch.elapsedMilliseconds} ms');
 {{#analytics}}
-  await analytics.AnalyticsHelper.logAppOpen(
-    parameters: {'bootstrap_duration': stopwatch.elapsedMilliseconds},
-  );
+  if (firebaseReady) {
+    await analytics.AnalyticsHelper.logAppOpen(
+      parameters: {'bootstrap_duration': stopwatch.elapsedMilliseconds},
+    );
+  }
 {{/analytics}}}
diff --git a/..._repo/__brick__/{{ name.snakeCase() }}/apps/{{ name.snakeCase() }}/lib/router/router.dart b/..._repo/__brick__/{{ name.snakeCase() }}/apps/{{ name.snakeCase() }}/lib/router/router.dart
@@ -5,7 +5,8 @@
 {{/dashboard}}import 'package:design_system/design_system.dart';
 {{#developer}}import 'package:developer/developer.dart' as developer;
 {{/developer}}import 'package:di/di.dart';
-import 'package:flutter/foundation.dart';
+{{#analytics}}import 'package:firebase_core/firebase_core.dart';
+{{/analytics}}import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:go_router/go_router.dart';
 import 'package:localization/localization.dart';
@@ -36,7 +37,7 @@ class AppRouter {
       observers: [
         NavigationHistoryObserver(),
         core.CoreRouteObserver(),
-{{#analytics}}        AnalyticsRouteObserver(),
+{{#analytics}}        if (Firebase.apps.isNotEmpty) AnalyticsRouteObserver(),
 {{/analytics}}      ],
       errorBuilder: (context, state) => ErrorScreen(
         title: strings.errors.page_not_found,

diff --git a/...po/__brick__/{{ name.snakeCase() }}/apps/{{ name.snakeCase() }}/lib/ui/splash_screen.dart b/...po/__brick__/{{ name.snakeCase() }}/apps/{{ name.snakeCase() }}/lib/ui/splash_screen.dart
@@ -28,7 +28,8 @@ class _SplashScreenState extends State<SplashScreen> {
   Future<void> _redirect() async {
     if (!mounted) return;
 {{#auth}}
-    if (!di.get<auth.AuthService>().isSignedIn) {
+    if (di.has<auth.AuthService>() &&
+        !di.get<auth.AuthService>().isSignedIn) {
       context.go(auth.AuthRoutes.signIn);
       return;
     }

diff --git a/....snakeCase() }}/lib/firebase_options.dart → ...keCase() }}/lib/{{firebase_options_file}} b/....snakeCase() }}/lib/firebase_options.dart → ...keCase() }}/lib/{{firebase_options_file}}
@@ -1,9 +1,11 @@
-{{#firebase}}// This file is a placeholder. Generate the real one with:
+// This file is a placeholder. Generate the real one with:
 //
 //   cd apps/{{name.snakeCase()}} && flutterfire configure
 //
 // FlutterFire overwrites this file with your project's options and also drops
 // google-services.json / GoogleService-Info.plist into the native folders.
+// Until then, bootstrap catches the throw and skips Firebase-backed modules
+// so the rest of the app still runs.
 import 'package:firebase_core/firebase_core.dart' show FirebaseOptions;
 
 class DefaultFirebaseOptions {
@@ -14,4 +16,4 @@ class DefaultFirebaseOptions {
     'Run `flutterfire configure` inside apps/{{name.snakeCase()}} '
     'to replace lib/firebase_options.dart.',
   );
-}{{/firebase}}
+}
diff --git a/...h_mono_repo/__brick__/{{ name.snakeCase() }}/features/{{auth_dir}}/lib/router/router.dart b/...h_mono_repo/__brick__/{{ name.snakeCase() }}/features/{{auth_dir}}/lib/router/router.dart
@@ -41,6 +41,8 @@ final class GoAuthRoute extends GoRoute {
     super.pageBuilder,
   }) : super(
          redirect: (context, state) async {
+           if (!di.has<AuthService>()) return null;
+
            final authService = di.get<AuthService>();
 
            if (!authService.isSignedIn) {

diff --git a/.../{{ name.snakeCase() }}/features/{{dashboard_dir}}/lib/ui/screens/profile_tab_screen.dart b/.../{{ name.snakeCase() }}/features/{{dashboard_dir}}/lib/ui/screens/profile_tab_screen.dart
@@ -60,6 +60,7 @@ class ProfileTabScreen extends StatelessWidget {
     );
 
     if (confirmed != true || !context.mounted) return;
+    if (!di.has<auth.AuthService>()) return;
 
     await di.get<auth.AuthService>().signOut();
     if (context.mounted) context.go(auth.AuthRoutes.signIn);

diff --git a/packages/nonstop_cli/bricks/flutter_project_with_mono_repo/hooks/commands/module_vars.dart b/packages/nonstop_cli/bricks/flutter_project_with_mono_repo/hooks/commands/module_vars.dart
@@ -46,9 +46,14 @@ void resolveModuleVars(HookContext context) {
   final usesFirebase =
       _firebaseBackedModules.any((module) => _flag(context, module));
   context.vars['firebase'] = usesFirebase;
+  // Empty path segment → mason skips the file, so a project with no Firebase
+  // modules never ships a placeholder `firebase_options.dart`.
+  context.vars['firebase_options_file'] =
+      usesFirebase ? 'firebase_options.dart' : '';
 
-  // The boot test runs the real bootstrap, which a Firebase project cannot do
-  // until `flutterfire configure` has been run. An empty file name makes mason
-  // skip the file, so those projects simply ship without it.
+  // The boot test runs the real bootstrap. Firebase projects can boot before
+  // `flutterfire configure` now (those modules are skipped), but after
+  // configure the splash may land on sign-in instead of the dashboard, so
+  // they still don't ship this file.
   context.vars['smoke_test_file'] = usesFirebase ? '' : 'smoke_test.dart';
 }
diff --git a/.../nonstop_cli/bricks/flutter_project_with_mono_repo/hooks/commands/next_steps_command.dart b/.../nonstop_cli/bricks/flutter_project_with_mono_repo/hooks/commands/next_steps_command.dart
@@ -16,7 +16,7 @@ final class NextStepsCommand extends CliCommand {
         ..info('  dart pub global activate flutterfire_cli')
         ..info('  cd $appName/apps/$appName && flutterfire configure')
         ..info(
-          '  (until then lib/firebase_options.dart throws on purpose)',
+          '  (the app still runs; Firebase features stay off until then)',
         );
     }