kasy-cli 1.2.1

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

@@ -0,0 +1,22 @@
+import 'package:bart/bart/bart_bottombar_actions.dart';
+import 'package:flutter/material.dart';
+
+/// Restores the Bart bottom bar after leaving a home inner route.
+void kasyShowBottomBar(BuildContext context) {
+  WidgetsBinding.instance.addPostFrameCallback((_) {
+    if (!context.mounted) {
+      return;
+    }
+    Actions.invoke(context, BottomBarIntent.show());
+  });
+}
+
+/// Hides the Bart bottom bar for home inner routes, including web reloads.
+void kasyHideBottomBar(BuildContext context) {
+  WidgetsBinding.instance.addPostFrameCallback((_) {
+    if (!context.mounted) {
+      return;
+    }
+    Actions.invoke(context, BottomBarIntent.hide());
+  });
+}

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

@@ -0,0 +1,127 @@
+import 'package:bart/bart.dart' as bart;
+import 'package:bart/bart/bart_model.dart';
+import 'package:bart/bart/router_delegate.dart';
+import 'package:bart/bart/widgets/bottom_bar/styles/bottom_bar_cupertino.dart';
+import 'package:bart/bart/widgets/bottom_bar/styles/bottom_bar_custom.dart';
+import 'package:bart/bart/widgets/bottom_bar/styles/bottom_bar_material.dart';
+import 'package:flutter/foundation.dart';
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/haptics/kasy_haptics.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+
+/// Breathing room under the top hairline so icons/labels are not glued to it.
+const double kasyBottomBarTopPadding = 6;
+
+const double _kBottomBarHeightMaterial3 = 88;
+const double _kBottomBarHeightCupertino = 56;
+
+/// [BartScaffold] requires a [bart.BartBottomBar]. This factory draws the same
+/// Material / Cupertino bars as [bart.BartBottomBar.adaptive], with extra top
+/// inset inside the chrome (not only a taller bar).
+final class KasyPaddedSurfaceBottomBarFactory extends BartBottomBarFactory {
+  const KasyPaddedSurfaceBottomBarFactory();
+
+  bool _useCupertino(BuildContext context) {
+    if (kIsWeb) {
+      return false;
+    }
+    return switch (defaultTargetPlatform) {
+      TargetPlatform.iOS => true,
+      _ => false,
+    };
+  }
+
+  @override
+  Widget create({
+    required BuildContext context,
+    required List<BartMenuRoute> routes,
+    required void Function(int) onTap,
+    required int currentIndex,
+  }) {
+    final KasyColors colors = context.colors;
+    final MenuRouter menuRouter = MenuRouter.of(context);
+    final BorderSide topEdge = BorderSide(
+      color: colors.outline.withValues(alpha: 0.35),
+    );
+    void handleTap(int index) {
+      if (menuRouter.indexNotifier.value == index &&
+          menuRouter.routingTypeNotifier.value ==
+              BartMenuRouteType.bottomNavigation) {
+        return;
+      }
+      KasyHaptics.selection(context);
+      final nestedContext = menuRouter.navigationKey.currentContext;
+      if (nestedContext != null) {
+        Navigator.of(nestedContext)
+            .pushReplacementNamed(menuRouter.routesBuilder()[index].path);
+      }
+    }
+
+    if (_useCupertino(context)) {
+      return Column(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          DecoratedBox(
+            decoration: BoxDecoration(
+              color: colors.surface,
+              border: Border(top: topEdge),
+            ),
+            child: const SizedBox(
+              height: kasyBottomBarTopPadding,
+              width: double.infinity,
+            ),
+          ),
+          BartCupertinoBottomBar(
+            routes: routes,
+            theme: CupertinoBottomBarTheme(
+              bgColor: colors.surface,
+              height: _kBottomBarHeightCupertino - kasyBottomBarTopPadding,
+            ),
+            currentIndexNotifier: menuRouter.indexNotifier,
+            onTap: handleTap,
+          ),
+        ],
+      );
+    }
+    return Material(
+      color: colors.surface,
+      elevation: 2,
+      shadowColor: Colors.black.withValues(alpha: 0.12),
+      child: Column(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          const SizedBox(
+            height: kasyBottomBarTopPadding,
+            width: double.infinity,
+          ),
+          Theme(
+            data: Theme.of(context).copyWith(
+              navigationBarTheme: NavigationBarTheme.of(context).copyWith(
+                backgroundColor: Colors.transparent,
+                elevation: 0,
+                shadowColor: Colors.transparent,
+                surfaceTintColor: Colors.transparent,
+              ),
+            ),
+            child: BartMaterial3BottomBar(
+              routes: menuRouter.routesBuilder(),
+              theme: Material3BottomBarTheme(
+                bgColor: Colors.transparent,
+                elevation: 0,
+                height: _kBottomBarHeightMaterial3 - kasyBottomBarTopPadding,
+              ),
+              currentIndexNotifier: menuRouter.indexNotifier,
+              onTap: handleTap,
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}
+
+bart.BartBottomBar kasyPaddedSurfaceBottomBar() {
+  return bart.BartBottomBar.custom(
+    bottomBarFactory: const KasyPaddedSurfaceBottomBarFactory(),
+  );
+}

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

@@ -0,0 +1,48 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/core/states/user_state_notifier.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/features/notifications/repositories/notifications_repository.dart';
+
+class BottomItemNotification extends ConsumerStatefulWidget {
+  const BottomItemNotification({super.key});
+
+  @override
+  ConsumerState<ConsumerStatefulWidget> createState() =>
+      _BottomItemNotificationState();
+}
+
+class _BottomItemNotificationState
+    extends ConsumerState<BottomItemNotification> {
+  Stream<int>? _count$;
+
+  @override
+  Widget build(BuildContext context) {
+    final String? userId =
+        ref.watch(userStateNotifierProvider).user.idOrNull;
+    const icon = Icon(KasyIcons.notification);
+
+    if (userId == null) {
+      return icon;
+    }
+
+    _count$ ??= ref
+        .read(notificationRepositoryProvider)
+        .listenToUnreadNotificationsCount(userId);
+
+    return StreamBuilder<int>(
+      key: const ValueKey('notification-count'),
+      stream: _count$,
+      builder: (context, snapshot) {
+        final count = snapshot.data ?? 0;
+        if (count == 0) return icon;
+        return Badge(
+          backgroundColor: context.colors.error,
+          textColor: context.colors.onPrimary,
+          label: Text(count > 99 ? '99+' : '$count'),
+          child: icon,
+        );
+      },
+    );
+  }
+}

package/templates/firebase/lib/core/config/app_env.dart

@@ -0,0 +1,100 @@
+import 'package:flutter_dotenv/flutter_dotenv.dart';
+
+const String _kEnvFromDefine = String.fromEnvironment(
+  'ENV',
+  defaultValue: 'dev',
+);
+const String _kBackendUrlFromDefine = String.fromEnvironment(
+  'BACKEND_URL',
+);
+const String _kSupabaseTokenFromDefine = String.fromEnvironment(
+  'SUPABASE_TOKEN',
+);
+const String _kRcAndroidApiKeyFromDefine = String.fromEnvironment(
+  'RC_ANDROID_API_KEY',
+);
+const String _kRcIosApiKeyFromDefine = String.fromEnvironment(
+  'RC_IOS_API_KEY',
+);
+const String _kRcWebApiKeyFromDefine = String.fromEnvironment(
+  'RC_WEB_API_KEY',
+);
+const String _kMixpanelTokenFromDefine = String.fromEnvironment(
+  'MIXPANEL_TOKEN',
+);
+const String _kSentryDsnFromDefine = String.fromEnvironment(
+  'SENTRY_DSN',
+);
+const String _kAppStoreIdFromDefine = String.fromEnvironment(
+  'APP_STORE_ID',
+);
+const String _kLlmChatEndpointFromDefine = String.fromEnvironment(
+  'LLM_CHAT_ENDPOINT',
+);
+
+// ignore: avoid_classes_with_only_static_members
+class AppEnv {
+  static bool _isLoaded = false;
+
+  static Future<void> load() async {
+    if (_isLoaded) return;
+    try {
+      await dotenv.load();
+    } catch (_) {
+      // `.env` is optional: fallback to --dart-define works in all commands.
+    }
+    _isLoaded = true;
+  }
+
+  static String get env => _resolve(
+    key: 'ENV',
+    dartDefineValue: _kEnvFromDefine,
+    defaultValue: 'dev',
+  );
+
+  static String get backendUrl =>
+      _resolve(key: 'BACKEND_URL', dartDefineValue: _kBackendUrlFromDefine);
+
+  static String get supabaseToken => _resolve(
+    key: 'SUPABASE_TOKEN',
+    dartDefineValue: _kSupabaseTokenFromDefine,
+  );
+
+  static String get rcAndroidApiKey => _resolve(
+    key: 'RC_ANDROID_API_KEY',
+    dartDefineValue: _kRcAndroidApiKeyFromDefine,
+  );
+
+  static String get rcIosApiKey =>
+      _resolve(key: 'RC_IOS_API_KEY', dartDefineValue: _kRcIosApiKeyFromDefine);
+
+  static String get rcWebApiKey =>
+      _resolve(key: 'RC_WEB_API_KEY', dartDefineValue: _kRcWebApiKeyFromDefine);
+
+  static String get mixpanelToken => _resolve(
+    key: 'MIXPANEL_TOKEN',
+    dartDefineValue: _kMixpanelTokenFromDefine,
+  );
+
+  static String get sentryDsn =>
+      _resolve(key: 'SENTRY_DSN', dartDefineValue: _kSentryDsnFromDefine);
+
+  static String get appStoreId =>
+      _resolve(key: 'APP_STORE_ID', dartDefineValue: _kAppStoreIdFromDefine);
+
+  static String get llmChatEndpoint => _resolve(
+    key: 'LLM_CHAT_ENDPOINT',
+    dartDefineValue: _kLlmChatEndpointFromDefine,
+  );
+
+  static String _resolve({
+    required String key,
+    required String dartDefineValue,
+    String defaultValue = '',
+  }) {
+    final String? fromDotEnv = dotenv.isInitialized ? dotenv.env[key] : null;
+    if (fromDotEnv != null && fromDotEnv.isNotEmpty) return fromDotEnv;
+    if (dartDefineValue.isNotEmpty) return dartDefineValue;
+    return defaultValue;
+  }
+}

package/templates/firebase/lib/core/config/features.dart

@@ -0,0 +1,15 @@
+/// Feature flags — generated by Kasy CLI based on user choices.
+/// When false, the router skips that feature's routes and the guard ignores it.
+// ignore_for_file: avoid_redundant_argument_values
+const bool withOnboarding = true;
+const bool withLlmChat    = true;
+const bool withFeedback            = true;
+const bool withRevenuecat          = true;
+const bool withLocalNotifications  = true;
+/// When true, the app includes web support:
+///   - anonymous sign-up is disabled on web (user is redirected to /signin)
+///   - onboarding is skipped on web
+///   - home widgets and background fetch are no-ops on web
+const bool withWeb = true;
+/// When true, RevenueCat Web Billing is enabled for subscriptions on web.
+const bool revenuecatWeb = true;

package/templates/firebase/lib/core/data/api/analytics_api.dart

@@ -0,0 +1,124 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/core/data/models/user.dart';
+import 'package:kasy_kit/core/initializer/onstart_service.dart';
+import 'package:kasy_kit/environnements.dart';
+import 'package:mixpanel_flutter/mixpanel_flutter.dart';
+
+final analyticsApiProvider = Provider<AnalyticsApi>(
+  (ref) => MixpanelAnalyticsApi.instance(),
+  
+);
+
+abstract class AnalyticsApi implements OnStartService {
+  /// Log an event to your analytics platform
+  Future<void> logEvent(String name, Map<String, dynamic> params);
+
+  /// Log a signout event to your analytics platform
+  Future<void> logSignout();
+
+  /// Identify a user to your analytics platform
+  Future<void> identify(User user);
+}
+
+
+class MixpanelAnalyticsApi implements AnalyticsApi {
+  final Environment environment;
+  Mixpanel? mixpanel;
+  MixpanelAnalyticsApi._({
+    required this.environment,
+  });
+
+  static MixpanelAnalyticsApi? _instance;
+
+  factory MixpanelAnalyticsApi.instance() {
+    return _instance ??= MixpanelAnalyticsApi._(
+      environment: Environment.fromEnv(),
+    );
+  }
+
+  @override
+  Future<void> init() async {
+    if (environment.mixpanelToken == null ||
+        environment.mixpanelToken!.isEmpty) {
+      return;
+    }
+    try {
+      mixpanel = await Mixpanel.init(
+        environment.mixpanelToken!,
+        trackAutomaticEvents: true,
+      );
+    } catch (e, s) {
+      debugPrint('Error initializing Mixpanel: $e\n$s');
+    }
+  }
+
+  @override
+  Future<void> logEvent(String name, Map<String, dynamic> params) async {
+    mixpanel?.track(name, properties: params);
+  }
+
+  @override
+  Future<void> logSignout() async {
+    mixpanel?.reset();
+    mixpanel?.track('logout');
+  }
+
+  @override
+  Future<void> identify(User user) async {
+    mixpanel?.track('login');
+    final userId = user.idOrNull;
+    if (userId != null) {
+      mixpanel?.identify(userId);
+    }
+  }
+}
+
+
+
+
+class AnalyticsObserver extends RouteObserver<ModalRoute<dynamic>> {
+  final AnalyticsApi analyticsApi;
+  final String? prefix;
+
+  AnalyticsObserver({
+    required this.analyticsApi,
+    this.prefix,
+  });
+
+  @override
+  void didPush(Route<dynamic> route, Route<dynamic>? previousRoute) {
+    // debugPrint('didPush $prefix${route.settings.name} ');
+    if (route.settings.name != null && prefix != null) {
+      analyticsApi.logEvent('$prefix${route.settings.name}', {});
+    } else if (route.settings.name != null && prefix == null) {
+      analyticsApi.logEvent('${route.settings.name}', {});
+    }
+  }
+
+  @override
+  void didReplace({Route<dynamic>? newRoute, Route<dynamic>? oldRoute}) {
+    // debugPrint('didReplace ${newRoute?.settings.name}');
+    if (newRoute?.settings.name != null && prefix != null) {
+      analyticsApi.logEvent('$prefix${newRoute!.settings.name!}', {});
+    } else if (newRoute?.settings.name != null && prefix == null) {
+      analyticsApi.logEvent(newRoute!.settings.name!, {});
+    }
+  }
+
+  @override
+  void didPop(Route<dynamic> route, Route<dynamic>? previousRoute) {}
+
+  @override
+  void didRemove(Route<dynamic> route, Route<dynamic>? previousRoute) {}
+
+  @override
+  void didStartUserGesture(
+    Route<dynamic> route,
+    Route<dynamic>? previousRoute,
+  ) {}
+
+  @override
+  void didStopUserGesture() {}
+}
+

package/templates/firebase/lib/core/data/api/base_api_exceptions.dart

@@ -0,0 +1,28 @@
+import 'package:dio/dio.dart';
+
+/// Your backend should return a json with the following structure:
+/// {
+///  "code": "string",
+///  "message": "string"
+/// }
+class ApiError implements Exception {
+  final int? code;
+  final String? message;
+
+  ApiError({
+    this.code,
+    this.message,
+  });
+
+  factory ApiError.fromDioException(DioException e) {
+    return ApiError(
+      code: e.response?.statusCode ?? 0,
+      message: e.message,
+    );
+  }
+
+  @override
+  String toString() {
+    return 'ApiError(code: $code, message: $message)';
+  }
+}

package/templates/firebase/lib/core/data/api/firestore_retry.dart

@@ -0,0 +1,29 @@
+import 'package:firebase_core/firebase_core.dart';
+import 'package:logger/logger.dart';
+
+const _maxRetries = 3;
+const _baseDelayMs = 1000;
+
+/// Retries [fn] when it throws FirebaseException with code 'unavailable'.
+/// Firestore transient errors often succeed on retry with backoff.
+Future<T> retryOnFirestoreUnavailable<T>(Future<T> Function() fn) async {
+  var attempt = 0;
+  while (true) {
+    try {
+      return await fn();
+    } catch (e) {
+      final isUnavailable = e is FirebaseException &&
+          (e.code == 'unavailable' || e.code.contains('unavailable'));
+      if (isUnavailable && attempt < _maxRetries) {
+        attempt++;
+        final delayMs = _baseDelayMs * (1 << (attempt - 1));
+        Logger().w(
+          'Firestore unavailable (attempt $attempt/$_maxRetries), retrying in ${delayMs}ms',
+        );
+        await Future.delayed(Duration(milliseconds: delayMs));
+      } else {
+        rethrow;
+      }
+    }
+  }
+}

package/templates/firebase/lib/core/data/api/http_client.dart

@@ -0,0 +1,38 @@
+import 'package:dio/dio.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/environnements.dart';
+
+final httpClientProvider = Provider<HttpClient>((ref) {
+  return HttpClient.fromEnv();
+});
+
+class HttpClient with DioMixin implements Dio {
+  String? authToken;
+
+  HttpClient({
+    required String baseUrl,
+  }) {
+    options = BaseOptions(
+      baseUrl: baseUrl,
+    );
+    httpClientAdapter = HttpClientAdapter();
+    interceptors.add(
+      InterceptorsWrapper(onRequest: (options, handler) {
+        if (authToken != null) {
+          options.headers.putIfAbsent(
+            'Authorization',
+            () => 'Bearer $authToken',
+          );
+        }
+        return handler.next(options);
+      }),
+    );
+  }
+
+  factory HttpClient.fromEnv() {
+    final env = Environment.fromEnv();
+    return HttpClient(
+      baseUrl: env.backendUrl,
+    );
+  }
+}

package/templates/firebase/lib/core/data/api/image.dart

@@ -0,0 +1,52 @@
+import 'dart:typed_data';
+
+import 'package:image/image.dart';
+import 'package:image_picker/image_picker.dart';
+import 'package:universal_io/io.dart';
+
+extension ImageToJpeg on XFile {
+  Future<Uint8List> toJpeg(int maxWidth, int quality) async {
+    final bytes = await readAsBytes();
+    final Image? image = decodeImage(bytes);
+    final thumbnail = copyResize(image!, width: maxWidth);
+    // EncodeJpg is not supported on flutter test
+    if (Platform.environment.containsKey('FLUTTER_TEST')) {
+      return thumbnail.getBytes();
+    }
+    return encodeJpg(thumbnail, quality: quality);
+  }
+}
+
+/// this class allows to pass parameters to the isolate
+class JpegParams {
+  /// the image to resize
+  final Uint8List data;
+
+  /// the maximum width of the image to resize
+  final int maxWidth;
+
+  /// 0-100 (80 is recommended)
+  final int quality;
+
+  JpegParams({
+    required this.data,
+    required this.maxWidth,
+    required this.quality,
+  });
+}
+
+/// this function is executed in a separate isolate
+/// to avoid blocking the UI
+/// Compute is a Flutter function that allows to execute
+/// a function in a separate isolate
+/// https://api.flutter.dev/flutter/foundation/compute.html?ref=blog.flutter.wtf
+/// -> It has to be a top level function to work
+Future<Uint8List> imgToJpeg(JpegParams params) async {
+  final Image? image = decodeImage(params.data);
+  final thumbnail = copyResize(image!, width: params.maxWidth);
+  // EncodeJpg is not supported on flutter test
+  if (Platform.environment.containsKey('FLUTTER_TEST')) {
+    return thumbnail.getBytes();
+  }
+  return encodeJpg(thumbnail, quality: params.quality);
+}