kasy-cli 1.38.0 → 1.39.0

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,
     );
   }
 }

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

@@ -30,7 +30,25 @@ class OnboardingNotifier extends _$OnboardingNotifier {
     return OnboardingState();
   }
 
+  /// Enter/leave preview mode. Called once when [OnboardingPage] mounts: the
+  /// admin Debug "Test onboarding" entry sets `true`, the real flow sets
+  /// `false`, so the flag is always correct on every entry.
+  void setPreview(bool value) {
+    if (state.preview == value) return;
+    state = state.copyWith(preview: value);
+  }
+
   Future<void> onAnsweredQuestion(UserInfoDetail value) async {
+    // Preview: never touch the admin's real profile. Buffer the answer so the
+    // question screens still behave (selection persists across steps), but it's
+    // discarded with the provider state once the preview ends.
+    if (state.preview) {
+      final others = state.pendingUserInfo
+          .where((info) => info.runtimeType != value.runtimeType)
+          .toList();
+      state = state.copyWith(pendingUserInfo: [...others, value]);
+      return;
+    }
     final userId = ref.read(userStateNotifierProvider).user.idOrNull;
     if (userId != null) {
       // Account already exists (e.g. a returning guest re-onboarding): save now.
@@ -47,6 +65,10 @@ class OnboardingNotifier extends _$OnboardingNotifier {
   }
 
   Future<void> setupNotifications() async {
+    // Preview: don't fire the real OS permission dialog or log analytics — the
+    // permission screen is shown for review only.
+    if (state.preview) return;
+
     final userStateNotifier = ref.read(userStateNotifierProvider.notifier);
     final notificationsRepository = ref.read(notificationRepositoryProvider);
 
@@ -75,6 +97,10 @@ class OnboardingNotifier extends _$OnboardingNotifier {
   }
 
   Future<void> onOnboardingCompleted() async {
+    // Preview: this is the step that would create the anonymous guest account
+    // and flush profile writes. Do nothing — the preview just returns to Debug.
+    if (state.preview) return;
+
     final userStateNotifier = ref.read(userStateNotifierProvider.notifier);
 
     // This is the "preparing everything for you" moment (the loader screen):
@@ -106,6 +132,8 @@ class OnboardingNotifier extends _$OnboardingNotifier {
   /// Skip onboarding: mark as onboarded instantly (optimistic) and navigate
   /// to home. Permissions (push + ATT) are requested on the home screen.
   void skipOnboarding() {
+    // Preview: skipping must not mark the real user as onboarded.
+    if (state.preview) return;
     ref.read(userStateNotifierProvider.notifier).onSkippedOnboarding();
   }
 }

package/templates/firebase/lib/features/onboarding/ui/onboarding_page.dart

@@ -9,22 +9,55 @@ import 'package:kasy_kit/features/onboarding/ui/components/onboarding_features.d
 import 'package:kasy_kit/features/onboarding/ui/components/onboarding_loader.dart';
 import 'package:kasy_kit/features/onboarding/ui/components/onboarding_notifications_setup.dart';
 import 'package:kasy_kit/features/onboarding/ui/components/onboarding_questions.dart';
+import 'package:kasy_kit/features/settings/ui/components/admin/admin_routes.dart';
 import 'package:kasy_kit/features/subscriptions/ui/premium_page.dart';
 import 'package:kasy_kit/router.dart';
 
 
-class OnboardingPage extends ConsumerWidget {
-  const OnboardingPage({super.key});
+class OnboardingPage extends ConsumerStatefulWidget {
+  /// Preview mode: the flow is opened from the admin Debug screen just to walk
+  /// the screens. Real side effects are suppressed (see [OnboardingNotifier])
+  /// and the flow returns to Debug instead of Home/paywall.
+  final bool preview;
+
+  const OnboardingPage({super.key, this.preview = false});
+
+  @override
+  ConsumerState<OnboardingPage> createState() => _OnboardingPageState();
+}
+
+class _OnboardingPageState extends ConsumerState<OnboardingPage> {
+  @override
+  void initState() {
+    super.initState();
+    // Set the flag on every entry (true for the admin preview, false for the
+    // real flow) so the notifier's side-effect guards are always correct. The
+    // first screen has no side effects, so a post-frame write is safe.
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      if (!mounted) return;
+      ref.read(onboardingProvider.notifier).setPreview(widget.preview);
+    });
+  }
+
+  /// Where the flow lands when finished: back to the admin Debug screen in
+  /// preview, Home otherwise.
+  void _exit() => ref
+      .read(goRouterProvider)
+      .go(widget.preview ? adminRouteDebug : '/');
 
   @override
-  Widget build(BuildContext context, WidgetRef ref) {
+  Widget build(BuildContext context) {
+    final bool preview = widget.preview;
     return Navigator(
       initialRoute: 'feature_1',
+      // No analytics in preview — walking the flow from Debug must not pollute
+      // real onboarding funnels.
       observers: [
-        AnalyticsObserver(
-          prefix: 'userOnboarding/',
-          analyticsApi: MixpanelAnalyticsApi.instance(),
-        ),
+        if (!preview)
+          AnalyticsObserver(
+            prefix: 'userOnboarding/',
+            analyticsApi: MixpanelAnalyticsApi.instance(),
+          ),
       ],
       onGenerateRoute: (settings) => switch (settings.name) {
         'feature_1' => OnboardingRouteTransition(
@@ -33,7 +66,11 @@ class OnboardingPage extends ConsumerWidget {
               onSkip: () => Navigator.of(context).pushReplacementNamed(
                 'skip_loader',
               ),
-              onLogin: () => ref.read(goRouterProvider).go('/signin'),
+              // In preview, leaving to the real sign-in screen would break the
+              // "everything just returns to Debug" contract, so go back instead.
+              onLogin: () => preview
+                  ? _exit()
+                  : ref.read(goRouterProvider).go('/signin'),
             ),
             settings: settings,
           ),
@@ -79,9 +116,11 @@ class OnboardingPage extends ConsumerWidget {
           ),
         'loader' => OnboardingRouteTransition(
             builder: (context) => OnboardingLoader(
-              onCompleted: () => Navigator.of(context).pushReplacementNamed(
-                'paywall',
-              ),
+              // Preview stops here (the paywall has its own admin preview) and
+              // returns to Debug; the real flow continues to the paywall.
+              onCompleted: () => preview
+                  ? _exit()
+                  : Navigator.of(context).pushReplacementNamed('paywall'),
             ),
             settings: settings,
           ),
@@ -89,7 +128,7 @@ class OnboardingPage extends ConsumerWidget {
             builder: (context) => OnboardingLoader(
               onCompleted: () {
                 ref.onboardingNotifier.skipOnboarding();
-                ref.read(goRouterProvider).go('/');
+                _exit();
               },
             ),
             settings: settings,