kasy-cli 1.20.0 → 1.21.0-beta.0

package/templates/firebase/lib/router.dart

@@ -15,6 +15,11 @@ import 'package:kasy_kit/features/authentication/ui/recover_password_page.dart';
 import 'package:kasy_kit/features/authentication/ui/signin_page.dart';
 import 'package:kasy_kit/features/authentication/ui/signup_page.dart';
 import 'package:kasy_kit/features/feedbacks/ui/feedback_page.dart';
+import 'package:kasy_kit/features/home/design_system_page.dart';
+import 'package:kasy_kit/features/home/home_components_page.dart';
+import 'package:kasy_kit/features/home/home_components_preview_page.dart';
+import 'package:kasy_kit/features/home/home_components_preview_registry.dart';
+import 'package:kasy_kit/features/home/home_features_page.dart';
 import 'package:kasy_kit/features/llm_chat/llm_chat_page.dart';
 import 'package:kasy_kit/features/local_reminder/ui/reminder_page.dart';
 import 'package:kasy_kit/features/onboarding/ui/onboarding_page.dart';
@@ -73,6 +78,61 @@ GoRouter generateRouter({
           ),
         ),
       ),
+      // Home showcase detail screens. These are TOP-LEVEL routes (siblings of
+      // '/', not children of the BottomMenu shell), so go_router renders them on
+      // the root navigator: full-screen, above the bottom bar, URL-addressable.
+      // Returning pops back to the tab with its menu intact.
+      GoRoute(
+        name: 'features',
+        path: '/features',
+        pageBuilder: (context, state) => kasyTransitionPage(
+          key: state.pageKey,
+          child: const HomeFeaturesPage(),
+        ),
+      ),
+      GoRoute(
+        name: 'design_system',
+        path: '/design-system',
+        pageBuilder: (context, state) => kasyTransitionPage(
+          key: state.pageKey,
+          child: const DesignSystemPage(),
+        ),
+      ),
+      GoRoute(
+        name: 'components',
+        path: '/components',
+        pageBuilder: (context, state) => kasyTransitionPage(
+          key: state.pageKey,
+          child: const HomeComponentsPage(),
+        ),
+        routes: [
+          // /components/:name — a single component's preview, looked up from the
+          // registry so the URL alone restores the screen on web reload.
+          GoRoute(
+            name: 'component_preview',
+            path: ':name',
+            pageBuilder: (context, state) {
+              final ComponentPreviewDefinition? definition =
+                  getComponentPreviewDefinition(
+                state.pathParameters['name'] ?? '',
+              );
+              if (definition == null) {
+                return kasyTransitionPage(
+                  key: state.pageKey,
+                  child: const PageNotFound(),
+                );
+              }
+              return kasyTransitionPage(
+                key: state.pageKey,
+                child: HomeComponentsPreviewPage(
+                  title: definition.title,
+                  variants: definition.variants,
+                ),
+              );
+            },
+          ),
+        ],
+      ),
       GoRoute(
         name: 'onboarding',
         path: '/onboarding',

package/templates/firebase/test/core/bottom_menu/detail_route_menu_test.dart

@@ -0,0 +1,57 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:go_router/go_router.dart';
+
+/// Regression test for the Features/Components navigation.
+///
+/// These detail screens are TOP-LEVEL go_router routes (siblings of the home
+/// shell, not children of it), so pushing them renders full-screen on the root
+/// navigator: the bottom bar is gone while the detail is open, and it returns
+/// intact when the user pops back to the tab.
+void main() {
+  testWidgets('a top-level route opens full-screen over the bottom bar, '
+      'and the bar returns on pop', (tester) async {
+    final router = GoRouter(
+      routes: [
+        // Home shell — owns the bottom bar (like BottomMenu).
+        GoRoute(
+          path: '/',
+          builder: (context, state) => Scaffold(
+            bottomNavigationBar: const Text('MENU'),
+            body: Center(
+              child: ElevatedButton(
+                onPressed: () => context.push('/features'),
+                child: const Text('open'),
+              ),
+            ),
+          ),
+        ),
+        // Detail screen — sibling of '/', so it renders on the root navigator.
+        GoRoute(
+          path: '/features',
+          builder: (context, state) => const Scaffold(
+            body: Center(child: Text('DETAIL')),
+          ),
+        ),
+      ],
+    );
+
+    await tester.pumpWidget(MaterialApp.router(routerConfig: router));
+
+    // Home tab: bottom bar visible, no detail.
+    expect(find.text('MENU'), findsOneWidget);
+    expect(find.text('DETAIL'), findsNothing);
+
+    // Open Features.
+    await tester.tap(find.text('open'));
+    await tester.pumpAndSettle();
+    expect(find.text('DETAIL'), findsOneWidget);
+    expect(find.text('MENU'), findsNothing); // covered — no bottom bar here
+
+    // Back: the bottom bar is intact.
+    Navigator.of(tester.element(find.text('DETAIL'))).maybePop();
+    await tester.pumpAndSettle();
+    expect(find.text('DETAIL'), findsNothing);
+    expect(find.text('MENU'), findsOneWidget);
+  });
+}

package/lib/scaffold/backends/api/patch/lib/core/rating/widgets/review_popup.dart

@@ -1,211 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:flutter_animate/flutter_animate.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:go_router/go_router.dart';
-import 'package:kasy_kit/components/components.dart';
-import 'package:kasy_kit/core/data/api/analytics_api.dart';
-import 'package:kasy_kit/core/rating/providers/rating_repository.dart';
-import 'package:kasy_kit/core/states/user_state_notifier.dart';
-import 'package:kasy_kit/core/theme/theme.dart';
-import 'package:kasy_kit/core/widgets/responsive_layout.dart';
-import 'package:kasy_kit/i18n/translations.g.dart';
-import 'package:logger/logger.dart';
-
-Future<bool> showReviewDialog(WidgetRef ref, {bool force = false}) {
-  if (!ref.context.mounted) {
-    return Future.value(false);
-  }
-  final ratingRepository = ref.watch(ratingRepositoryProvider);
-  final userState = ref.watch(userStateNotifierProvider);
-  final ratingFuture = ratingRepository.getReview(userState.user);
-
-  return ratingFuture.then((rating) {
-    final shouldAsk = rating.shouldAsk();
-    Logger().d('should Ask for review: $shouldAsk');
-    if (!shouldAsk && !force) {
-      return false;
-    }
-    if (!ref.context.mounted) {
-      return false;
-    }
-    showDialog(
-      context: ref.context,
-      barrierDismissible: false,
-      builder: (context) {
-        ratingRepository.delay();
-        return Animate(
-          effects: const [
-            FadeEffect(
-              delay: Duration(milliseconds: 100),
-              duration: Duration(milliseconds: 300),
-            ),
-            MoveEffect(
-              delay: Duration(milliseconds: 100),
-              duration: Duration(milliseconds: 450),
-              curve: Curves.easeOut,
-              begin: Offset(0, 50),
-              end: Offset.zero,
-            ),
-          ],
-          child: Dialog(
-            backgroundColor: Colors.transparent,
-            child: DeviceSizeBuilder(
-              builder: (device) {
-                final maxWidth = switch (device) {
-                  DeviceType.medium => MediaQuery.of(context).size.width - KasySpacing.xl,
-                  _ => 550.0,
-                };
-                return ConstrainedBox(
-                  constraints: BoxConstraints(maxWidth: maxWidth),
-                  child: Center(
-                    child: Container(
-                      decoration: BoxDecoration(
-                        color: context.colors.background,
-                        borderRadius: KasyRadius.lgBorderRadius,
-                        border: Border.all(
-                          color: context.colors.onBackground.withValues(
-                            alpha: .3,
-                          ),
-                          width: 2,
-                          strokeAlign: BorderSide.strokeAlignOutside,
-                        ),
-                      ),
-                      child: Column(
-                        mainAxisSize: MainAxisSize.min,
-                        crossAxisAlignment: CrossAxisAlignment.stretch,
-                        children: [
-                          Flexible(
-                            child: Stack(
-                              children: [
-                                ClipRRect(
-                                  borderRadius: const BorderRadius.only(
-                                    topLeft: Radius.circular(KasyRadius.lg),
-                                    topRight: Radius.circular(KasyRadius.lg),
-                                  ),
-                                  child: Image.asset(
-                                    'assets/images/review.png',
-                                    fit: BoxFit.fitWidth,
-                                    width: maxWidth,
-                                  ),
-                                ),
-                                Positioned(
-                                  top: KasySpacing.md,
-                                  left: KasySpacing.md,
-                                  child: CloseIcon(
-                                    onExit: () {
-                                      ref
-                                          .read(analyticsApiProvider)
-                                          .logEvent('rating_popup_close', {});
-                                      rating.delay().then((_) {
-                                        if (!context.mounted) return;
-                                        Navigator.of(context).pop();
-                                      });
-                                    },
-                                  ),
-                                ),
-                              ],
-                            ),
-                          ),
-                          const SizedBox(height: KasySpacing.md),
-                          Flexible(
-                            flex: 0,
-                            child: Padding(
-                              padding: const EdgeInsets.symmetric(
-                                horizontal: KasySpacing.smd,
-                              ),
-                              child: Text(
-                                Translations.of(context).review_popup.title,
-                                textAlign: TextAlign.center,
-                                style: context.textTheme.headlineSmall,
-                              ),
-                            ),
-                          ),
-                          const SizedBox(height: KasySpacing.md),
-                          Padding(
-                            padding: const EdgeInsets.symmetric(
-                              horizontal: KasySpacing.lg,
-                            ),
-                            child: Text(
-                              Translations.of(context).review_popup.description,
-                              textAlign: TextAlign.center,
-                              style: context.textTheme.bodyMedium,
-                            ),
-                          ),
-                          const SizedBox(height: KasySpacing.lg),
-                          Padding(
-                            padding: const EdgeInsets.symmetric(
-                              horizontal: KasySpacing.md,
-                            ),
-                            child: KasyButton(
-                              label: Translations.of(context).review_popup.rate_button,
-                              expand: true,
-                              onPressed: () {
-                                ref.read(analyticsApiProvider).logEvent('rating_popup_show', {});
-                                ratingRepository
-                                    .rate()
-                                    .then((res) => rating.review())
-                                    .then((_) {
-                                      if (!context.mounted) return;
-                                      Navigator.of(context).pop();
-                                    });
-                              },
-                            ),
-                          ),
-                          const SizedBox(height: KasySpacing.sm),
-                          KasyButton(
-                            label: Translations.of(context).review_popup.cancel_button,
-                            variant: KasyButtonVariant.tertiary,
-                            expand: true,
-                            onPressed: () => Navigator.of(context).pop(true),
-                          ),
-                          const SizedBox(height: KasySpacing.sm),
-                        ],
-                      ),
-                    ),
-                  ),
-                );
-              },
-            ),
-          ),
-        );
-      },
-    ).then((shouldOpenFeedbackPage) {
-      if (shouldOpenFeedbackPage == true && ref.context.mounted) {
-        ref.context.push("/feedback");
-      }
-    });
-    return true;
-  });
-}
-
-class CloseIcon extends StatelessWidget {
-  final VoidCallback onExit;
-
-  const CloseIcon({super.key, required this.onExit});
-
-  @override
-  Widget build(BuildContext context) {
-    return ClipOval(
-      child: Material(
-        color: Colors.transparent,
-        child: InkWell(
-          onTap: () => onExit.call(),
-          child: Ink(
-            width: 32,
-            height: 32,
-            // padding: const EdgeInsets.all(6),
-            decoration: BoxDecoration(
-              color: context.colors.background,
-              shape: BoxShape.circle,
-            ),
-            child: Icon(
-              KasyIcons.close,
-              color: context.colors.onBackground,
-              size: 21,
-            ),
-          ),
-        ),
-      ),
-    );
-  }
-}

package/lib/scaffold/backends/api/patch/lib/features/notifications/providers/models/notification.dart

@@ -1,185 +0,0 @@
-// ignore_for_file: invalid_annotation_target, constant_identifier_names
-
-import 'package:kasy_kit/features/notifications/api/entities/notifications_entity.dart';
-import 'package:kasy_kit/features/notifications/api/local_notifier.dart';
-import 'package:kasy_kit/features/notifications/repositories/notifications_repository.dart';
-import 'package:go_router/go_router.dart';
-import 'package:kasy_kit/router.dart';
-import 'package:freezed_annotation/freezed_annotation.dart';
-import 'package:logger/logger.dart';
-import 'package:permission_handler/permission_handler.dart';
-import 'package:sentry_flutter/sentry_flutter.dart';
-import 'package:url_launcher/url_launcher.dart';
-
-part 'notification.freezed.dart';
-part 'notification.g.dart';
-
-@freezed
-sealed class Notification with _$Notification {
-  const Notification._();
-
-  const factory Notification.withData({
-    String? id,
-    required String title,
-    required String body,
-    required DateTime createdAt,
-    DateTime? readAt,
-    String? imageUrl,
-    @JsonKey(includeFromJson: false, includeToJson: false)
-    LocalNotifier? notifier,
-    @JsonKey(includeFromJson: false, includeToJson: false)
-    NotificationSettings? notifierSettings,
-    NotificationTypes? type,
-    Map<String, dynamic>? data,
-  }) = NotificationData;
-
-  factory Notification.fromJson(Map<String, dynamic> json) =>
-      _$NotificationFromJson(json);
-
-  factory Notification.from(
-    Map<String, dynamic> json, {
-    String? id,
-    Map<String, dynamic>? data,
-    LocalNotifier? notifierApi,
-    NotificationSettings? notifierSettings,
-  }) =>
-      Notification.withData(
-        id: id,
-        title: json['title'] as String,
-        body: json['body'] as String,
-        imageUrl: json['image'] as String?,
-        type: data != null && data.containsKey('type')
-            ? NotificationTypes.values.firstWhere(
-                (e) => e.name == data['type'],
-                orElse: () => NotificationTypes.OTHER,
-              )
-            : null,
-        data: data,
-        createdAt: DateTime.now(),
-        notifier: notifierApi,
-        notifierSettings: notifierSettings,
-      );
-
-  Future<void> show({NotificationSettings? settings}) async {
-    if (notifier == null) {
-      throw Exception(
-        'You must provide a LocalNotifierApi to show a notification',
-      );
-    }
-    if (notifierSettings != null) {
-      await notifier!.show(notifierSettings!, this);
-      return;
-    } else if (settings != null) {
-      await notifier!.show(settings, this);
-      return;
-    }
-    throw Exception(
-      'You must provide a NotificationSettings to show a notification',
-    );
-  }
-
-  bool get seen => readAt != null;
-
-  Future<void> onTap() async {
-    // if the app is not ready, we store the notification in the pending notification handler
-    if (navigatorKey.currentContext == null) {
-      return;
-    }
-
-    // Open external URL
-    if (type == NotificationTypes.LINK && data?.containsKey('url') == true) {
-      try {
-        launchUrl(Uri.parse(data!['url'] as String));
-      } catch (e, s) {
-        Logger().e("error $e");
-        Sentry.captureException(e, stackTrace: s);
-      }
-      return;
-    }
-    // Navigate to an internal route sent in the notification data.
-    // Example: data: {"route": "/premium"} → opens the premium page.
-    if (data?.containsKey('route') == true) {
-      final route = data!['route'] as String;
-      navigatorKey.currentContext!.go(route);
-      return;
-    }
-    // Default: open the notifications list
-    navigatorKey.currentContext!.go('/notifications');
-  }
-}
-
-sealed class NotificationPermission {
-  /// ask for permission if needed
-  Future<void> maybeAsk() async {
-    final permission = this;
-    switch (permission) {
-      case NotificationPermissionWaiting():
-        await permission.ask();
-      case NotificationPermissionDenied():
-        await permission.ask();
-      case NotificationPermissionGranted():
-      default:
-    }
-  }
-}
-
-/// we asked for permission and it was granted
-class NotificationPermissionGranted extends NotificationPermission {
-  NotificationPermissionGranted();
-}
-
-/// we asked for permission and it was denied
-class NotificationPermissionDenied extends NotificationPermission {
-  final NotificationSettings? _notificationSettings;
-  final NotificationsRepository? _repository;
-
-  NotificationPermissionDenied({
-    NotificationSettings? notificationSettings,
-    NotificationsRepository? repository,
-  })  : _repository = repository,
-        _notificationSettings = notificationSettings;
-
-  Future<void> ask() async {
-    if (_notificationSettings == null) {
-      throw Exception("NotificationsApi is null");
-    }
-    final granted = await _notificationSettings.askPermission();
-    NotificationPermission? permission;
-    if (granted) {
-      permission = NotificationPermissionGranted();
-    } else {
-      permission = NotificationPermissionDenied();
-    }
-    await _repository!.init();
-  }
-
-  Future<void> openSettings() async {
-    await openAppSettings();
-  }
-}
-
-/// we never asked for permission
-class NotificationPermissionWaiting extends NotificationPermission {
-  final NotificationSettings? _notificationSettings;
-  final NotificationsRepository? _repository;
-
-  NotificationPermissionWaiting({
-    NotificationSettings? notificationSettings,
-    NotificationsRepository? repository,
-  })  : _notificationSettings = notificationSettings,
-        _repository = repository;
-
-  Future<void> ask() async {
-    if (_notificationSettings == null) {
-      throw Exception("NotificationsApi is null");
-    }
-    final granted = await _notificationSettings.askPermission();
-    NotificationPermission? permission;
-    if (granted) {
-      permission = NotificationPermissionGranted();
-      await _repository?.init();
-    } else {
-      permission = NotificationPermissionDenied();
-    }
-  }
-}

package/lib/scaffold/backends/api/patch/lib/features/onboarding/ui/components/onboarding_notifications_setup.dart

@@ -1,73 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:kasy_kit/components/components.dart';
-import 'package:kasy_kit/core/data/api/analytics_api.dart';
-import 'package:kasy_kit/core/theme/theme.dart';
-import 'package:kasy_kit/features/notifications/providers/models/notification.dart';
-import 'package:kasy_kit/features/notifications/repositories/notifications_repository.dart';
-import 'package:kasy_kit/features/onboarding/providers/onboarding_provider.dart';
-import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_background.dart';
-import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_illustration_scaffold.dart';
-import 'package:kasy_kit/i18n/translations.g.dart';
-
-final _formStep3Key = GlobalKey<FormState>();
-
-class NotificationsPermissionStep extends ConsumerWidget {
-  final String nextRoute;
-
-  const NotificationsPermissionStep({
-    super.key,
-    required this.nextRoute,
-  });
-
-  @override
-  Widget build(BuildContext context, WidgetRef ref) {
-    final notifRepository = ref.watch(notificationRepositoryProvider);
-    final permissionFuture = notifRepository.getPermissionStatus();
-    final translations = Translations.of(context).onboarding.notifications;
-
-    return OnboardingBackground(
-      child: FutureBuilder<NotificationPermission>(
-        future: permissionFuture,
-        builder: (context, snapshot) {
-          if (!snapshot.hasData) {
-            return const SizedBox();
-          }
-          return Form(
-            key: _formStep3Key,
-            child: OnboardingIllustrationScaffold(
-              progress: 0.9,
-              title: translations.title,
-              description: translations.description,
-              imageAsset: 'assets/images/onboarding/img2.jpg',
-              footerActions: [
-                KasyButton(
-                  label: translations.continue_button,
-                  expand: true,
-                  onPressed: () => ref.onboardingNotifier
-                      .setupNotifications()
-                      .then((_) {
-                    if (!context.mounted) return;
-                    Navigator.of(context).pushNamed(nextRoute);
-                  }),
-                ),
-                const SizedBox(height: KasySpacing.smd),
-                KasyButton(
-                  label: translations.skip_button,
-                  variant: KasyButtonVariant.soft,
-                  expand: true,
-                  onPressed: () {
-                    ref
-                        .read(analyticsApiProvider)
-                        .logEvent('setup_notifications_refused', {});
-                    Navigator.of(context).pushNamed(nextRoute);
-                  },
-                ),
-              ],
-            ),
-          );
-        },
-      ),
-    );
-  }
-}