kasy-cli 1.12.1 → 1.13.0

package/lib/utils/i18n.js

@@ -624,6 +624,32 @@ const MESSAGES = {
     // docs command
     'cli.command.docs.description': 'Open the full documentation',
 
+    // splash command
+    'cli.command.splash.description': 'Swap splash screen logos (light/dark) and regenerate native assets',
+    'splash.intro': 'Splash screen',
+    'splash.validating': 'Validating PNG files...',
+    'splash.validated': 'PNG files look good',
+    'splash.copying': 'Copying logos to assets/images/...',
+    'splash.copied': 'Logos copied',
+    'splash.generating': 'Regenerating native splash (Android, iOS, Web)...',
+    'splash.generated': 'Native splash regenerated',
+    'splash.done': 'Done. Run "flutter run" to see the new splash.',
+    'splash.warn.title': 'Warnings',
+    'splash.warn.noAlphaLight': '{path} has no alpha channel. The logo will show with a solid background instead of being transparent.',
+    'splash.warn.noAlphaDark': '{path} has no alpha channel. The logo will show with a solid background instead of being transparent.',
+    'splash.warn.smallLight': 'Light logo is {w}x{h}. Recommended is at least 768x768 to avoid blurry edges.',
+    'splash.warn.smallDark': 'Dark logo is {w}x{h}. Recommended is at least 768x768 to avoid blurry edges.',
+    'splash.summary.title': 'Saved',
+    'splash.summary.light': 'Light mode',
+    'splash.summary.dark': 'Dark mode',
+    'splash.skipGenerate.title': 'Skipped generation',
+    'splash.skipGenerate.hint': 'Run `dart run flutter_native_splash:create` when you are ready.',
+    'splash.error.notKasyProject': 'pubspec.yaml not found. Run this command from inside a Flutter/Kasy project.',
+    'splash.error.bothRequired': '--light and --dark are both required.',
+    'splash.error.fileNotFound': 'File not found: {path}',
+    'splash.error.notPng': 'One of the files is not a valid PNG.',
+    'splash.error.generateFailed': 'flutter_native_splash:create failed. Check the output above.',
+
     // notifications command
     'cli.command.notifications.description': 'Edit the text of local notifications and reminders',
     'cli.command.notifications.text.description': 'Set titles and bodies shown in local notifications',
@@ -1421,6 +1447,32 @@ const MESSAGES = {
     // docs command
     'cli.command.docs.description': 'Abre a documentação completa',
 
+    // splash command
+    'cli.command.splash.description': 'Troca os logos da splash (claro/escuro) e regenera os assets nativos',
+    'splash.intro': 'Splash screen',
+    'splash.validating': 'Validando arquivos PNG...',
+    'splash.validated': 'PNGs estão bons',
+    'splash.copying': 'Copiando logos para assets/images/...',
+    'splash.copied': 'Logos copiados',
+    'splash.generating': 'Regenerando splash nativa (Android, iOS, Web)...',
+    'splash.generated': 'Splash nativa regenerada',
+    'splash.done': 'Pronto. Rode "flutter run" para ver a nova splash.',
+    'splash.warn.title': 'Avisos',
+    'splash.warn.noAlphaLight': '{path} não tem canal alpha (fundo transparente). O logo vai aparecer com fundo sólido em vez de transparente.',
+    'splash.warn.noAlphaDark': '{path} não tem canal alpha (fundo transparente). O logo vai aparecer com fundo sólido em vez de transparente.',
+    'splash.warn.smallLight': 'Logo claro tem {w}x{h}. Recomendado pelo menos 768x768 para evitar bordas borradas.',
+    'splash.warn.smallDark': 'Logo escuro tem {w}x{h}. Recomendado pelo menos 768x768 para evitar bordas borradas.',
+    'splash.summary.title': 'Salvo',
+    'splash.summary.light': 'Modo claro',
+    'splash.summary.dark': 'Modo escuro',
+    'splash.skipGenerate.title': 'Geração pulada',
+    'splash.skipGenerate.hint': 'Rode `dart run flutter_native_splash:create` quando quiser regenerar.',
+    'splash.error.notKasyProject': 'pubspec.yaml não encontrado. Rode este comando dentro de um projeto Flutter/Kasy.',
+    'splash.error.bothRequired': '--light e --dark são obrigatórios.',
+    'splash.error.fileNotFound': 'Arquivo não encontrado: {path}',
+    'splash.error.notPng': 'Um dos arquivos não é um PNG válido.',
+    'splash.error.generateFailed': 'flutter_native_splash:create falhou. Veja a saída acima.',
+
     // notifications command
     'cli.command.notifications.description': 'Edita os textos das notificações locais e lembretes',
     'cli.command.notifications.text.description': 'Define títulos e mensagens das notificações locais',
@@ -2218,6 +2270,32 @@ const MESSAGES = {
     // docs command
     'cli.command.docs.description': 'Abre la documentación completa',
 
+    // splash command
+    'cli.command.splash.description': 'Cambia los logos del splash (claro/oscuro) y regenera los assets nativos',
+    'splash.intro': 'Splash screen',
+    'splash.validating': 'Validando archivos PNG...',
+    'splash.validated': 'Los PNGs están bien',
+    'splash.copying': 'Copiando logos a assets/images/...',
+    'splash.copied': 'Logos copiados',
+    'splash.generating': 'Regenerando splash nativo (Android, iOS, Web)...',
+    'splash.generated': 'Splash nativo regenerado',
+    'splash.done': 'Listo. Ejecuta "flutter run" para ver el nuevo splash.',
+    'splash.warn.title': 'Avisos',
+    'splash.warn.noAlphaLight': '{path} no tiene canal alpha (fondo transparente). El logo aparecerá con fondo sólido en vez de transparente.',
+    'splash.warn.noAlphaDark': '{path} no tiene canal alpha (fondo transparente). El logo aparecerá con fondo sólido en vez de transparente.',
+    'splash.warn.smallLight': 'El logo claro mide {w}x{h}. Lo recomendado es al menos 768x768 para evitar bordes borrosos.',
+    'splash.warn.smallDark': 'El logo oscuro mide {w}x{h}. Lo recomendado es al menos 768x768 para evitar bordes borrosos.',
+    'splash.summary.title': 'Guardado',
+    'splash.summary.light': 'Modo claro',
+    'splash.summary.dark': 'Modo oscuro',
+    'splash.skipGenerate.title': 'Generación omitida',
+    'splash.skipGenerate.hint': 'Ejecuta `dart run flutter_native_splash:create` cuando estés listo.',
+    'splash.error.notKasyProject': 'No se encontró pubspec.yaml. Ejecuta este comando dentro de un proyecto Flutter/Kasy.',
+    'splash.error.bothRequired': '--light y --dark son obligatorios.',
+    'splash.error.fileNotFound': 'Archivo no encontrado: {path}',
+    'splash.error.notPng': 'Uno de los archivos no es un PNG válido.',
+    'splash.error.generateFailed': 'flutter_native_splash:create falló. Revisa la salida.',
+
     // notifications command
     'cli.command.notifications.description': 'Edita los textos de las notificaciones locales y recordatorios',
     'cli.command.notifications.text.description': 'Define titulos y mensajes de notificaciones locales',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kasy-cli",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "CLI for scaffolding production-ready Flutter SaaS apps with Firebase, Supabase, or API REST backends.",
   "bin": {
     "kasy": "./bin/kasy.js"
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "scripts": {
-    "prepack": "node scripts/bundle-template.js",
+    "prepack": "node scripts/check-feature-patches.js && node scripts/bundle-template.js",
     "start": "node ./bin/kasy.js",
     "setup": "node ./bin/kasy.js setup",
     "doctor": "node ./bin/kasy.js doctor",

package/templates/firebase/android/app/src/main/res/drawable-night/launch_background.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+    <item>
+        <bitmap android:gravity="fill" android:src="@drawable/background"/>
+    </item>
+    <item>
+        <bitmap android:gravity="center" android:src="@drawable/splash"/>
+    </item>
+</layer-list>

package/templates/firebase/android/app/src/main/res/drawable-night-v21/launch_background.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+    <item>
+        <bitmap android:gravity="fill" android:src="@drawable/background"/>
+    </item>
+    <item>
+        <bitmap android:gravity="center" android:src="@drawable/splash"/>
+    </item>
+</layer-list>

package/templates/firebase/android/app/src/main/res/values-night-v31/styles.xml

@@ -6,7 +6,8 @@
         <item name="android:windowFullscreen">true</item>
         <item name="android:windowDrawsSystemBarBackgrounds">true</item>
         <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
-        <item name="android:windowSplashScreenBackground">#FFFFFF</item>
+        <item name="android:windowSplashScreenBackground">#000000</item>
+        <item name="android:windowSplashScreenAnimatedIcon">@drawable/android12splash</item>
     </style>
     <!-- Theme applied to the Android Window as soon as the process has started.
          This theme determines the color of the Android Window while your

package/templates/firebase/android/app/src/main/res/values-v31/styles.xml

@@ -7,6 +7,7 @@
         <item name="android:windowDrawsSystemBarBackgrounds">true</item>
         <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
         <item name="android:windowSplashScreenBackground">#FFFFFF</item>
+        <item name="android:windowSplashScreenAnimatedIcon">@drawable/android12splash</item>
     </style>
     <!-- Theme applied to the Android Window as soon as the process has started.
          This theme determines the color of the Android Window while your

package/templates/firebase/ios/Runner/Assets.xcassets/LaunchBackground.imageset/Contents.json

@@ -2,16 +2,17 @@
   "images" : [
     {
       "filename" : "background.png",
-      "idiom" : "universal",
-      "scale" : "1x"
+      "idiom" : "universal"
     },
     {
-      "idiom" : "universal",
-      "scale" : "2x"
-    },
-    {
-      "idiom" : "universal",
-      "scale" : "3x"
+      "appearances" : [
+        {
+          "appearance" : "luminosity",
+          "value" : "dark"
+        }
+      ],
+      "filename" : "darkbackground.png",
+      "idiom" : "universal"
     }
   ],
   "info" : {

package/templates/firebase/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json

@@ -5,15 +5,48 @@
       "idiom" : "universal",
       "scale" : "1x"
     },
+    {
+      "appearances" : [
+        {
+          "appearance" : "luminosity",
+          "value" : "dark"
+        }
+      ],
+      "filename" : "LaunchImageDark.png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
     {
       "filename" : "LaunchImage@2x.png",
       "idiom" : "universal",
       "scale" : "2x"
     },
+    {
+      "appearances" : [
+        {
+          "appearance" : "luminosity",
+          "value" : "dark"
+        }
+      ],
+      "filename" : "LaunchImageDark@2x.png",
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
     {
       "filename" : "LaunchImage@3x.png",
       "idiom" : "universal",
       "scale" : "3x"
+    },
+    {
+      "appearances" : [
+        {
+          "appearance" : "luminosity",
+          "value" : "dark"
+        }
+      ],
+      "filename" : "LaunchImageDark@3x.png",
+      "idiom" : "universal",
+      "scale" : "3x"
     }
   ],
   "info" : {

package/templates/firebase/ios/Runner/Base.lproj/LaunchScreen.storyboard

@@ -38,7 +38,7 @@
         </scene>
     </scenes>
     <resources>
-        <image name="LaunchImage" width="2732" height="2732"/>
+        <image name="LaunchImage" width="512" height="512"/>
         <image name="LaunchBackground" width="1" height="1"/>
     </resources>
 </document>

package/templates/firebase/lib/core/theme/providers/theme_provider.dart

@@ -17,13 +17,8 @@ class ThemeProvider extends InheritedNotifier<AppTheme> {
 
   @override
   bool updateShouldNotify(covariant InheritedNotifier<AppTheme> oldWidget) {
-    final isModeChanged = oldWidget.notifier!.mode != notifier!.mode;
-    if (isModeChanged) {
-      // keeep the same theme when switching between light and dark mode while hot reloading
-      notifier!.mode = oldWidget.notifier!.mode;
-      notifier!.setSystemBarColor();
-    }
-    return false;
+    return oldWidget.notifier != notifier ||
+        oldWidget.notifier?.mode != notifier?.mode;
   }
 
   static AppTheme of(BuildContext context) =>
@@ -37,7 +32,7 @@ class ThemeProvider extends InheritedNotifier<AppTheme> {
 ///
 /// Defining a theme for light and dark should only change the colors
 /// not redefining everything. (see ./docs/theme.md)
-class AppTheme with ChangeNotifier {
+class AppTheme with ChangeNotifier, WidgetsBindingObserver {
   final KasyTheme? lightTheme;
   final KasyTheme? darkTheme;
   final SharedPreferences sharedPreferences;
@@ -50,6 +45,7 @@ class AppTheme with ChangeNotifier {
     this.darkTheme,
   }) {
     mode = _loadFromPrefs();
+    WidgetsBinding.instance.addObserver(this);
     setSystemBarColor();
   }
 
@@ -135,25 +131,55 @@ class AppTheme with ChangeNotifier {
     );
   }
 
-  /// automatically toggle between light and dark mode
-  /// call this using AppTheme.of(context).toggle()
-  void toggle() {
-    mode = mode == ThemeMode.light ? ThemeMode.dark : ThemeMode.light;
+  @override
+  void didChangePlatformBrightness() {
+    super.didChangePlatformBrightness();
+    if (mode == ThemeMode.system) {
+      setSystemBarColor();
+      notifyListeners();
+    }
+  }
+
+  @override
+  void dispose() {
+    WidgetsBinding.instance.removeObserver(this);
+    super.dispose();
+  }
+
+  /// Resolves [mode] to either light or dark by reading the system brightness
+  /// when [mode] is [ThemeMode.system].
+  ThemeMode get effectiveMode {
+    if (mode != ThemeMode.system) return mode;
+    final brightness =
+        WidgetsBinding.instance.platformDispatcher.platformBrightness;
+    return brightness == Brightness.dark ? ThemeMode.dark : ThemeMode.light;
+  }
+
+  /// Set the theme mode and persist the preference.
+  void setMode(ThemeMode newMode) {
+    if (mode == newMode) return;
+    mode = newMode;
     _saveInPrefs(mode);
-    notifyListeners();
     setSystemBarColor();
+    notifyListeners();
+  }
+
+  /// Toggle between light and dark based on the effective (visible) mode.
+  /// If the user is in system mode, this picks the opposite of the
+  /// currently displayed brightness and switches out of system mode.
+  void toggle() {
+    final next =
+        effectiveMode == ThemeMode.light ? ThemeMode.dark : ThemeMode.light;
+    setMode(next);
   }
 
   void setSystemBarColor() {
+    final isLight = effectiveMode == ThemeMode.light;
     SystemChrome.setSystemUIOverlayStyle(
       SystemUiOverlayStyle(
         statusBarColor: Colors.transparent,
-        statusBarBrightness:
-            mode == ThemeMode.light ? Brightness.light : Brightness.dark,
-        statusBarIconBrightness:
-            mode == ThemeMode.light ? Brightness.dark : Brightness.light,
-        // statusBarColor: Colors.black, // color for android
-        // statusBarBrightness: Brightness.light, // for ios Dark = white status
+        statusBarBrightness: isLight ? Brightness.light : Brightness.dark,
+        statusBarIconBrightness: isLight ? Brightness.dark : Brightness.light,
       ),
     );
   }
@@ -189,11 +215,7 @@ class AppTheme with ChangeNotifier {
   ThemeData get darkThemeData => darkTheme!.data.materialTheme;
 
   KasyTheme get current {
-    if (mode == ThemeMode.light) {
-      return lightTheme!;
-    } else {
-      return darkTheme!;
-    }
+    return effectiveMode == ThemeMode.dark ? darkTheme! : lightTheme!;
   }
 
   ThemeMode _loadFromPrefs() {
@@ -202,6 +224,8 @@ class AppTheme with ChangeNotifier {
       return ThemeMode.dark;
     } else if (themeMode == ThemeMode.light.name) {
       return ThemeMode.light;
+    } else if (themeMode == ThemeMode.system.name) {
+      return ThemeMode.system;
     }
     return mode;
   }

package/templates/firebase/lib/features/onboarding/ui/components/onboarding_features.dart

@@ -5,11 +5,13 @@ import 'package:kasy_kit/i18n/translations.g.dart';
 class OnboardingFeatureOne extends StatelessWidget {
   final String nextRoute;
   final VoidCallback? onSkip;
+  final VoidCallback? onLogin;
 
   const OnboardingFeatureOne({
     super.key,
     required this.nextRoute,
     this.onSkip,
+    this.onLogin,
   });
 
   @override
@@ -25,6 +27,8 @@ class OnboardingFeatureOne extends StatelessWidget {
       progress: 0.1,
       onSkip: onSkip,
       skipLabel: translations.skip,
+      onSecondary: onLogin,
+      secondaryLabel: onLogin != null ? translations.login : null,
     );
   }
 }

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

@@ -33,6 +33,7 @@ class OnboardingPage extends ConsumerWidget {
               onSkip: () => Navigator.of(context).pushReplacementNamed(
                 'skip_loader',
               ),
+              onLogin: () => ref.read(goRouterProvider).go('/signin'),
             ),
             settings: settings,
           ),

package/templates/firebase/lib/features/onboarding/ui/widgets/onboarding_feature.dart

@@ -20,6 +20,8 @@ class OnboardingStep extends StatelessWidget {
   final bool withBg;
   final VoidCallback? onSkip;
   final String? skipLabel;
+  final VoidCallback? onSecondary;
+  final String? secondaryLabel;
 
   const OnboardingStep({
     super.key,
@@ -35,6 +37,8 @@ class OnboardingStep extends StatelessWidget {
     this.image,
     this.onSkip,
     this.skipLabel,
+    this.onSecondary,
+    this.secondaryLabel,
   });
 
   @override
@@ -128,6 +132,15 @@ class OnboardingStep extends StatelessWidget {
             }
           },
         ),
+        if (onSecondary != null && secondaryLabel != null) ...[
+          const SizedBox(height: KasySpacing.xs),
+          KasyButton(
+            label: secondaryLabel!,
+            variant: KasyButtonVariant.link,
+            expand: true,
+            onPressed: onSecondary,
+          ),
+        ],
       ],
     );