Merge pull request #142 from MostroP2P/implement-walkthrough

feat: Implement walkthrough screen

Author: grunch

assets/images/wt-1.png

@@ -12,6 +12,7 @@ import 'package:mostro_mobile/services/lifecycle_manager.dart';
 import 'package:mostro_mobile/shared/providers/app_init_provider.dart';
 import 'package:mostro_mobile/features/settings/settings_provider.dart';
 import 'package:mostro_mobile/shared/notifiers/locale_notifier.dart';
+import 'package:mostro_mobile/features/walkthrough/providers/first_run_provider.dart';
 
 class MostroApp extends ConsumerStatefulWidget {
   const MostroApp({super.key});
@@ -36,6 +37,9 @@ class _MostroAppState extends ConsumerState<MostroApp> {
 
     return initAsyncValue.when(
       data: (_) {
+        // Initialize first run provider
+        ref.watch(firstRunProvider);
+        
         ref.listen<AuthState>(authNotifierProvider, (previous, state) {
           WidgetsBinding.instance.addPostFrameCallback((_) {
             if (!context.mounted) return;
@@ -57,7 +61,7 @@ class _MostroAppState extends ConsumerState<MostroApp> {
           title: 'Mostro',
           theme: AppTheme.theme,
           darkTheme: AppTheme.theme,
-          routerConfig: goRouter,
+          routerConfig: createRouter(ref),
           // Use language override from settings if available, otherwise let callback handle detection
           locale: settings.selectedLanguage != null 
               ? Locale(settings.selectedLanguage!) 

assets/images/wt-2.png

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 import 'package:go_router/go_router.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:mostro_mobile/data/models/enums/order_type.dart';
 import 'package:mostro_mobile/features/chat/screens/chat_room_screen.dart';
 import 'package:mostro_mobile/features/order/screens/add_order_screen.dart';
@@ -19,12 +20,28 @@ import 'package:mostro_mobile/features/order/screens/pay_lightning_invoice_scree
 import 'package:mostro_mobile/features/order/screens/take_order_screen.dart';
 import 'package:mostro_mobile/features/auth/screens/register_screen.dart';
 import 'package:mostro_mobile/features/walkthrough/screens/walkthrough_screen.dart';
+import 'package:mostro_mobile/features/walkthrough/providers/first_run_provider.dart';
 import 'package:mostro_mobile/shared/widgets/navigation_listener_widget.dart';
 import 'package:mostro_mobile/shared/widgets/notification_listener_widget.dart';
 
-final goRouter = GoRouter(
-  navigatorKey: GlobalKey<NavigatorState>(),
-  routes: [
+GoRouter createRouter(WidgetRef ref) {
+  return GoRouter(
+    navigatorKey: GlobalKey<NavigatorState>(),
+    redirect: (context, state) {
+      final firstRunState = ref.read(firstRunProvider);
+      
+      return firstRunState.when(
+        data: (isFirstRun) {
+          if (isFirstRun && state.matchedLocation != '/walkthrough') {
+            return '/walkthrough';
+          }
+          return null;
+        },
+        loading: () => null,
+        error: (_, __) => null,
+      );
+    },
+    routes: [
     ShellRoute(
       builder: (BuildContext context, GoRouterState state, Widget child) {
         return NotificationListenerWidget(
@@ -198,6 +215,7 @@ final goRouter = GoRouter(
     body: Center(child: Text(state.error.toString())),
   ),
 );
+}
 
 CustomTransitionPage buildPageWithDefaultTransition<T>({
   required BuildContext context,

assets/images/wt-3.png

@@ -1,7 +1,8 @@
 enum SharedPreferencesKeys {
   appSettings('mostro_settings'),
   keyIndex('key_index'),
-  fullPrivacy('full_privacy');
+  fullPrivacy('full_privacy'),
+  firstRunComplete('first_run_complete');
 
   final String value;
 

assets/images/wt-4.png

@@ -0,0 +1,56 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+import 'package:mostro_mobile/data/models/enums/storage_keys.dart';
+import 'package:mostro_mobile/shared/providers/storage_providers.dart';
+
+class FirstRunNotifier extends StateNotifier<AsyncValue<bool>> {
+  FirstRunNotifier(this._sharedPreferences) : super(const AsyncValue.loading()) {
+    _init();
+  }
+
+  final SharedPreferencesAsync _sharedPreferences;
+
+  Future<void> _init() async {
+    try {
+      final isFirstRun = await _checkIfFirstRun();
+      state = AsyncValue.data(isFirstRun);
+    } catch (error, stackTrace) {
+      state = AsyncValue.error(error, stackTrace);
+    }
+  }
+
+  Future<bool> _checkIfFirstRun() async {
+    final firstRunComplete = await _sharedPreferences.getBool(
+      SharedPreferencesKeys.firstRunComplete.value,
+    );
+    return firstRunComplete != true;
+  }
+
+  Future<void> markFirstRunComplete() async {
+    try {
+      await _sharedPreferences.setBool(
+        SharedPreferencesKeys.firstRunComplete.value,
+        true,
+      );
+      state = const AsyncValue.data(false);
+    } catch (error, stackTrace) {
+      state = AsyncValue.error(error, stackTrace);
+    }
+  }
+
+  Future<void> resetFirstRun() async {
+    try {
+      await _sharedPreferences.remove(
+        SharedPreferencesKeys.firstRunComplete.value,
+      );
+      state = const AsyncValue.data(true);
+    } catch (error, stackTrace) {
+      state = AsyncValue.error(error, stackTrace);
+    }
+  }
+}
+
+final firstRunProvider = StateNotifierProvider<FirstRunNotifier, AsyncValue<bool>>((ref) {
+  final sharedPreferences = ref.read(sharedPreferencesProvider);
+  return FirstRunNotifier(sharedPreferences);
+});