kasy-cli 1.9.2 → 1.12.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kasy-cli",
-  "version": "1.9.2",
+  "version": "1.12.1",
   "description": "CLI for scaffolding production-ready Flutter SaaS apps with Firebase, Supabase, or API REST backends.",
   "bin": {
     "kasy": "./bin/kasy.js"
@@ -41,7 +41,8 @@
     "check:firebase": "node ./scripts/check-firebase-template.js",
     "test:google-ios": "node ./test/google-ios-url-scheme.test.js",
     "test:apple-release": "node ./test/apple-release.test.js",
-    "test:localize-docs": "node ./test/localize-release-docs.test.js"
+    "test:localize-docs": "node ./test/localize-release-docs.test.js",
+    "test:i18n-accents": "node ./test/i18n-accents.test.js"
   },
   "dependencies": {
     "@clack/prompts": "^1.4.0",

package/templates/firebase/lib/core/home_widgets/home_widget_mywidget_service.dart

@@ -17,7 +17,35 @@ class MyWidgetHomeWidget extends _$MyWidgetHomeWidget
   static const String _iosWidgetName = 'MyWidgetWidget';
 
   @override
-  void build() {}
+  void build() {
+    // Auto-refresh the widget whenever user state changes in a way that
+    // affects what it renders (login/logout, name, premium status). Without
+    // this, the widget would only update via the 15-min background task or
+    // a manual trigger — a fresh subscription would not reflect on the home
+    // screen until the next background tick.
+    ref.listen(userStateNotifierProvider, (previous, next) {
+      if (previous == null) return;
+      if (_widgetSignature(previous.user) != _widgetSignature(next.user)) {
+        update();
+      }
+    });
+  }
+
+  /// Snapshot of the user fields the widget reads. Used to skip the update
+  /// when an unrelated field changes (e.g. lastUpdateDate refresh).
+  (String?, String?, bool) _widgetSignature(User user) {
+    final isPro = switch (user) {
+      AuthenticatedUserData(:final subscription) ||
+      AnonymousUserData(:final subscription) =>
+        subscription?.isActive ?? false,
+      _ => false,
+    };
+    final name = switch (user) {
+      AuthenticatedUserData(:final name) => name,
+      _ => null,
+    };
+    return (user.idOrNull, name, isPro);
+  }
 
   @override
   Future<void> update() async {

package/templates/firebase/lib/core/home_widgets/home_widget_service.dart

@@ -3,11 +3,19 @@ import 'package:flutter/foundation.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:home_widget/home_widget.dart';
 import 'package:kasy_kit/core/home_widgets/home_widget_background_task.dart';
+import 'package:kasy_kit/core/home_widgets/home_widget_mywidget_service.dart';
 import 'package:kasy_kit/core/initializer/onstart_service.dart';
 import 'package:logger/logger.dart';
 
 final homeWidgetsManagerProvider = Provider<HomeWidgetsManager>(
-  (ref) => HomeWidgetsManager(),
+  (ref) {
+    // Force-build the widget service at app startup so its user-state
+    // listener attaches and the widget auto-refreshes when subscription
+    // status or other relevant fields change. Without this read, the
+    // listener would only attach on first manual update.
+    ref.read(myWidgetHomeWidgetProvider.notifier);
+    return HomeWidgetsManager();
+  },
 );
 
 const String appGroupId = 'group.com.aicrus.firebase.kit';

package/templates/firebase/lib/core/initializer/onstart_widget.dart

@@ -64,7 +64,13 @@ class _InitializerState extends ConsumerState<Initializer> {
         Sentry.captureException(e, stackTrace: s);
         ref.read(onStartProvider.notifier).notifyError(e.toString());
       } finally {
-        FlutterNativeSplash.remove();
+        // Defer splash removal until after the next frame is painted so the
+        // onReady widget renders under the splash before it disappears.
+        // Without this, the splash is removed before the new frame paints,
+        // briefly revealing the onLoading widget (visible flash).
+        WidgetsBinding.instance.addPostFrameCallback((_) {
+          FlutterNativeSplash.remove();
+        });
       }
     });
   }

package/lib/scaffold/features/widget/lib/core/home_widgets/home_widget_background_task.dart

@@ -1,41 +0,0 @@
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:logger/logger.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/states/user_state_notifier.dart';
-import 'package:kasy_kit/features/authentication/api/authentication_api.dart';
-import 'package:kasy_kit/features/subscription/repositories/subscription_repository.dart';
-
-/// Generated by Kasy CLI
-/// ----
-/// Background task callback for workmanager
-/// This allows updating home widgets even when the app is in the background
-@pragma('vm:entry-point')
-Future<void> homeWidgetCallbackDispatcher() async {
-  try {
-    Logger().i('🔄 Home Widget background task triggered');
-    final globalContainer = ProviderContainer();
-    final sharedPreferences = globalContainer.read(sharedPreferencesProvider);
-    await sharedPreferences.init();
-    await globalContainer.read(authenticationApiProvider).init();
-    await globalContainer.read(subscriptionRepositoryProvider).init();
-    await globalContainer.read(userStateNotifierProvider.notifier).init();
-
-    /// If you want to restric the background task to only run when the user is subscribed,
-    /// you can use the subscription variable here.
-    // final subscription = globalContainer
-    //     .read(userStateNotifierProvider)
-    //     .subscription;
-
-    final myWidgetWidget = globalContainer.read(
-      myWidgetHomeWidgetProvider.notifier,
-    );
-    await myWidgetWidget.update();
-
-    globalContainer.dispose();
-    return;
-  } catch (e) {
-    Logger().e('Error in background task: $e');
-    return;
-  }
-}

package/lib/scaffold/features/widget/lib/core/home_widgets/home_widget_mywidget_service.dart

@@ -1,98 +0,0 @@
-import 'dart:io';
-
-import 'package:home_widget/home_widget.dart';
-import 'package:kasy_kit/core/data/models/user.dart';
-import 'package:kasy_kit/core/home_widgets/home_widget_service.dart';
-import 'package:kasy_kit/core/states/user_state_notifier.dart';
-import 'package:logger/logger.dart';
-import 'package:riverpod_annotation/riverpod_annotation.dart';
-
-part 'home_widget_mywidget_service.g.dart';
-
-@Riverpod(keepAlive: true)
-class MyWidgetHomeWidget extends _$MyWidgetHomeWidget
-    implements UpdatableHomeWidget {
-  static const String _androidWidgetName = 'MyWidgetReceiver';
-  static const String _iosWidgetName = 'MyWidgetWidget';
-
-  @override
-  void build() {}
-
-  @override
-  Future<void> update() {
-    Logger().i('🔄 Updating MyWidget Home Widget');
-    final user = ref.read(userStateNotifierProvider).user;
-
-    final name = switch (user) {
-      AuthenticatedUserData(:final name)
-          when name != null && name.isNotEmpty =>
-        name.split(' ').first,
-      _ => 'there',
-    };
-
-    final isPro = switch (user) {
-      AuthenticatedUserData(:final subscription) ||
-      AnonymousUserData(:final subscription) =>
-        subscription?.isActive ?? false,
-      _ => false,
-    };
-
-    return updateWidget({
-      'greeting': _greeting(),
-      'name': name,
-      'isPro': isPro.toString(),
-    });
-  }
-
-  Future<void> updateWidget(Map<String, String> data) async {
-    await HomeWidget.saveWidgetData<String>(
-        'greeting', data['greeting'] ?? 'Good morning');
-    await HomeWidget.saveWidgetData<String>('name', data['name'] ?? 'there');
-    await HomeWidget.saveWidgetData<String>(
-        'isPro', data['isPro'] ?? 'false');
-
-    await HomeWidget.updateWidget(
-      name: _androidWidgetName,
-      iOSName: _iosWidgetName,
-    );
-  }
-
-  Future<Map<String, dynamic>> getWidgetData() async {
-    return {
-      'greeting': await HomeWidget.getWidgetData<String>(
-        'greeting',
-        defaultValue: 'Good morning',
-      ),
-      'name': await HomeWidget.getWidgetData<String>(
-        'name',
-        defaultValue: 'there',
-      ),
-      'isPro': await HomeWidget.getWidgetData<String>(
-        'isPro',
-        defaultValue: 'false',
-      ),
-    };
-  }
-
-  // Returns a time-of-day greeting in the device language (pt / es / en).
-  // Uses Platform.localeName so it works in background isolates without
-  // requiring the Flutter locale system to be initialized.
-  static String _greeting() {
-    final lang = Platform.localeName.split(RegExp(r'[_\-]')).first.toLowerCase();
-    final hour = DateTime.now().hour;
-
-    return switch (lang) {
-      'pt' => hour < 12 ? 'Bom dia' : hour < 18 ? 'Boa tarde' : 'Boa noite',
-      'es' => hour < 12
-          ? 'Buenos días'
-          : hour < 18
-              ? 'Buenas tardes'
-              : 'Buenas noches',
-      _ => hour < 12
-          ? 'Good morning'
-          : hour < 18
-              ? 'Good afternoon'
-              : 'Good evening',
-    };
-  }
-}

package/lib/scaffold/features/widget/lib/core/home_widgets/home_widget_service.dart

@@ -1,54 +0,0 @@
-import 'package:background_fetch/background_fetch.dart';
-import 'package:flutter/foundation.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:home_widget/home_widget.dart';
-import 'package:logger/logger.dart';
-import 'package:kasy_kit/core/home_widgets/home_widget_background_task.dart';
-import 'package:kasy_kit/core/initializer/onstart_service.dart';
-
-final homeWidgetsManagerProvider = Provider<HomeWidgetsManager>(
-  (ref) => HomeWidgetsManager(),
-);
-
-const String appGroupId = 'group.com.appfirebase.app';
-
-/// Manager for all home widgets
-/// -> Don't modify this file
-/// ------------------------------------------------------------
-/// will be used to initialize the home widgets and set the app group id
-/// Register the background task for the home widgets
-class HomeWidgetsManager implements OnStartService {
-  @override
-  Future<void> init() async {
-    if (kIsWeb) return;
-    try {
-      await HomeWidget.setAppGroupId(appGroupId);
-
-      final status = await BackgroundFetch.configure(
-        BackgroundFetchConfig(
-          minimumFetchInterval: 15,
-          stopOnTerminate: false,
-          enableHeadless: true,
-          requiresBatteryNotLow: false,
-          requiresCharging: false,
-          requiresStorageNotLow: false,
-          requiresDeviceIdle: false,
-          requiredNetworkType: NetworkType.ANY,
-        ),
-        (String taskId) async {
-          final res = await homeWidgetCallbackDispatcher();
-          BackgroundFetch.finish(taskId);
-          return res;
-        },
-      );
-      Logger().i('🔄 - Home widgets manager initialized with status: $status');
-      await BackgroundFetch.start();
-    } catch (e, s) {
-      Logger().e('⚠️  Could not initialize home widgets: $e $s');
-    }
-  }
-}
-
-abstract class UpdatableHomeWidget {
-  Future<void> update();
-}

package/lib/scaffold/features/widget/lib/features/settings/ui/components/admin/admin_home_widgets.dart

@@ -1,32 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:flutter_riverpod/flutter_riverpod.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/i18n/translations.g.dart';
-import 'package:kasy_kit/features/settings/ui/widgets/admin_card.dart';
-
-class AdminHomeWidgets extends ConsumerWidget {
-  const AdminHomeWidgets({super.key});
-
-  @override
-  Widget build(BuildContext context, WidgetRef ref) {
-    return Scaffold(
-      appBar: AppBar(title: Text(t.settings.admin.home_widgets_title)),
-      body: Padding(
-        padding: const EdgeInsets.all(KasySpacing.lg),
-        child: Column(
-          crossAxisAlignment: CrossAxisAlignment.stretch,
-          children: [
-            AdminPanelCard(
-              title: t.settings.admin.update_mywidget_title,
-              description: t.settings.admin.update_mywidget_desc,
-              onTap: () =>
-                  ref.watch(myWidgetHomeWidgetProvider.notifier).update(),
-            ),
-            const SizedBox(height: KasySpacing.md),
-          ],
-        ),
-      ),
-    );
-  }
-}