kasy-cli 1.24.0 → 1.25.0

package/lib/utils/flutter-install.js

@@ -43,12 +43,24 @@ $ProgressPreference = 'SilentlyContinue'
 $dest = Join-Path $env:LOCALAPPDATA 'flutter'
 $bin = Join-Path $dest 'bin'
 
+function Sync-Path {
+  # Pull the persistent PATH (Machine + User) into THIS session so a tool just
+  # installed by winget (Git) becomes visible right away.
+  $m = [Environment]::GetEnvironmentVariable('Path', 'Machine')
+  $u = [Environment]::GetEnvironmentVariable('Path', 'User')
+  $env:Path = (@($m, $u) | Where-Object { $_ }) -join ';'
+}
+
 # 1. Git — Flutter uses it internally and won't run without it.
 if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
   if (Get-Command winget -ErrorAction SilentlyContinue) {
     winget install --id Git.Git -e --source winget --silent --accept-source-agreements --accept-package-agreements --disable-interactivity | Out-Null
+    Sync-Path
   }
 }
+if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
+  throw 'Git is required for Flutter but is not available. Install Git and run this again.'
+}
 
 # 2. Flutter SDK — download + unzip, unless it's already there.
 if (-not (Test-Path (Join-Path $bin 'flutter.bat'))) {
@@ -67,8 +79,21 @@ if (-not (Test-Path (Join-Path $bin 'flutter.bat'))) {
   [System.IO.Compression.ZipFile]::ExtractToDirectory($zip, $env:LOCALAPPDATA)
   Remove-Item $zip -Force -ErrorAction SilentlyContinue
 }
+if (-not (Test-Path (Join-Path $bin 'flutter.bat'))) {
+  throw 'Flutter download/extract did not produce flutter.bat.'
+}
+
+# 3. Make flutter usable in THIS session and warm it up. The very first flutter
+#    command downloads the bundled Dart SDK (a few hundred MB), which can take
+#    minutes — doing it here, inside the installer, keeps the caller's follow-up
+#    "flutter --version" check fast instead of timing out on the cold first run.
+if ($env:Path -notlike "*$bin*") { $env:Path = "$bin;$env:Path" }
+& (Join-Path $bin 'flutter.bat') --version 2>&1 | Out-Null
+if ($LASTEXITCODE -ne 0) {
+  throw 'Flutter was installed but its first run failed (Dart SDK bootstrap). Check your internet connection and run this again.'
+}
 
-# 3. Persist flutter\\bin on the User PATH so every future terminal finds it.
+# 4. Persist flutter\\bin on the User PATH so every future terminal finds it.
 $userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
 if (-not $userPath) { $userPath = '' }
 if (($userPath -split ';') -notcontains $bin) {

package/package.json

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

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

@@ -119,6 +119,10 @@ class KasyCard extends StatelessWidget {
         onPressed: onTap!,
         semanticLabel: semanticLabel ?? 'Card',
         clipBorderRadius: resolvedRadius,
+        // A tappable card is an actionable control, so make it a keyboard
+        // tab-stop with the standard focus ring (matches buttons/links).
+        focusable: true,
+        focusBorderRadius: resolvedRadius,
         child: margined,
       );
     }

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

@@ -579,6 +579,8 @@ class _KasySidebarState extends State<KasySidebar> {
       borderRadius: BorderRadius.circular(_kToggleSize / 2),
       hoverColor: c.activeBg,
       pressColor: c.textActive,
+      focusable: true,
+      focusGapColor: c.bg,
       onTap: _toggleCollapse,
       child: Container(
         width: _kToggleSize,
@@ -1071,6 +1073,8 @@ class _KasySidebarState extends State<KasySidebar> {
             borderRadius: BorderRadius.circular(_kItemRadius),
             hoverColor: c.activeBg,
             pressColor: c.textActive,
+            focusable: true,
+            focusGapColor: c.bg,
             onTap: () => _activateSubItem(label),
             child: Container(
               height: _kSubItemH,
@@ -1298,6 +1302,8 @@ class _ProTooltipIconState extends State<_ProTooltipIcon> {
             borderRadius: BorderRadius.circular(_kItemRadius),
             hoverColor: widget.activeBg,
             pressColor: widget.activeBg,
+            focusable: true,
+            focusGapColor: widget.colors.bg,
             onTap: widget.onTap,
             child: Container(
               padding: const EdgeInsets.symmetric(

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

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/core/widgets/kasy_focus_ring.dart';
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Data model

package/templates/firebase/lib/core/widgets/kasy_pressable_depth.dart

@@ -6,6 +6,8 @@ import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:kasy_kit/core/haptics/haptic_feedback_notifier.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/core/widgets/kasy_focus_ring.dart';
 
 /// Press-in with slight overshoot-back (same tactility as [KasyAlert] actions).
 ///
@@ -26,6 +28,22 @@ class KasyPressableDepth extends ConsumerStatefulWidget {
   /// If false, does not call [HapticFeedback.lightImpact] on tap.
   final bool hapticFeedbackEnabled;
 
+  /// When true, the control becomes a keyboard tab-stop: it is wrapped in a
+  /// [KasyFocusRing] so Tab shows the focus outline and Enter/Space activate it.
+  /// Defaults to false because [KasyButton] already wraps its own ring around
+  /// the child — turning this on there would paint a second ring. Use it for
+  /// direct, standalone uses (e.g. a text link) that need keyboard access.
+  final bool focusable;
+
+  /// Corner radius for the focus ring (only used when [focusable]). Defaults to
+  /// [clipBorderRadius] when set, otherwise a small radius hugging the visual.
+  final BorderRadius? focusBorderRadius;
+
+  /// Gap colour for the focus ring (only used when [focusable]). Pass the
+  /// surface the control sits on so the ring's hair-line gap blends in instead
+  /// of showing a halo (notably in dark mode). Null falls back to `background`.
+  final Color? focusGapColor;
+
   const KasyPressableDepth({
     super.key,
     required this.child,
@@ -34,6 +52,9 @@ class KasyPressableDepth extends ConsumerStatefulWidget {
     this.pressOverlayColor,
     this.clipBorderRadius,
     this.hapticFeedbackEnabled = true,
+    this.focusable = false,
+    this.focusBorderRadius,
+    this.focusGapColor,
   });
 
   @override
@@ -142,6 +163,21 @@ class _KasyPressableDepthState extends ConsumerState<KasyPressableDepth>
 
   @override
   Widget build(BuildContext context) {
+    // The ring wraps the scaled visual (not the 44px tap target) so it hugs the
+    // control's shape, and sits outside Transform.scale so it doesn't pulse with
+    // the press. Keyboard activation is wired to the same handler as the tap.
+    Widget visual = _wrapScaledChild(widget.child);
+    if (widget.focusable) {
+      visual = KasyFocusRing(
+        onActivate: _handleTap,
+        borderRadius: widget.focusBorderRadius ??
+            widget.clipBorderRadius ??
+            BorderRadius.circular(KasyRadius.sm),
+        gapColor: widget.focusGapColor,
+        child: visual,
+      );
+    }
+
     final Widget inner = Semantics(
       button: true,
       enabled: true,
@@ -153,7 +189,7 @@ class _KasyPressableDepthState extends ConsumerState<KasyPressableDepth>
         onTap: _handleTap,
         child: ConstrainedBox(
           constraints: const BoxConstraints(minWidth: 44, minHeight: 44),
-          child: Center(child: _wrapScaledChild(widget.child)),
+          child: Center(child: visual),
         ),
       ),
     );

package/templates/firebase/lib/features/authentication/ui/recover_password_page.dart

@@ -124,6 +124,7 @@ class _BackToSigninPrompt extends StatelessWidget {
                   context.go('/signin');
                 }
               },
+              focusable: true,
               child: Text(
                 t.auth.recover.signin_link,
                 style: context.textTheme.bodyMedium?.copyWith(

package/templates/firebase/lib/features/authentication/ui/signin_page.dart

@@ -98,11 +98,15 @@ class SigninPage extends ConsumerWidget {
                                 FocusScope.of(context).unfocus();
                                 ref.read(signinStateProvider.notifier).signin();
                               },
-                        labelTrailing: GestureDetector(
-                          onTap: () => context.push('/recover_password'),
-                          child: Text(
-                            t.auth.signin.forgot_password,
-                            style: forgotPasswordStyle,
+                        labelTrailing: KasyFocusRing(
+                          onActivate: () => context.push('/recover_password'),
+                          borderRadius: BorderRadius.circular(KasyRadius.sm),
+                          child: GestureDetector(
+                            onTap: () => context.push('/recover_password'),
+                            child: Text(
+                              t.auth.signin.forgot_password,
+                              style: forgotPasswordStyle,
+                            ),
                           ),
                         ),
                         validator: (value) {
@@ -191,6 +195,7 @@ class _SignupPrompt extends StatelessWidget {
             KasyPressableDepth(
               semanticLabel: t.auth.signin.signup_link,
               onPressed: () => context.pushReplacement('/signup'),
+              focusable: true,
               child: Text(
                 t.auth.signin.signup_link,
                 style: context.textTheme.bodyMedium?.copyWith(

package/templates/firebase/lib/features/authentication/ui/signup_page.dart

@@ -180,6 +180,7 @@ class _SigninPrompt extends StatelessWidget {
             KasyPressableDepth(
               semanticLabel: t.auth.signup.signin_link,
               onPressed: () => context.pushReplacement('/signin'),
+              focusable: true,
               child: Text(
                 t.auth.signup.signin_link,
                 style: context.textTheme.bodyMedium?.copyWith(

package/templates/firebase/lib/features/settings/settings_page.dart

@@ -12,6 +12,7 @@ import 'package:kasy_kit/core/security/biometric_ui_bundle.dart';
 import 'package:kasy_kit/core/states/logout_action.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/kasy_focus_ring.dart';
 import 'package:kasy_kit/core/widgets/kasy_hover.dart';
 import 'package:kasy_kit/features/settings/ui/components/avatar_component.dart';
 import 'package:kasy_kit/features/settings/ui/components/delete_user_component.dart';
@@ -329,7 +330,18 @@ class ProfileTile extends StatelessWidget {
       child: ClipRRect(
         borderRadius: KasyRadius.smBorderRadius,
         child: onTap != null
-            ? InkWell(onTap: onTap, child: content)
+            ? KasyFocusRing(
+                onActivate: onTap,
+                borderRadius: KasyRadius.smBorderRadius,
+                gapColor: context.colors.surface,
+                // The InkWell keeps its tap ripple but yields focus to the ring,
+                // so the keyboard outline matches every other Kasy control.
+                child: InkWell(
+                  canRequestFocus: false,
+                  onTap: onTap,
+                  child: content,
+                ),
+              )
             : content,
       ),
     );
@@ -547,6 +559,8 @@ class _NavTile extends StatelessWidget {
       borderRadius: KasyRadius.smBorderRadius,
       hoverColor: c.surfaceNeutralSoft,
       pressColor: c.onSurface,
+      focusable: true,
+      focusGapColor: c.surface,
       onTap: onTap,
       child: Container(
         padding: const EdgeInsets.symmetric(
@@ -770,6 +784,8 @@ class _LogoutRow extends StatelessWidget {
     return KasyHover(
       borderRadius: KasyRadius.smBorderRadius,
       pressColor: context.colors.error,
+      focusable: true,
+      focusGapColor: context.colors.surface,
       onTap: onTap,
       child: Padding(
         padding: const EdgeInsets.symmetric(vertical: KasySpacing.sm),

package/templates/firebase/lib/features/settings/ui/components/language_switcher.dart

@@ -5,6 +5,7 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:kasy_kit/core/home_widgets/home_widget_mywidget_service.dart';
 import 'package:kasy_kit/core/shared_preferences/shared_preferences.dart';
 import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/core/widgets/kasy_focus_ring.dart';
 import 'package:kasy_kit/features/settings/ui/widgets/settings_tile.dart';
 import 'package:kasy_kit/i18n/app_locale_display.dart';
 import 'package:kasy_kit/i18n/translations.g.dart';
@@ -17,31 +18,40 @@ class LanguageSwitcher extends ConsumerWidget {
   @override
   Widget build(BuildContext context, WidgetRef ref) {
     final AppLocale current = TranslationProvider.of(context).locale;
-    return InkWell(
-      onTap: () => _showLanguagePicker(context, ref, current),
-      child: Padding(
-        padding: const EdgeInsets.symmetric(vertical: KasySpacing.sm),
-        child: Row(
-          children: <Widget>[
-            Icon(KasyIcons.language, size: 21, color: context.colors.onSurface),
-            const SizedBox(width: KasySpacing.sm),
-            Expanded(
-              child: Text(
-                context.t.settings.language_title,
-                style: context.textTheme.titleMedium?.copyWith(
-                  color: context.colors.onSurface,
+    return KasyFocusRing(
+      onActivate: () => _showLanguagePicker(context, ref, current),
+      borderRadius: KasyRadius.smBorderRadius,
+      child: InkWell(
+        canRequestFocus: false,
+        onTap: () => _showLanguagePicker(context, ref, current),
+        child: Padding(
+          padding: const EdgeInsets.symmetric(vertical: KasySpacing.sm),
+          child: Row(
+            children: <Widget>[
+              Icon(
+                KasyIcons.language,
+                size: 21,
+                color: context.colors.onSurface,
+              ),
+              const SizedBox(width: KasySpacing.sm),
+              Expanded(
+                child: Text(
+                  context.t.settings.language_title,
+                  style: context.textTheme.titleMedium?.copyWith(
+                    color: context.colors.onSurface,
+                  ),
                 ),
               ),
-            ),
-            Text(
-              current.nativeName,
-              style: context.textTheme.bodyMedium?.copyWith(
-                color: context.colors.muted,
+              Text(
+                current.nativeName,
+                style: context.textTheme.bodyMedium?.copyWith(
+                  color: context.colors.muted,
+                ),
               ),
-            ),
-            const SizedBox(width: KasySpacing.xs),
-            const SettingsListChevron(),
-          ],
+              const SizedBox(width: KasySpacing.xs),
+              const SettingsListChevron(),
+            ],
+          ),
         ),
       ),
     );
@@ -147,36 +157,41 @@ class _LocaleOptionTile extends StatelessWidget {
     final Color primary = context.colors.primary;
     final Color fg = isSelected ? primary : context.colors.onSurface;
 
-    return InkWell(
-      onTap: onTap,
+    return KasyFocusRing(
+      onActivate: onTap,
       borderRadius: BorderRadius.circular(KasyRadius.sm),
-      child: Padding(
-        padding: const EdgeInsets.symmetric(
-          horizontal: KasySpacing.xs,
-          vertical: KasySpacing.smd,
-        ),
-        child: Row(
-          children: <Widget>[
-            Expanded(
-              child: Text(
-                locale.nativeName,
-                style: context.textTheme.bodyLarge?.copyWith(
-                  color: fg,
-                  fontWeight:
-                      isSelected ? FontWeight.w600 : FontWeight.w400,
+      child: InkWell(
+        canRequestFocus: false,
+        onTap: onTap,
+        borderRadius: BorderRadius.circular(KasyRadius.sm),
+        child: Padding(
+          padding: const EdgeInsets.symmetric(
+            horizontal: KasySpacing.xs,
+            vertical: KasySpacing.smd,
+          ),
+          child: Row(
+            children: <Widget>[
+              Expanded(
+                child: Text(
+                  locale.nativeName,
+                  style: context.textTheme.bodyLarge?.copyWith(
+                    color: fg,
+                    fontWeight:
+                        isSelected ? FontWeight.w600 : FontWeight.w400,
+                  ),
                 ),
               ),
-            ),
-            if (isSelected)
-              Container(
-                width: 10,
-                height: 10,
-                decoration: BoxDecoration(
-                  color: primary,
-                  shape: BoxShape.circle,
+              if (isSelected)
+                Container(
+                  width: 10,
+                  height: 10,
+                  decoration: BoxDecoration(
+                    color: primary,
+                    shape: BoxShape.circle,
+                  ),
                 ),
-              ),
-          ],
+            ],
+          ),
         ),
       ),
     );

package/templates/firebase/lib/features/settings/ui/widgets/settings_tile.dart

@@ -157,6 +157,8 @@ class SettingsTile extends StatelessWidget {
       onTap: onTap,
       hoverEnabled: false,
       pressEnabled: false,
+      focusable: true,
+      borderRadius: KasyRadius.smBorderRadius,
       semanticLabel: title,
       padding: const EdgeInsets.symmetric(vertical: KasySpacing.sm),
       child: Row(