feat!: change homeEntry to an onComplete callback

Breaking: this changes the startNavigatorUserStory interface without any backwards compatibility

example/lib/main.dart

@@ -20,8 +20,15 @@ class Home extends StatelessWidget {
   const Home({super.key});
 
   @override
-  Widget build(BuildContext context) =>
+  Widget build(BuildContext context) => startNavigatorUserStory(
-      startNavigatorUserStory(config, context);
+        context,
+        config,
+        onComplete: (context) async {
+          await Navigator.of(context).pushReplacement(
+            MaterialPageRoute(builder: (context) => const HomeEntry()),
+          );
+        },
+      );
 }
 
 List<GoRoute> getStartRoutes() => getStartStoryRoutes(
@@ -33,7 +40,6 @@ StartUserStoryConfiguration config = StartUserStoryConfiguration(
   splashScreenBuilder: (context, onFinish) => SplashScreen(
     onFinish: onFinish,
   ),
-  homeEntry: const HomeEntry(),
   introductionOptionsBuilder: (ctx) => IntroductionOptions(
     pages: [
       IntroductionPage(

lib/src/models/start_configuration.dart

@@ -12,7 +12,6 @@ class StartUserStoryConfiguration {
     this.introductionBuilder,
     this.introductionOptionsBuilder,
     this.introductionService,
-    this.homeEntry,
     this.homeScreenRoute,
     this.introductionFallbackScreen,
     this.introductionScrollPhysics,
@@ -41,8 +40,6 @@ class StartUserStoryConfiguration {
   /// The route that is used to navigate to the home screen.
   final String? homeScreenRoute;
 
-  final Widget? homeEntry;
-
   final IntroductionOptions Function(BuildContext context)?
       introductionOptionsBuilder;
   final Widget? introductionFallbackScreen;

lib/src/user_stories/flutter_start_userstory_navigator.dart

@@ -4,21 +4,32 @@ import 'package:flutter/material.dart';
 import 'package:flutter_start/flutter_start.dart';
 import 'package:flutter_start/src/services/killswitch_service.dart';
 
+/// Enter the start user story with the Navigator 1.0 API.
+///
+/// Requires a Navigator widget to exist in the given [context].
+///
+/// Customization can be done through the [configuration] parameter.
+///
+/// [onComplete] triggers as soon as the userstory is finished.
+///
+/// The context provided here is a context has a guaranteed navigator.
 Widget startNavigatorUserStory(
-  StartUserStoryConfiguration configuration,
   BuildContext context,
-) {
+  StartUserStoryConfiguration configuration, {
+  required void Function(BuildContext context) onComplete,
+}) {
   if (configuration.splashScreenBuilder == null &&
       configuration.splashScreenCenterWidget == null &&
       configuration.splashScreenBackgroundColor == null) {
-    return _introduction(configuration, context);
+    return _introduction(configuration, context, onComplete);
   }
-  return _splashScreen(configuration, context);
+  return _splashScreen(configuration, context, onComplete);
 }
 
 Widget _splashScreen(
   StartUserStoryConfiguration configuration,
   BuildContext context,
+  void Function(BuildContext context) onComplete,
 ) {
   var navigator = Navigator.of(context);
 
@@ -59,18 +70,18 @@ Widget _splashScreen(
 
     if ((!configuration.showIntroduction || introductionSeen) &&
         context.mounted) {
-      await navigator.pushReplacement(
+      onComplete(context);
-        MaterialPageRoute(
-          builder: (context) => _home(configuration, context),
-        ),
-      );
       return;
     }
 
     if (context.mounted) {
       await navigator.pushReplacement(
         MaterialPageRoute(
-          builder: (context) => _introduction(configuration, context),
+          builder: (context) => _introduction(
+            configuration,
+            context,
+            onComplete,
+          ),
         ),
       );
     }
@@ -98,15 +109,12 @@ Widget _splashScreen(
 Widget _introduction(
   StartUserStoryConfiguration configuration,
   BuildContext context,
+  void Function(BuildContext context) onComplete,
 ) {
   var introduction = Introduction(
     service: configuration.introductionService ??
         IntroductionService(SharedPreferencesIntroductionDataProvider()),
-    navigateTo: () async => Navigator.of(context).pushReplacement(
+    navigateTo: () async => onComplete(context),
-      MaterialPageRoute(
-        builder: (context) => _home(configuration, context),
-      ),
-    ),
     options: configuration.introductionOptionsBuilder?.call(context) ??
         const IntroductionOptions(),
     physics: configuration.introductionScrollPhysics,
@@ -119,13 +127,3 @@ Widget _introduction(
     ),
   );
 }
-
-Widget _home(
-  StartUserStoryConfiguration configuration,
-  BuildContext context,
-) {
-  var home = configuration.homeEntry;
-  return Scaffold(
-    body: home,
-  );
-}