kasy-cli 1.38.0 → 1.39.1

package/templates/firebase/lib/features/local_reminders/ui/reminder_page.dart

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:intl/intl.dart';
 import 'package:kasy_kit/components/kasy_app_bar.dart';
 import 'package:kasy_kit/components/kasy_bottom_sheet.dart';
 import 'package:kasy_kit/components/kasy_card.dart';
@@ -7,6 +8,7 @@ import 'package:kasy_kit/components/kasy_chip.dart';
 import 'package:kasy_kit/components/kasy_date_picker.dart';
 import 'package:kasy_kit/components/kasy_tabs.dart';
 import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/core/widgets/kasy_hover.dart';
 import 'package:kasy_kit/core/widgets/kasy_scroll_behavior.dart';
 import 'package:kasy_kit/features/local_reminders/providers/reminder_notifier.dart';
 import 'package:kasy_kit/features/local_reminders/repositories/reminder_preferences.dart';
@@ -77,14 +79,16 @@ class _ReminderForm extends ConsumerWidget {
           child: Column(
             crossAxisAlignment: CrossAxisAlignment.stretch,
             children: [
+              // The master toggle reads like a Settings row: a colored icon
+              // badge, the label, and a live one-line summary of when the
+              // reminder fires (or a hint when it's off) as the subtitle.
               KasyCard(
-                padding: const EdgeInsets.symmetric(
-                  horizontal: KasySpacing.md,
-                  vertical: KasySpacing.xs,
-                ),
+                borderRadius: KasyRadius.lgBorderRadius,
                 child: SettingsSwitchTile(
                   icon: KasyIcons.notification,
+                  iconBackgroundColor: context.colors.primary,
                   title: tr.toggleLabel,
+                  subtitle: _scheduleSummary(context, state),
                   value: state.enabled,
                   onChanged: notifier.setEnabled,
                 ),
@@ -93,26 +97,17 @@ class _ReminderForm extends ConsumerWidget {
                 const SizedBox(height: KasySpacing.xl),
                 _FieldLabel(tr.typeLabel),
                 const SizedBox(height: KasySpacing.sm),
-                // Default hug mode scrolls horizontally when the labels don't
-                // fit (long localized strings) instead of overflowing the row.
+                // Fill mode so the three options split the width equally
+                // (a segmented control), instead of hug mode where each tab
+                // only takes its own text width and the spacing looks uneven.
                 KasyTabs(
                   tabs: [tr.daily, tr.weekly, tr.specificDate],
                   selectedIndex: _types.indexOf(state.type),
                   onTabSelected: (i) => notifier.setType(_types[i]),
+                  mode: KasyTabsMode.fill,
                 ),
-                // daily / weekly schedule by a wall-clock time (hour + minute);
-                // specificDate carries its own time inside the chosen date.
-                if (state.type == ReminderType.daily ||
-                    state.type == ReminderType.weekly) ...[
-                  const SizedBox(height: KasySpacing.lg),
-                  _FieldLabel(tr.timeLabel),
-                  const SizedBox(height: KasySpacing.sm),
-                  _TimeTile(
-                    hour: state.hour,
-                    minute: state.minute,
-                    onChanged: (h, m) => notifier.setTime(h, m),
-                  ),
-                ],
+                // Pick the day/date BEFORE the time so the schedule reads in a
+                // natural order (which day → at what time).
                 if (state.type == ReminderType.weekly) ...[
                   const SizedBox(height: KasySpacing.lg),
                   _FieldLabel(tr.dayLabel),
@@ -149,9 +144,14 @@ class _ReminderForm extends ConsumerWidget {
                       );
                     },
                   ),
-                  const SizedBox(height: KasySpacing.lg),
-                  _FieldLabel(tr.timeLabel),
-                  const SizedBox(height: KasySpacing.sm),
+                ],
+                // Time is shared by every type. daily / weekly schedule by a
+                // wall-clock time (hour + minute); specificDate carries its own
+                // time inside the chosen date.
+                const SizedBox(height: KasySpacing.lg),
+                _FieldLabel(tr.timeLabel),
+                const SizedBox(height: KasySpacing.sm),
+                if (state.type == ReminderType.specificDate)
                   _TimeTile(
                     hour: state.date?.hour ?? 9,
                     minute: state.date?.minute ?? 0,
@@ -162,8 +162,13 @@ class _ReminderForm extends ConsumerWidget {
                         DateTime(base.year, base.month, base.day, h, m),
                       );
                     },
+                  )
+                else
+                  _TimeTile(
+                    hour: state.hour,
+                    minute: state.minute,
+                    onChanged: (h, m) => notifier.setTime(h, m),
                   ),
-                ],
               ],
             ],
           ),
@@ -173,8 +178,43 @@ class _ReminderForm extends ConsumerWidget {
   }
 }
 
+/// Human-readable, one-line description of the active schedule used as the
+/// toggle subtitle. Reads "Every day at 09:00" / "Monday at 09:00" /
+/// "On June 15 at 09:00", and falls back to a hint while the reminder is off
+/// (or asks for a date when a specific-date reminder has none yet).
+String _scheduleSummary(BuildContext context, ReminderState state) {
+  final tr = Translations.of(context).reminderPage;
+  if (!state.enabled) return tr.hint;
+
+  final String locale = Localizations.localeOf(context).toString();
+  String pad(int v) => v.toString().padLeft(2, '0');
+
+  switch (state.type) {
+    case ReminderType.daily:
+      return tr.summaryDaily(time: '${pad(state.hour)}:${pad(state.minute)}');
+    case ReminderType.weekly:
+      // January 2024 starts on a Monday, so day-of-month N maps to weekday N.
+      // DateFormat already cases the weekday per locale (e.g. "Tuesday" vs the
+      // lowercase "terça-feira"), so we use it as-is inside the summary.
+      final String day =
+          DateFormat.EEEE(locale).format(DateTime(2024, 1, state.dayOfWeek));
+      return tr.summaryWeekly(
+        day: day,
+        time: '${pad(state.hour)}:${pad(state.minute)}',
+      );
+    case ReminderType.specificDate:
+      final DateTime? date = state.date;
+      if (date == null) return tr.selectDate;
+      return tr.summaryDate(
+        date: DateFormat.MMMMd(locale).format(date),
+        time: '${pad(date.hour)}:${pad(date.minute)}',
+      );
+  }
+}
+
 /// Quiet group eyebrow above each field — the design-system section label
 /// (small, gently tracked, muted), matching the Settings / sidebar pattern.
+/// The small left inset aligns it with the Settings section labels.
 class _FieldLabel extends StatelessWidget {
   final String label;
 
@@ -182,10 +222,13 @@ class _FieldLabel extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    return Text(
-      label,
-      style: context.kasyTextTheme.sectionLabel.copyWith(
-        color: context.colors.muted,
+    return Padding(
+      padding: const EdgeInsets.only(left: KasySpacing.xs),
+      child: Text(
+        label,
+        style: context.kasyTextTheme.sectionLabel.copyWith(
+          color: context.colors.muted,
+        ),
       ),
     );
   }
@@ -199,15 +242,21 @@ class _DaySelector extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    // 1=Monday ... 7=Sunday (matches DateTime.weekday)
-    final days = ['Seg', 'Ter', 'Qua', 'Qui', 'Sex', 'Sáb', 'Dom'];
+    // 1=Monday ... 7=Sunday (matches DateTime.weekday). Short weekday names are
+    // localized via intl, so the chips read correctly in every app language
+    // instead of being hardcoded to one locale.
+    final DateFormat format = DateFormat.E(
+      Localizations.localeOf(context).toString(),
+    );
+    // January 2024 starts on a Monday, so day-of-month N maps to weekday N (1..7).
+    String shortName(int weekday) => format.format(DateTime(2024, 1, weekday));
     return Wrap(
       spacing: KasySpacing.xs,
       runSpacing: KasySpacing.xs,
       children: List.generate(7, (i) {
         final dayIndex = i + 1;
         return KasyChip(
-          label: days[i],
+          label: shortName(dayIndex),
           selected: current == dayIndex,
           onSelected: (_) => onChanged(dayIndex),
         );
@@ -243,35 +292,40 @@ class _TimeTile extends StatelessWidget {
       }
     }
 
+    // Same surface + interaction model as a Settings row: an elevated card,
+    // a colored icon badge, the value, and a trailing chevron. KasyHover gives
+    // the press depth and keyboard focus ring, clipped to the card corners.
     return KasyCard(
-      onTap: pickTime,
-      borderRadius: KasyRadius.mdBorderRadius,
-      padding: const EdgeInsets.symmetric(
-        horizontal: KasySpacing.md,
-        vertical: KasySpacing.smd,
-      ),
-      child: Row(
-        children: [
-          Icon(
-            KasyIcons.time,
-            size: KasyIconSize.lg,
-            color: context.colors.primary,
-          ),
-          const SizedBox(width: KasySpacing.sm),
-          Text(
-            '${_pad(hour)}:${_pad(minute)}',
-            style: context.textTheme.bodyLarge?.copyWith(
-              color: context.colors.onSurface,
-              fontWeight: FontWeight.w600,
+      borderRadius: KasyRadius.lgBorderRadius,
+      child: KasyHover(
+        onTap: pickTime,
+        focusable: true,
+        borderRadius: KasyRadius.lgBorderRadius,
+        focusGapColor: context.colors.surface,
+        semanticLabel: '${_pad(hour)}:${_pad(minute)}',
+        padding: const EdgeInsets.symmetric(
+          horizontal: KasySpacing.md,
+          vertical: KasySpacing.smd,
+        ),
+        child: Row(
+          children: [
+            SettingsIconBadge(
+              icon: KasyIcons.time,
+              color: context.colors.primary,
             ),
-          ),
-          const Spacer(),
-          Icon(
-            KasyIcons.arrowForwardIos,
-            size: KasyIconSize.xs,
-            color: context.colors.muted,
-          ),
-        ],
+            const SizedBox(width: KasySpacing.sm),
+            Expanded(
+              child: Text(
+                '${_pad(hour)}:${_pad(minute)}',
+                style: context.kasyTextTheme.listRowTitle.copyWith(
+                  color: context.colors.onSurface,
+                  fontWeight: FontWeight.w600,
+                ),
+              ),
+            ),
+            const SettingsListChevron(),
+          ],
+        ),
       ),
     );
   }

package/templates/firebase/lib/features/notifications/api/device_api.dart

@@ -114,9 +114,17 @@ class FirebaseDeviceApi implements DeviceApi {
           await Future.delayed(const Duration(seconds: 1));
         }
       }
-      final token = await _messaging.getToken();
-      if (token == null) {
-        throw ApiError(code: 0, message: 'FCM token is null — check Firebase setup and notification permissions');
+      // Register the installation even without a push token. On iOS the FCM
+      // token stays null until the user grants notification permission (and
+      // getToken can even throw before APNS is ready). We still create the
+      // device row — so the welcome notification fires and the install is
+      // tracked — and the token fills in later via onTokenRefresh once push is
+      // enabled.
+      String token = '';
+      try {
+        token = await _messaging.getToken() ?? '';
+      } catch (_) {
+        token = '';
       }
       final os = Platform.isAndroid
           ? OperatingSystem.android //

package/templates/firebase/lib/features/notifications/ui/notifications_page.dart

@@ -10,10 +10,10 @@ import 'package:kasy_kit/features/notifications/providers/models/notification.da
     as app;
 import 'package:kasy_kit/features/notifications/providers/models/notification_list.dart';
 import 'package:kasy_kit/features/notifications/providers/notifications_provider.dart';
-import 'package:kasy_kit/features/notifications/ui/components/notification_settings_sheet.dart';
 import 'package:kasy_kit/features/notifications/ui/components/notification_tile.dart';
 import 'package:kasy_kit/features/notifications/ui/widgets/empty_notifications.dart';
 import 'package:kasy_kit/features/notifications/ui/widgets/notification_tile.dart';
+import 'package:kasy_kit/features/notifications/ui/widgets/push_permission_banner.dart';
 import 'package:kasy_kit/i18n/translations.g.dart';
 
 class NotificationsPage extends ConsumerStatefulWidget {
@@ -124,12 +124,17 @@ class _NotificationsPageState extends ConsumerState<NotificationsPage> {
                 tooltip: t.notifications.delete_all,
               ),
             if (hasAny) const SizedBox(width: KasySpacing.xs),
+            // Light/dark theme toggle, matching the other root-tab screens.
             KasyChromeOrbIconButton(
-              icon: KasyIcons.moreVert,
+              icon: Theme.of(ctx).brightness == Brightness.dark
+                  ? KasyIcons.lightMode
+                  : KasyIcons.darkMode,
               iconSize: 18,
               foregroundColor: ctx.colors.onSurface,
-              onPressed: () => showNotificationSettingsSheet(ctx),
-              tooltip: 'Opções',
+              onPressed: () => ThemeProvider.of(ctx).toggle(),
+              tooltip: Theme.of(ctx).brightness == Brightness.dark
+                  ? 'Light mode'
+                  : 'Dark mode',
             ),
           ],
         ),
@@ -139,6 +144,13 @@ class _NotificationsPageState extends ConsumerState<NotificationsPage> {
         requestReadAll();
       },
       slivers: [
+        // Native-only push nudge. Self-hides on web and once granted, and the
+        // first time it appears in the "never asked" state it fires the native
+        // OS prompt automatically. Sits above the list so it shows even when the
+        // welcome notification already fills the screen.
+        const SliverToBoxAdapter(
+          child: PushPermissionBanner(autoRequest: true),
+        ),
         notificationsState.when(
           loading: () => SliverList(
             delegate: SliverChildBuilderDelegate(

package/templates/firebase/lib/features/notifications/ui/widgets/empty_notifications.dart

@@ -1,40 +1,16 @@
-import 'package:flutter/foundation.dart' show kIsWeb;
 import 'package:flutter/material.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:kasy_kit/components/components.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/i18n/translations.g.dart';
 
-class EmptyNotifications extends ConsumerStatefulWidget {
+/// Empty state for the notifications list: just the illustration and copy.
+///
+/// The "enable push" call-to-action lives in [PushPermissionBanner] at the top
+/// of the screen now, so it shows whether or not the list is empty (the welcome
+/// notification used to hide the empty-state button). Keeping it in one place
+/// avoids a duplicate CTA.
+class EmptyNotifications extends StatelessWidget {
   const EmptyNotifications({super.key});
 
-  @override
-  ConsumerState<EmptyNotifications> createState() => _EmptyNotificationsState();
-}
-
-class _EmptyNotificationsState extends ConsumerState<EmptyNotifications> {
-  late Future<NotificationPermission> _permissionFuture;
-
-  @override
-  void initState() {
-    super.initState();
-    _permissionFuture = _loadPermission();
-  }
-
-  Future<NotificationPermission> _loadPermission() {
-    return ref.read(notificationRepositoryProvider).getPermissionStatus();
-  }
-
-  Future<void> _onAskPressed(NotificationPermission permission) async {
-    await permission.maybeAsk();
-    if (!mounted) return;
-    setState(() {
-      _permissionFuture = _loadPermission();
-    });
-  }
-
   @override
   Widget build(BuildContext context) {
     final tr = context.t.notifications;
@@ -74,31 +50,6 @@ class _EmptyNotificationsState extends ConsumerState<EmptyNotifications> {
               color: context.colors.muted,
             ),
           ),
-          const SizedBox(height: KasySpacing.xl),
-          FutureBuilder<NotificationPermission>(
-            future: _permissionFuture,
-            builder: (context, snapshot) {
-              final permission = snapshot.data;
-              if (permission == null) return const SizedBox.shrink();
-              // Web has no usable notification-permission prompt (askPermission is a
-              // no-op on web and permission_handler has no web support), so the CTA
-              // would be a dead button. Show the empty state without it.
-              if (kIsWeb) return const SizedBox.shrink();
-              if (permission is NotificationPermissionGranted) {
-                return const SizedBox.shrink();
-              }
-              final isLocked =
-                  permission is NotificationPermissionPermanentlyDenied;
-              return KasyButton(
-                label: isLocked ? tr.empty_cta_open_settings : tr.empty_cta,
-                variant: KasyButtonVariant.soft,
-                icon: isLocked
-                    ? KasyIcons.settings
-                    : KasyIcons.notificationAdd,
-                onPressed: () => _onAskPressed(permission),
-              );
-            },
-          ),
           const SizedBox(height: KasySpacing.xxxl),
         ],
       ),

package/templates/firebase/lib/features/notifications/ui/widgets/notification_tile.dart

@@ -137,7 +137,7 @@ class NotificationTile extends StatelessWidget {
                   Expanded(
                     child: Text(
                       title,
-                      style: context.textTheme.titleSmall?.copyWith(
+                      style: context.kasyTextTheme.listRowTitle.copyWith(
                         color: titleColor,
                         fontWeight: FontWeight.w600,
                       ),
@@ -211,11 +211,11 @@ class TileNotificationImage extends StatelessWidget {
   Widget build(BuildContext context) {
     return KasyFocusRing(
       onActivate: () => _openFullscreen(context),
-      borderRadius: BorderRadius.circular(8),
+      borderRadius: BorderRadius.circular(KasyRadius.sm),
       child: GestureDetector(
         onTap: () => _openFullscreen(context),
         child: ClipRRect(
-          borderRadius: BorderRadius.circular(8),
+          borderRadius: BorderRadius.circular(KasyRadius.sm),
           child: Image.network(
             url,
             width: 36,
@@ -252,7 +252,7 @@ class TileNotificationIcon extends StatelessWidget {
         color: active
             ? context.colors.primary.withValues(alpha: 0.12)
             : context.colors.onSurface.withValues(alpha: 0.06),
-        borderRadius: BorderRadius.circular(10),
+        borderRadius: BorderRadius.circular(KasyRadius.md),
       ),
       child: Icon(
         active ? KasyIcons.notificationActive : KasyIcons.notification,
@@ -285,7 +285,7 @@ class NotificationSkeletonTile extends StatelessWidget {
               KasySkeleton(
                 width: 36,
                 height: 36,
-                borderRadius: BorderRadius.all(Radius.circular(10)),
+                borderRadius: BorderRadius.all(Radius.circular(KasyRadius.md)),
               ),
               SizedBox(width: KasySpacing.sm),
               Expanded(

package/templates/firebase/lib/features/notifications/ui/widgets/push_permission_banner.dart

@@ -0,0 +1,163 @@
+import 'package:flutter/foundation.dart' show kIsWeb;
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/components/components.dart';
+import 'package:kasy_kit/core/shared_preferences/shared_preferences.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/i18n/translations.g.dart';
+
+/// Inline call-to-action that nudges the user to turn on push notifications.
+///
+/// Push is native-only: on web this renders nothing (permission_handler has no
+/// web support and there is no native prompt). It also renders nothing once
+/// permission is granted, so it self-hides the moment it's no longer needed.
+///
+/// States while not granted (native only):
+///  - never asked / denied (Android can re-ask) → "Enable notifications",
+///    which fires the native OS prompt directly (no custom pre-dialog: the OS
+///    already shows its own localized prompt).
+///  - permanently denied (iOS after a refusal) → "Open settings", since the OS
+///    won't show the native prompt again and the only way back is the system
+///    settings of the app.
+///
+/// When [autoRequest] is true, the first time it mounts in the "never asked"
+/// state it fires the native prompt automatically — once per install, guarded
+/// by a shared-preferences flag. Used on the notifications screen so simply
+/// arriving there surfaces the native prompt.
+class PushPermissionBanner extends ConsumerStatefulWidget {
+  const PushPermissionBanner({super.key, this.autoRequest = false});
+
+  /// Auto-fire the native prompt once when first shown in the "never asked"
+  /// state. Leave false to require an explicit tap on the CTA.
+  final bool autoRequest;
+
+  @override
+  ConsumerState<PushPermissionBanner> createState() =>
+      _PushPermissionBannerState();
+}
+
+class _PushPermissionBannerState extends ConsumerState<PushPermissionBanner>
+    with WidgetsBindingObserver {
+  NotificationPermission? _permission;
+  bool _busy = false;
+
+  @override
+  void initState() {
+    super.initState();
+    WidgetsBinding.instance.addObserver(this);
+    _init();
+  }
+
+  @override
+  void dispose() {
+    WidgetsBinding.instance.removeObserver(this);
+    super.dispose();
+  }
+
+  @override
+  void didChangeAppLifecycleState(AppLifecycleState state) {
+    // Returning from the OS settings: re-check so the banner self-hides if the
+    // user just enabled notifications, or comes back if they disabled them —
+    // without the user having to tap anything.
+    if (state == AppLifecycleState.resumed && !kIsWeb) {
+      _reload();
+    }
+  }
+
+  Future<void> _init() async {
+    // Push is native-only — nothing to do (and nothing to render) on web.
+    if (kIsWeb) return;
+    final permission =
+        await ref.read(notificationRepositoryProvider).getPermissionStatus();
+    if (!mounted) return;
+
+    if (widget.autoRequest && permission is NotificationPermissionWaiting) {
+      final prefs = ref.read(sharedPreferencesProvider);
+      if (!prefs.getPushAutoRequested()) {
+        await prefs.setPushAutoRequested(true);
+        await permission.maybeAsk();
+        await _reload();
+        return;
+      }
+    }
+    setState(() => _permission = permission);
+  }
+
+  Future<void> _reload() async {
+    final permission =
+        await ref.read(notificationRepositoryProvider).getPermissionStatus();
+    if (mounted) setState(() => _permission = permission);
+  }
+
+  Future<void> _onPressed() async {
+    if (_busy || _permission == null) return;
+    setState(() => _busy = true);
+    await _permission!.maybeAsk();
+    await _reload();
+    if (mounted) setState(() => _busy = false);
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    // Native-only, and only while permission is still missing.
+    if (kIsWeb) return const SizedBox.shrink();
+    final permission = _permission;
+    if (permission == null || permission is NotificationPermissionGranted) {
+      return const SizedBox.shrink();
+    }
+
+    final tr = context.t.notifications;
+    final bool locked = permission is NotificationPermissionPermanentlyDenied;
+
+    // Discreet single-row nudge: small muted bell + one line of copy + a compact
+    // neutral button. Intentionally low-key so it doesn't compete with the list.
+    return Padding(
+      padding: const EdgeInsets.only(bottom: KasySpacing.smd),
+      child: Container(
+        padding: const EdgeInsets.fromLTRB(
+          KasySpacing.md,
+          KasySpacing.sm,
+          KasySpacing.sm,
+          KasySpacing.sm,
+        ),
+        decoration: BoxDecoration(
+          color: context.colors.surface,
+          borderRadius: KasyRadius.mdBorderRadius,
+          border: Border.all(
+            color: context.colors.outline.withValues(alpha: 0.4),
+          ),
+        ),
+        child: Row(
+          children: [
+            Icon(
+              KasyIcons.notification,
+              size: KasyIconSize.rowLeading,
+              color: context.colors.muted,
+            ),
+            const SizedBox(width: KasySpacing.sm),
+            Expanded(
+              child: Text(
+                locked ? tr.push_subtitle_disabled : tr.push_subtitle_waiting,
+                style: context.textTheme.bodySmall?.copyWith(
+                  color: context.colors.onSurface.withValues(alpha: 0.75),
+                ),
+                maxLines: 2,
+                overflow: TextOverflow.ellipsis,
+              ),
+            ),
+            const SizedBox(width: KasySpacing.sm),
+            KasyButton(
+              label: locked ? tr.empty_cta_open_settings : tr.empty_cta,
+              variant: KasyButtonVariant.outline,
+              size: KasyButtonSize.small,
+              isLoading: _busy,
+              onPressed: _busy ? null : _onPressed,
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}

package/templates/firebase/lib/features/notifications/ui/widgets/web_notifications_bell.dart

@@ -16,8 +16,8 @@ import 'package:kasy_kit/i18n/translations.g.dart';
 /// `/notifications` — the panel's "See all" link goes there.
 ///
 /// Owns its own overlay (OverlayPortal + LayerLink, the same popover technique
-/// as [KasySidebar]), so [KasyWebHeader] stays a pure presentational component
-/// and the data wiring lives here.
+/// as [KasySidebar]), so [KasyAppBar.application] stays a pure presentational
+/// component and the data wiring lives here.
 class WebNotificationsBell extends ConsumerStatefulWidget {
   const WebNotificationsBell({super.key});
 

package/templates/firebase/lib/features/onboarding/providers/onboarding_model.dart

@@ -9,18 +9,27 @@ class OnboardingState {
   /// here and flush them once the account is created.
   final List<UserInfoDetail> pendingUserInfo;
 
+  /// Preview mode: the flow is being walked from the admin Debug screen just to
+  /// see the screens. Every real side effect (guest account creation, profile
+  /// writes, permission prompts, the onboarded flag) is suppressed and the flow
+  /// returns to Debug instead of Home. See [OnboardingNotifier].
+  final bool preview;
+
   OnboardingState({
     this.reminder,
     this.pendingUserInfo = const [],
+    this.preview = false,
   });
 
   OnboardingState copyWith({
     DateTime? reminder,
     List<UserInfoDetail>? pendingUserInfo,
+    bool? preview,
   }) {
     return OnboardingState(
       reminder: reminder ?? this.reminder,
       pendingUserInfo: pendingUserInfo ?? this.pendingUserInfo,
+      preview: preview ?? this.preview,
     );
   }
 }