kasy-cli 1.39.0 → 1.39.1

package/lib/scaffold/CHANGELOG.json

@@ -1,4 +1,13 @@
 {
+  "1.39.1": {
+    "modules": {
+      "core": {
+        "pt": "Ajuste fino da proporção da web: a escala passou de 0.95 para 0.93 (a interface fica um pouco menor, mais perto do tamanho do app nativo). É só calibragem do mesmo knob único (kWebViewportScale) em todos os breakpoints; o nativo continua em 1.0 e dá pra desligar tudo numa linha (kWebViewportScaleEnabled).",
+        "en": "Fine-tuned the web proportion: the scale went from 0.95 to 0.93 (the interface is a touch smaller, closer to the native app size). It is just calibration of the same single knob (kWebViewportScale) across every breakpoint; native stays at 1.0 and the whole thing can be turned off in one line (kWebViewportScaleEnabled).",
+        "es": "Ajuste fino de la proporción web: la escala pasó de 0.95 a 0.93 (la interfaz queda un poco más pequeña, más cerca del tamaño del app nativo). Es solo calibración del mismo knob único (kWebViewportScale) en todos los breakpoints; el nativo se mantiene en 1.0 y todo se puede apagar en una línea (kWebViewportScaleEnabled)."
+      }
+    }
+  },
   "1.39.0": {
     "modules": {
       "core": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kasy-cli",
-  "version": "1.39.0",
+  "version": "1.39.1",
   "description": "CLI for scaffolding production-ready Flutter SaaS apps with Firebase, Supabase, or API REST backends.",
   "bin": {
     "kasy": "./bin/kasy.js"

package/templates/firebase/AGENTS.md

@@ -64,8 +64,8 @@ Typography collapses `large`+`xlarge` into one "desktop" tier (same sizes); the
 - **Native mobile** is straightforward: it's the Mobile breakpoint and never
   scales the viewport.
 - **Web render scale** (`WebViewportScale`) is a *separate* concern: Flutter web
-  renders ~10% large, so **desktop only** scales the whole UI to `0.95`. Tablet
-  and mobile web render at natural size, like native. This is NOT the typography
+  renders ~10% large at every width, so the whole web UI (phone, tablet, desktop)
+  is scaled to `0.93`; native renders at natural `1.0`. This is NOT the typography
   scale — don't conflate the two.
 - **Screen width follows content type** (two tiers): read/form screens (Settings,
   Notifications) are contained + centred at `kKasyContentMaxWidth` (600) — set

package/templates/firebase/DESIGN_SYSTEM.md

@@ -107,11 +107,12 @@ separate concern from type sizes, sitting in a layer ON TOP of the responsive
 system — it does NOT replace breakpoints, the type ramp or spacing (turn it off
 and the app is still fully responsive, just larger). Flutter web renders ~10%
 larger than an equivalent native/HTML app at 100% zoom, **at every width**. So the
-whole web app — phone, tablet and desktop — is scaled to `0.95` (~5%; a true
+whole web app — phone, tablet and desktop — is scaled to `0.93` (~7%; a true
 viewport scale, so layout, scrolling and hit-testing stay correct), making web
 read close to the native baseline with **no size jump across breakpoints**. `0.90`
 fully undoes the 10% but reads small on a monitor (native sizes are tuned for a
-phone held close), so `0.95` (the midpoint) is the calibrated default. Two knobs:
+phone held close), so `0.93` (a touch past the midpoint, still short of a full
+undo) is the calibrated default. Two knobs:
 `kWebViewportScaleEnabled` (master on/off — `false` makes web render at native
 `1.0`) and `kWebViewportScale` (the value). Two things are never scaled, both at
 native `1.0`: **native** itself (gated on `kIsWeb`, so iOS/Android/macOS/Windows

package/templates/firebase/lib/components/components.dart

@@ -1,11 +1,14 @@
 /// Kasy UI components — Material-backed wrappers with a stable kit API.
 ///
-/// Includes screen chrome ([KasyAppBar], [KasyOverlayScaffold], [kasyOverlayPaddedSlivers]).
+/// Includes screen chrome ([KasyAppBar], [KasyOverlayScaffold], [kasyOverlayPaddedSlivers])
+/// and its per-screen desktop config ([KasyAppBarConfig], [KasyAppBarConfigurator]).
 ///
 /// Import:
 ///   import 'package:kasy_kit/components/components.dart';
 library;
 
+export 'package:kasy_kit/core/chrome/app_bar_config.dart';
+export 'package:kasy_kit/core/chrome/app_bar_scope.dart';
 export 'kasy_accordion.dart';
 export 'kasy_alert.dart';
 export 'kasy_app_bar.dart';

package/templates/firebase/lib/components/kasy_app_bar.dart

@@ -810,6 +810,12 @@ class KasyOverlayScaffold extends StatelessWidget {
   /// the overlay pattern (bar floats over full-height scroll content).
   final bool hideAppBarOnScroll;
 
+  /// Desktop only: adapt the shell's application bar for this screen. Receives the
+  /// shell default; return e.g. `bar.only(search: true)`. No-op on phone/tablet
+  /// (there the page chrome above is what shows). Shortcut for wrapping the body
+  /// in a [KasyAppBarConfigurator].
+  final KasyAppBarConfigure? applicationBar;
+
   const KasyOverlayScaffold({
     super.key,
     required this.title,
@@ -826,6 +832,7 @@ class KasyOverlayScaffold extends StatelessWidget {
     this.onRefresh,
     this.refreshIndicatorDisplacement = 48,
     this.hideAppBarOnScroll = false,
+    this.applicationBar,
   });
 
   @override
@@ -856,7 +863,7 @@ class KasyOverlayScaffold extends StatelessWidget {
         child: scrollView,
       );
     }
-    return Scaffold(
+    final Widget scaffold = Scaffold(
       backgroundColor: bg,
       body: Stack(
         fit: StackFit.expand,
@@ -878,6 +885,9 @@ class KasyOverlayScaffold extends StatelessWidget {
         ],
       ),
     );
+    final KasyAppBarConfigure? configure = applicationBar;
+    if (configure == null) return scaffold;
+    return KasyAppBarConfigurator(configure: configure, child: scaffold);
   }
 }
 

package/templates/firebase/lib/core/bottom_menu/web_content_wrapper.dart

@@ -41,6 +41,20 @@ class _WebContentWrapperState extends State<WebContentWrapper> {
     skipTraversal: true,
   );
 
+  /// Shell-wide default for the desktop application bar: empty search, theme
+  /// toggle, the data-aware notifications bell, quick-create, and no avatar (the
+  /// sidebar owns the profile). Screens adapt this via [KasyAppBarConfigurator].
+  late final KasyAppBarConfig _defaultAppBarConfig = KasyAppBarConfig(
+    onToggleTheme: () => ThemeProvider.of(context).toggle(),
+    notifications: const WebNotificationsBell(),
+    onCreate: () {},
+    showAvatar: false,
+  );
+
+  /// Live config the bar renders; starts at the default, screens publish into it.
+  late final ValueNotifier<KasyAppBarConfig> _appBarConfig =
+      ValueNotifier<KasyAppBarConfig>(_defaultAppBarConfig);
+
   @override
   void initState() {
     super.initState();
@@ -53,6 +67,7 @@ class _WebContentWrapperState extends State<WebContentWrapper> {
       kasyContentFocusTarget = null;
     }
     _contentFocus.dispose();
+    _appBarConfig.dispose();
     super.dispose();
   }
 
@@ -71,21 +86,22 @@ class _WebContentWrapperState extends State<WebContentWrapper> {
     // page-level KasyAppBar hides on desktop here (the application bar owns the
     // chrome). Outside this scope (full-screen pushed routes) the bar stays visible.
     return KasyAppBarScope(
+      config: _appBarConfig,
+      defaultConfig: _defaultAppBarConfig,
       child: ColoredBox(
         color: context.colors.background,
         child: Column(
         crossAxisAlignment: CrossAxisAlignment.stretch,
         children: [
-          // The sidebar carries the user profile here, so the header drops its
-          // avatar (showAvatar: false) to avoid duplicating the account chip.
+          // One application bar for the whole shell; each screen tunes it through
+          // a KasyAppBarConfigurator that publishes into [_appBarConfig].
           FocusTraversalOrder(
             order: const NumericFocusOrder(2),
             child: FocusTraversalGroup(
-              child: KasyAppBar.application(
-                onToggleTheme: () => ThemeProvider.of(context).toggle(),
-                notifications: const WebNotificationsBell(),
-                onCreate: () {},
-                showAvatar: false,
+              child: ValueListenableBuilder<KasyAppBarConfig>(
+                valueListenable: _appBarConfig,
+                builder: (context, config, _) =>
+                    KasyAppBar.fromConfig(config),
               ),
             ),
           ),

package/templates/firebase/lib/core/chrome/app_bar_config.dart

@@ -63,7 +63,7 @@ class KasyAppBarConfig {
     this.showCreate = true,
     this.createLabel = 'Create',
     this.onCreate,
-    this.showAvatar = false,
+    this.showAvatar = true,
     this.avatar,
     this.avatarGradient,
     this.onAvatarTap,

package/templates/firebase/lib/core/rating/widgets/review_popup.dart

@@ -1,21 +1,28 @@
 import 'package:flutter/foundation.dart' show kIsWeb;
 import 'package:flutter/material.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/models/review.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/i18n/translations.g.dart';
 import 'package:logger/logger.dart';
 
-/// Shows the in-app review dialog. Prefer a stable [context] (not a sheet that
+/// Shows the in-app review funnel. Prefer a stable [context] (not a sheet that
 /// will be popped before the async work finishes).
 ///
-/// A clean [KasyDialog] focused on a single goal: a positive store rating. A
-/// gold star, a warm title/message and one action (write a review on the
-/// Android/Play or iOS App Store). Dismissing via the dialog's own close button
-/// just defers the next ask and keeps the user where they are.
+/// Two-step "rating protection" funnel:
+///   1. A sentiment gate ("Enjoying the app?") with a positive / negative pick.
+///   2a. Positive → a gold-star [KasyDialog] that sends the user to the store
+///       (App Store / Play Store) to write a public review.
+///   2b. Negative → the private `/feedback` screen, so an unhappy user vents to
+///       us instead of leaving a low public rating.
+///
+/// Dismissing any step just defers the next ask and keeps the user where they
+/// are. Returns true once the funnel was shown (regardless of the branch taken).
 Future<bool> showReviewDialog(
   BuildContext context,
   WidgetRef ref, {
@@ -23,7 +30,7 @@ Future<bool> showReviewDialog(
 }) async {
   // Store reviews are native-only (App Store / Play Store). In production the
   // auto prompt never shows on web (nowhere to send the user). But a forced
-  // call — the admin preview — still shows the dialog on web so its design can
+  // call — the admin preview — still shows the funnel on web so its design can
   // be reviewed there; only the store action won't do anything.
   if (kIsWeb && !force) {
     return false;
@@ -46,26 +53,102 @@ Future<bool> showReviewDialog(
     return false;
   }
 
-  await showKasyDialog<void>(
+  // Defer the next ask up front, so any outcome (dismiss, positive, negative)
+  // counts as "asked" and we don't pester the user again right away.
+  await rating.delay();
+  analytics.logEvent('rating_funnel_open', {});
+  if (!context.mounted) {
+    return false;
+  }
+
+  // Step 1 — sentiment gate.
+  final bool? enjoying = await _askEnjoying(context, analytics);
+  if (enjoying == null) {
+    return true; // dismissed without choosing
+  }
+
+  // Step 2b — negative branch: keep the bad review private.
+  if (!enjoying) {
+    analytics.logEvent('rating_funnel_negative', {});
+    if (context.mounted) {
+      await context.push('/feedback');
+    }
+    return true;
+  }
+
+  // Step 2a — positive branch: send the happy user to the store.
+  analytics.logEvent('rating_funnel_positive', {});
+  if (!context.mounted) {
+    return true;
+  }
+  await _askStoreReview(context, ratingRepository, rating, analytics);
+  return true;
+}
+
+/// Step 1: the sentiment gate. Returns true (enjoying), false (could be better)
+/// or null (dismissed without choosing).
+Future<bool?> _askEnjoying(BuildContext context, AnalyticsApi analytics) {
+  return showKasyDialog<bool>(
     context: context,
     builder: (dialogContext) {
-      ratingRepository.delay();
-      final translations = Translations.of(dialogContext).review_popup;
+      final t = Translations.of(dialogContext).review_popup;
+      return KasyDialog(
+        leadingIcon: KasyIcons.favorite,
+        iconTone: KasyDialogIconTone.info,
+        title: t.question_title,
+        titleCentered: true,
+        message: t.question_description,
+        onClose: () {
+          analytics.logEvent('rating_funnel_dismiss', {});
+          Navigator.of(dialogContext).pop();
+        },
+        footer: Column(
+          crossAxisAlignment: CrossAxisAlignment.stretch,
+          children: [
+            KasyButton(
+              label: t.question_positive,
+              expand: true,
+              onPressed: () => Navigator.of(dialogContext).pop(true),
+            ),
+            const SizedBox(height: KasySpacing.sm),
+            KasyButton(
+              label: t.question_negative,
+              variant: KasyButtonVariant.soft,
+              expand: true,
+              onPressed: () => Navigator.of(dialogContext).pop(false),
+            ),
+          ],
+        ),
+      );
+    },
+  );
+}
+
+/// Step 2a (positive branch): the celebratory store-review dialog.
+Future<void> _askStoreReview(
+  BuildContext context,
+  RatingRepository ratingRepository,
+  Review rating,
+  AnalyticsApi analytics,
+) {
+  return showKasyDialog<void>(
+    context: context,
+    builder: (dialogContext) {
+      final t = Translations.of(dialogContext).review_popup;
       return KasyDialog(
         leadingIcon: KasyIcons.star,
         // Gold/amber star via KasyDialog's default `warning` tone — the design
         // system's amber (#F5A524 light / #F7B750 dark), the natural colour for
         // a rating star.
-        title: translations.title,
+        title: t.title,
         titleCentered: true,
-        message: translations.description,
+        message: t.description,
         onClose: () {
           analytics.logEvent('rating_popup_close', {});
-          rating.delay();
           Navigator.of(dialogContext).pop();
         },
         footer: KasyButton(
-          label: translations.rate_button,
+          label: t.rate_button,
           expand: true,
           onPressed: () {
             analytics.logEvent('rating_popup_show', {});
@@ -78,5 +161,4 @@ Future<bool> showReviewDialog(
       );
     },
   );
-  return true;
 }

package/templates/firebase/lib/core/web_viewport_scale.dart

@@ -7,11 +7,12 @@ import 'package:kasy_kit/core/web_screen_width.dart';
 ///
 /// Flutter web renders ~10% larger than an equivalent native/HTML app at the
 /// browser's 100% zoom, at any width — so the whole web UI feels oversized.
-/// `0.95` walks back ~5% so the web app reads close to the native baseline
-/// without the user touching browser zoom — a gentle correction (the exact
-/// midpoint between full size and a total undo) that takes the "oversized" edge
-/// off Flutter web without making things feel small (0.90 fully undoes the 10%
-/// but reads small on a monitor — one number to nudge). On desktop it also acts
+/// `0.93` walks back ~7% so the web app reads close to the native baseline
+/// without the user touching browser zoom — a gentle correction (a bit stronger
+/// than the midpoint between full size and a total undo, but still short of
+/// fully undoing the 10%) that takes the "oversized" edge off Flutter web
+/// without making things feel small (0.90 fully undoes the 10% but reads small
+/// on a monitor — one number to nudge). On desktop it also acts
 /// as a cap: a
 /// screen below the design target (high OS scale) reduces it further to pin the
 /// layout (see [kWebViewportScaleTargetWidth]); phone/tablet take the flat cap
@@ -24,11 +25,11 @@ import 'package:kasy_kit/core/web_screen_width.dart';
 /// - The in-app DEVICE PREVIEW — it simulates a native device, so it must show
 ///   the native 1.0 truth; the scale is skipped once the preview frame is up
 ///   (see main.dart, gated on `webDevicePreviewActiveNotifier`).
-const double kWebViewportScale = 0.95;
+const double kWebViewportScale = 0.93;
 
 /// Master on/off for the web render scale — the single knob.
 ///
-/// `true` (default): the web app is rendered ~5% smaller than native via
+/// `true` (default): the web app is rendered ~7% smaller than native via
 /// [kWebViewportScale], correcting Flutter web's oversized feel on desktop while
 /// native stays at true 1.0. This is a deliberate, web-only density correction
 /// (the same technique `responsive_framework`'s autoScale productizes), applied

package/templates/firebase/lib/features/home/home_components_preview_registry.dart

@@ -101,6 +101,15 @@ ComponentPreviewDefinition? getComponentPreviewDefinition(
             label: 'Application no avatar (desktop)',
             builder: _buildAppBarApplicationNoAvatarVariant,
           ),
+          // Per-screen presets — same bar, a screen picking its own chrome.
+          ComponentPreviewVariant(
+            label: 'Search only (desktop)',
+            builder: _buildAppBarApplicationSearchOnlyVariant,
+          ),
+          ComponentPreviewVariant(
+            label: 'Notifications only (desktop)',
+            builder: _buildAppBarApplicationNotificationsOnlyVariant,
+          ),
         ],
       );
     case 'Button':
@@ -1942,16 +1951,42 @@ Widget _buildAppBarMenuVariant(BuildContext context) {
   );
 }
 
+/// A fully-wired desktop config for previews — every element active, so each
+/// variant can switch one thing on/off and read clearly.
+KasyAppBarConfig _demoAppBarConfig() => KasyAppBarConfig(
+      onToggleTheme: () {},
+      onNotifications: () {},
+      onCreate: () {},
+      onAvatarTap: () {},
+    );
+
 Widget _buildAppBarApplicationVariant(BuildContext context) {
-  return const _ApplicationBarPreview();
+  return _ApplicationBarPreview(config: _demoAppBarConfig());
 }
 
 Widget _buildAppBarApplicationBadgeVariant(BuildContext context) {
-  return const _ApplicationBarPreview(showBadge: true);
+  return _ApplicationBarPreview(
+    config: _demoAppBarConfig().copyWith(showNotificationBadge: true),
+  );
 }
 
 Widget _buildAppBarApplicationNoAvatarVariant(BuildContext context) {
-  return const _ApplicationBarPreview(showAvatar: false);
+  return _ApplicationBarPreview(
+    config: _demoAppBarConfig().copyWith(showAvatar: false),
+  );
+}
+
+// Per-screen presets: the same component, different chrome chosen by a screen.
+Widget _buildAppBarApplicationSearchOnlyVariant(BuildContext context) {
+  return _ApplicationBarPreview(
+    config: _demoAppBarConfig().only(search: true, themeToggle: true),
+  );
+}
+
+Widget _buildAppBarApplicationNotificationsOnlyVariant(BuildContext context) {
+  return _ApplicationBarPreview(
+    config: _demoAppBarConfig().only(notifications: true, themeToggle: true),
+  );
 }
 
 Widget _buildButtonSizesVariant(BuildContext context) {
@@ -3884,10 +3919,11 @@ class _AccordionPreviewState extends State<_AccordionPreview> {
 /// bar + faux sidebar + content) so the preview reads as the desktop chrome it
 /// is — the responsive desktop half of [KasyAppBar].
 class _ApplicationBarPreview extends StatelessWidget {
-  final bool showBadge;
-  final bool showAvatar;
+  /// The exact config a screen would publish — rendered through the same
+  /// [KasyAppBar.fromConfig] the shell uses, so the preview mirrors real usage.
+  final KasyAppBarConfig config;
 
-  const _ApplicationBarPreview({this.showBadge = false, this.showAvatar = true});
+  const _ApplicationBarPreview({required this.config});
 
   /// Width the mock window is laid out at. The application bar is desktop chrome
   /// (220px search + actions), so it needs a desktop-class width — we render at
@@ -3916,13 +3952,7 @@ class _ApplicationBarPreview extends StatelessWidget {
               children: [
                 const _BrowserTopBar(),
                 // The real bar, flush — no corner radius of its own.
-                KasyAppBar.application(
-                  showNotificationBadge: showBadge,
-                  showAvatar: showAvatar,
-                  onNotifications: () {},
-                  onCreate: () {},
-                  onAvatarTap: () {},
-                ),
+                KasyAppBar.fromConfig(config),
                 const SizedBox(
                   height: 150,
                   child: Row(

package/templates/firebase/lib/features/settings/ui/components/admin/admin_home_widgets.dart

@@ -5,6 +5,7 @@ import 'package:kasy_kit/components/kasy_app_bar.dart';
 import 'package:kasy_kit/core/home_widgets/home_widget_mywidget_service.dart';
 import 'package:kasy_kit/core/theme/theme.dart';
 import 'package:kasy_kit/core/widgets/kasy_scroll_behavior.dart';
+import 'package:kasy_kit/core/widgets/responsive_layout.dart';
 import 'package:kasy_kit/features/settings/ui/widgets/admin_card.dart';
 import 'package:kasy_kit/i18n/translations.g.dart';
 
@@ -18,6 +19,9 @@ class AdminHomeWidgets extends ConsumerWidget {
       child: KasyOverlayScaffold(
         title: t.settings.admin.home_widgets_title,
         onBack: () => context.pop(),
+        // Contain + center the single utility card on desktop so it never
+        // stretches edge-to-edge, matching Notifications / Reminders.
+        maxContentWidth: kKasyContentMaxWidth,
         slivers: [
           SliverList.list(
             children: [

package/templates/firebase/lib/i18n/en.i18n.json

@@ -460,8 +460,12 @@
     "cancel_button": "Cancel"
   },
   "review_popup": {
-    "title": "Enjoying the app?",
-    "description": "If the app has been helpful, a store review makes all the difference. It takes a few seconds and really helps us grow.",
+    "question_title": "Enjoying the app?",
+    "question_description": "Your answer helps us improve.",
+    "question_positive": "Yes, I am",
+    "question_negative": "Could be better",
+    "title": "Glad you like it!",
+    "description": "A store review makes all the difference. It takes a few seconds and really helps us grow.",
     "rate_button": "Write a review"
   },
   "navigation": {

package/templates/firebase/lib/i18n/es.i18n.json

@@ -460,8 +460,12 @@
     "cancel_button": "Cancelar"
   },
   "review_popup": {
-    "title": "¿Te gusta la app?",
-    "description": "Si la app te ha sido útil, una reseña en la tienda marca la diferencia. Toma unos segundos y nos ayuda mucho a crecer.",
+    "question_title": "¿Te gusta la app?",
+    "question_description": "Tu respuesta nos ayuda a mejorar.",
+    "question_positive": "Sí, me gusta",
+    "question_negative": "Podría mejorar",
+    "title": "¡Qué bueno que te guste!",
+    "description": "Una reseña en la tienda marca la diferencia. Toma unos segundos y nos ayuda mucho a crecer.",
     "rate_button": "Escribir una reseña"
   },
   "navigation": {

package/templates/firebase/lib/i18n/pt.i18n.json

@@ -460,8 +460,12 @@
     "cancel_button": "Cancelar"
   },
   "review_popup": {
-    "title": "Está gostando do app?",
-    "description": "Se o app tem te ajudado, uma avaliação na loja faz toda a diferença. Leva poucos segundos e ajuda demais a gente a crescer.",
+    "question_title": "Está gostando do app?",
+    "question_description": "Sua resposta ajuda a gente a melhorar.",
+    "question_positive": "Sim, estou gostando",
+    "question_negative": "Poderia melhorar",
+    "title": "Que bom que curtiu!",
+    "description": "Uma avaliação na loja faz toda a diferença. Leva poucos segundos e ajuda demais a gente a crescer.",
     "rate_button": "Escrever uma avaliação"
   },
   "navigation": {

package/templates/firebase/pubspec.yaml

@@ -16,7 +16,7 @@ publish_to: 'none' # Remove this line if you wish to publish to pub.dev
 # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
 # In Windows, build-name is used as the major, minor, and patch parts
 # of the product and file versions while build-number is used as the build suffix.
-version: 1.0.0+66
+version: 1.0.0+67
 
 environment:
   sdk: ^3.11.0

package/templates/firebase/test/app_bar_config_test.dart

@@ -0,0 +1,70 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:kasy_kit/components/components.dart';
+
+/// The per-screen desktop bar override is just data: a screen transforms the
+/// shell default into its own [KasyAppBarConfig]. These lock that logic.
+void main() {
+  group('KasyAppBarConfig', () {
+    test('bare config shows every element (mirrors the shell default)', () {
+      const KasyAppBarConfig c = KasyAppBarConfig();
+      expect(c.showSearch, isTrue);
+      expect(c.showThemeToggle, isTrue);
+      expect(c.showNotifications, isTrue);
+      expect(c.showCreate, isTrue);
+      expect(c.showAvatar, isTrue);
+    });
+
+    test('only() shows just the listed elements but keeps their wiring', () {
+      void bell() {}
+      void toggle() {}
+      final KasyAppBarConfig base = KasyAppBarConfig(
+        onNotifications: bell,
+        onToggleTheme: toggle,
+      );
+
+      final KasyAppBarConfig cfg = base.only(notifications: true, themeToggle: true);
+
+      expect(cfg.showNotifications, isTrue);
+      expect(cfg.showThemeToggle, isTrue);
+      expect(cfg.showSearch, isFalse);
+      expect(cfg.showCreate, isFalse);
+      expect(cfg.showAvatar, isFalse);
+      // The shell's bell/theme callbacks survive the override.
+      expect(cfg.onNotifications, same(bell));
+      expect(cfg.onToggleTheme, same(toggle));
+    });
+
+    test('search preset = search + theme only', () {
+      const KasyAppBarConfig cfg = KasyAppBarConfig.search();
+      expect(cfg.showSearch, isTrue);
+      expect(cfg.showThemeToggle, isTrue);
+      expect(cfg.showNotifications, isFalse);
+      expect(cfg.showCreate, isFalse);
+      expect(cfg.showAvatar, isFalse);
+    });
+
+    test('minimal preset = theme toggle only', () {
+      const KasyAppBarConfig cfg = KasyAppBarConfig.minimal();
+      expect(cfg.showThemeToggle, isTrue);
+      expect(cfg.showSearch, isFalse);
+      expect(cfg.showNotifications, isFalse);
+      expect(cfg.showCreate, isFalse);
+      expect(cfg.showAvatar, isFalse);
+    });
+
+    test('copyWith with no changes is value-equal (no churn on the bar)', () {
+      const KasyAppBarConfig a = KasyAppBarConfig();
+      final KasyAppBarConfig b = a.copyWith();
+      expect(a, equals(b));
+      expect(a.hashCode, equals(b.hashCode));
+    });
+
+    test('copyWith changes only the named field', () {
+      const KasyAppBarConfig a = KasyAppBarConfig();
+      final KasyAppBarConfig b = a.copyWith(showSearch: false);
+      expect(b.showSearch, isFalse);
+      expect(b.showCreate, isTrue);
+      expect(a == b, isFalse);
+    });
+  });
+}