kasy-cli 1.2.1

package/templates/firebase/lib/core/keyboard_fix/keyboard_flicker_fix.dart

@@ -0,0 +1,164 @@
+import 'dart:async';
+import 'dart:ui' as ui;
+
+import 'package:flutter/foundation.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter/widgets.dart';
+
+/// Prevents the keyboard from flickering when the user taps between TextFields.
+///
+/// Root cause: Flutter stable 3.41.x sends TextInput.clearClient before
+/// TextInput.setClient during focus transitions, so the platform briefly
+/// dismisses the keyboard before reopening it. Fixed in master (PR #182661)
+/// but not yet in stable.
+///
+/// How it works: intercepts clearClient at the BinaryMessenger layer and holds
+/// it for up to [_holdDelay]. If setClient arrives within that window, the
+/// clearClient is dropped entirely. If no setClient comes, it is forwarded
+/// normally (user tapped outside all fields).
+///
+/// Remove this file once Flutter stable ships the engine fix.
+class _KeyboardFlickerFixMessenger extends BinaryMessenger {
+  _KeyboardFlickerFixMessenger(this._delegate);
+
+  final BinaryMessenger _delegate;
+
+  static const String _channel = 'flutter/textinput';
+
+  // flutter/textinput uses JSONMethodCodec, not StandardMethodCodec.
+  static const JSONMethodCodec _codec = JSONMethodCodec();
+
+  // 80 ms gives enough time for setClient to arrive after clearClient
+  // while being imperceptible to the user if no setClient comes.
+  static const Duration _holdDelay = Duration(milliseconds: 80);
+
+  Timer? _pendingTimer;
+  Completer<ByteData?>? _pendingCompleter;
+  ByteData? _pendingMessage;
+
+  @override
+  Future<ByteData?>? send(String channel, ByteData? message) {
+    if (channel != _channel || message == null) {
+      return _delegate.send(channel, message);
+    }
+
+    final MethodCall call;
+    try {
+      call = _codec.decodeMethodCall(message);
+    } catch (_) {
+      return _delegate.send(channel, message);
+    }
+
+    switch (call.method) {
+      case 'TextInput.clearClient':
+        return _holdClearClient(message);
+
+      case 'TextInput.setClient':
+        _cancelPending();
+        return _delegate.send(channel, message);
+
+      case 'TextInput.hide':
+        _forwardNow();
+        return _delegate.send(channel, message);
+
+      default:
+        return _delegate.send(channel, message);
+    }
+  }
+
+  Future<ByteData?> _holdClearClient(ByteData message) {
+    _forwardNow(); // flush any previously held clearClient first
+
+    final completer = Completer<ByteData?>();
+    _pendingCompleter = completer;
+    _pendingMessage = message;
+
+    debugPrint('[KasyBinding] clearClient held');
+
+    _pendingTimer = Timer(_holdDelay, () {
+      debugPrint('[KasyBinding] clearClient forwarded (no setClient came)');
+      _forwardNow();
+    });
+
+    return completer.future;
+  }
+
+  void _cancelPending() {
+    if (_pendingMessage == null) return;
+    debugPrint('[KasyBinding] setClient arrived - clearClient cancelled');
+    _pendingTimer?.cancel();
+    _pendingTimer = null;
+    _pendingMessage = null;
+    if (_pendingCompleter != null && !_pendingCompleter!.isCompleted) {
+      _pendingCompleter!.complete(null);
+    }
+    _pendingCompleter = null;
+  }
+
+  void _forwardNow() {
+    final message = _pendingMessage;
+    final completer = _pendingCompleter;
+    _pendingTimer?.cancel();
+    _pendingTimer = null;
+    _pendingMessage = null;
+    _pendingCompleter = null;
+
+    if (message == null) {
+      if (completer != null && !completer.isCompleted) {
+        completer.complete(null);
+      }
+      return;
+    }
+
+    final result = _delegate.send(_channel, message);
+    if (completer == null || completer.isCompleted) return;
+    if (result == null) {
+      completer.complete(null);
+    } else {
+      result.then(completer.complete, onError: completer.completeError);
+    }
+  }
+
+  @override
+  void setMessageHandler(String channel, MessageHandler? handler) =>
+      _delegate.setMessageHandler(channel, handler);
+
+  @override
+  @Deprecated(
+    'Instead of calling this method, use ServicesBinding.instance.channelBuffers.push. '
+    'This feature was deprecated after v3.9.0-19.0.pre.',
+  )
+  Future<void> handlePlatformMessage(
+    String channel,
+    ByteData? data,
+    ui.PlatformMessageResponseCallback? callback,
+  ) {
+    // ignore: deprecated_member_use
+    return _delegate.handlePlatformMessage(channel, data, callback);
+  }
+}
+
+/// Custom binding that installs [_KeyboardFlickerFixMessenger].
+///
+/// Replace [WidgetsFlutterBinding.ensureInitialized] with this in main():
+/// ```dart
+/// KasyBinding.ensureInitialized();
+/// ```
+class KasyBinding extends WidgetsFlutterBinding {
+  @override
+  BinaryMessenger createBinaryMessenger() {
+    debugPrint('[KasyBinding] installing keyboard flicker fix');
+    return _KeyboardFlickerFixMessenger(super.createBinaryMessenger());
+  }
+
+  static WidgetsBinding ensureInitialized() {
+    try {
+      // Throws FlutterError in debug / returns non-null in release
+      // when binding is already initialized.
+      return WidgetsBinding.instance;
+    } catch (_) {
+      return KasyBinding();
+    }
+  }
+}
+

package/templates/firebase/lib/core/navigation/kasy_fade_page_transitions_builder.dart

@@ -0,0 +1,34 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/navigation/kasy_navigation_config.dart';
+
+/// Fallback [PageTransitionsTheme] builder — same fade on every platform.
+class KasyFadePageTransitionsBuilder extends PageTransitionsBuilder {
+  const KasyFadePageTransitionsBuilder();
+
+  @override
+  Widget buildTransitions<T>(
+    PageRoute<T> route,
+    BuildContext context,
+    Animation<double> animation,
+    Animation<double> secondaryAnimation,
+    Widget child,
+  ) {
+    final Animation<double> curved = CurvedAnimation(
+      parent: animation,
+      curve: KasyNavigationConfig.curve,
+      reverseCurve: KasyNavigationConfig.reverseCurve,
+    );
+    return FadeTransition(opacity: curved, child: child);
+  }
+}
+
+const PageTransitionsTheme kasyPageTransitionsTheme = PageTransitionsTheme(
+  builders: <TargetPlatform, PageTransitionsBuilder>{
+    TargetPlatform.android: KasyFadePageTransitionsBuilder(),
+    TargetPlatform.iOS: KasyFadePageTransitionsBuilder(),
+    TargetPlatform.macOS: KasyFadePageTransitionsBuilder(),
+    TargetPlatform.linux: KasyFadePageTransitionsBuilder(),
+    TargetPlatform.windows: KasyFadePageTransitionsBuilder(),
+    TargetPlatform.fuchsia: KasyFadePageTransitionsBuilder(),
+  },
+);

package/templates/firebase/lib/core/navigation/kasy_material_page_route.dart

@@ -0,0 +1,41 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/navigation/kasy_navigation_config.dart';
+import 'package:kasy_kit/core/navigation/kasy_route_transition.dart';
+import 'package:kasy_kit/core/navigation/kasy_transition_kind.dart';
+
+/// Legacy [MaterialPageRoute] that uses the same motion as GoRouter pages.
+class KasyMaterialPageRoute<T> extends MaterialPageRoute<T> {
+  KasyMaterialPageRoute({
+    required super.builder,
+    super.settings,
+    KasyTransitionKind? transition,
+    this.fillColor,
+  }) : _kind = transition ?? KasyNavigationConfig.push;
+
+  final KasyTransitionKind _kind;
+  final Color? fillColor;
+
+  @override
+  Duration get transitionDuration => kasyTransitionDurationFor(_kind);
+
+  @override
+  Duration get reverseTransitionDuration =>
+      kasyReverseTransitionDurationFor(_kind);
+
+  @override
+  Widget buildTransitions(
+    BuildContext context,
+    Animation<double> animation,
+    Animation<double> secondaryAnimation,
+    Widget child,
+  ) {
+    return kasyBuildRouteTransition(
+      context: context,
+      animation: animation,
+      secondaryAnimation: secondaryAnimation,
+      child: child,
+      kind: _kind,
+      fillColor: fillColor,
+    );
+  }
+}

package/templates/firebase/lib/core/navigation/kasy_navigation_config.dart

@@ -0,0 +1,29 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/navigation/kasy_transition_kind.dart';
+
+/// Global navigation motion defaults for the Kasy kit.
+///
+/// Change [push] (or [duration]) here to update most full-screen routes at once.
+/// Per-route overrides go through [kasyTransitionPage].
+abstract final class KasyNavigationConfig {
+  const KasyNavigationConfig._();
+  /// Opening a screen on top of another (e.g. Settings → Feedback).
+  static KasyTransitionKind push = KasyTransitionKind.fade;
+
+  /// Replacing the current route (e.g. Guard → /signin).
+  static KasyTransitionKind replace = KasyTransitionKind.fade;
+
+  /// Sibling auth screens (login ↔ signup).
+  static KasyTransitionKind authPeer = KasyTransitionKind.sharedAxisScaled;
+
+  /// Bottom navigation tabs (Bart).
+  static KasyTransitionKind bottomTab = KasyTransitionKind.fade;
+
+  /// Onboarding step navigator.
+  static KasyTransitionKind onboardingStep = KasyTransitionKind.fade;
+
+  static const Duration duration = Duration(milliseconds: 250);
+  static const Duration reverseDuration = Duration(milliseconds: 220);
+  static const Curve curve = Curves.easeOutCubic;
+  static const Curve reverseCurve = Curves.easeInCubic;
+}

package/templates/firebase/lib/core/navigation/kasy_page_transition.dart

@@ -0,0 +1,40 @@
+import 'package:flutter/material.dart';
+import 'package:go_router/go_router.dart';
+import 'package:kasy_kit/core/navigation/kasy_navigation_config.dart';
+import 'package:kasy_kit/core/navigation/kasy_route_transition.dart';
+import 'package:kasy_kit/core/navigation/kasy_transition_kind.dart';
+
+/// GoRouter page with a [KasyNavigationConfig]-driven transition.
+CustomTransitionPage<T> kasyTransitionPage<T>({
+  required LocalKey key,
+  required Widget child,
+  KasyTransitionKind? transition,
+  Color? fillColor,
+  Duration? transitionDuration,
+  Duration? reverseTransitionDuration,
+}) {
+  final KasyTransitionKind kind = transition ?? KasyNavigationConfig.push;
+  return CustomTransitionPage<T>(
+    key: key,
+    transitionDuration:
+        transitionDuration ?? kasyTransitionDurationFor(kind),
+    reverseTransitionDuration:
+        reverseTransitionDuration ?? kasyReverseTransitionDurationFor(kind),
+    child: child,
+    transitionsBuilder: (
+      context,
+      animation,
+      secondaryAnimation,
+      pageChild,
+    ) {
+      return kasyBuildRouteTransition(
+        context: context,
+        animation: animation,
+        secondaryAnimation: secondaryAnimation,
+        child: pageChild,
+        kind: kind,
+        fillColor: fillColor,
+      );
+    },
+  );
+}

package/templates/firebase/lib/core/navigation/kasy_route_transition.dart

@@ -0,0 +1,68 @@
+import 'package:animations/animations.dart';
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/navigation/kasy_navigation_config.dart';
+import 'package:kasy_kit/core/navigation/kasy_transition_kind.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+
+/// Builds the animated child for routes, tabs, and legacy [PageRoute]s.
+Widget kasyBuildRouteTransition({
+  required BuildContext context,
+  required Animation<double> animation,
+  required Animation<double> secondaryAnimation,
+  required Widget child,
+  required KasyTransitionKind kind,
+  Color? fillColor,
+}) {
+  if (kind == KasyTransitionKind.none) {
+    return child;
+  }
+  final Animation<double> primary = CurvedAnimation(
+    parent: animation,
+    curve: KasyNavigationConfig.curve,
+    reverseCurve: KasyNavigationConfig.reverseCurve,
+  );
+  final Animation<double> secondary = CurvedAnimation(
+    parent: secondaryAnimation,
+    curve: KasyNavigationConfig.curve,
+    reverseCurve: KasyNavigationConfig.reverseCurve,
+  );
+  final Color resolvedFill = fillColor ?? context.colors.background;
+  return switch (kind) {
+    KasyTransitionKind.fade => FadeTransition(opacity: primary, child: child),
+    KasyTransitionKind.fadeThrough => FadeThroughTransition(
+      animation: primary,
+      secondaryAnimation: secondary,
+      fillColor: resolvedFill,
+      child: child,
+    ),
+    KasyTransitionKind.sharedAxisScaled => SharedAxisTransition(
+      animation: primary,
+      secondaryAnimation: secondary,
+      transitionType: SharedAxisTransitionType.scaled,
+      fillColor: resolvedFill,
+      child: child,
+    ),
+    KasyTransitionKind.sharedAxisHorizontal => SharedAxisTransition(
+      animation: primary,
+      secondaryAnimation: secondary,
+      transitionType: SharedAxisTransitionType.horizontal,
+      fillColor: resolvedFill,
+      child: child,
+    ),
+    KasyTransitionKind.none => child,
+  };
+}
+
+Duration kasyTransitionDurationFor(KasyTransitionKind kind) {
+  if (kind == KasyTransitionKind.none) {
+    return Duration.zero;
+  }
+  return KasyNavigationConfig.duration;
+}
+
+Duration kasyReverseTransitionDurationFor(KasyTransitionKind kind) {
+  if (kind == KasyTransitionKind.none) {
+    return Duration.zero;
+  }
+  return KasyNavigationConfig.reverseDuration;
+}

package/templates/firebase/lib/core/navigation/kasy_transition_kind.dart

@@ -0,0 +1,17 @@
+/// Screen transition presets used by [KasyNavigationConfig] and [kasyTransitionPage].
+enum KasyTransitionKind {
+  /// Crossfade — default push across Android, iOS, and Web.
+  fade,
+
+  /// Material fade-through (outgoing fades before incoming).
+  fadeThrough,
+
+  /// Shared axis depth / scale (no lateral slide).
+  sharedAxisScaled,
+
+  /// Shared axis horizontal slide.
+  sharedAxisHorizontal,
+
+  /// Instant swap (camera, technical routes).
+  none,
+}

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

@@ -0,0 +1,6 @@
+export 'package:kasy_kit/core/navigation/kasy_fade_page_transitions_builder.dart';
+export 'package:kasy_kit/core/navigation/kasy_material_page_route.dart';
+export 'package:kasy_kit/core/navigation/kasy_navigation_config.dart';
+export 'package:kasy_kit/core/navigation/kasy_page_transition.dart';
+export 'package:kasy_kit/core/navigation/kasy_route_transition.dart';
+export 'package:kasy_kit/core/navigation/kasy_transition_kind.dart';

package/templates/firebase/lib/core/rating/api/rating_api.dart

@@ -0,0 +1,99 @@
+// coverage:ignore-file to ignore the whole file.
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:in_app_review/in_app_review.dart';
+import 'package:kasy_kit/core/shared_preferences/shared_preferences.dart';
+import 'package:kasy_kit/environnements.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+
+const _lastAskKey = 'last_asking_date';
+const _lastAskForReviewKey = 'last_review_request_date';
+const _hasRateAppKey = 'has_rate_app';
+const _hasReviewAppKey = 'has_review_app';
+
+final ratingApiProvider = Provider<RatingApi>((ref) {
+  final prefsBuilder = ref.watch(sharedPreferencesProvider);
+  return RatingApi(
+    prefs: prefsBuilder.prefs,
+    inAppReview: InAppReview.instance,
+    env: ref.watch(environmentProvider),
+  );
+});
+
+/// we choosed here to save the last asking date and if the user has rate the app
+/// in the shared preferences
+/// But you can use any other storage solution (also in your remote database)
+class RatingApi {
+  final SharedPreferences _prefs;
+  final InAppReview _inAppReview;
+  final Environment _env;
+
+  RatingApi({
+    required SharedPreferences prefs,
+    required InAppReview inAppReview,
+    required Environment env,
+  })  : _prefs = prefs,
+        _env = env,
+        _inAppReview = inAppReview;
+
+  Future<void> saveLastAskingDate() async {
+    final now = DateTime.now();
+    await _prefs.setInt(_lastAskKey, now.millisecondsSinceEpoch);
+  }
+
+  Future<void> saveHasRateApp() async {
+    await _prefs.setBool(_hasRateAppKey, true);
+  }
+
+  void reset() {
+    _prefs.remove(_lastAskKey);
+    _prefs.remove(_hasRateAppKey);
+  }
+
+  Future<bool> hasRateApp() async {
+    final hasRateApp = _prefs.getBool(_hasRateAppKey);
+    return hasRateApp ?? false;
+  }
+
+  Future<DateTime?> lastAskingDate() async {
+    final lastAskingDate = _prefs.getInt(_lastAskKey);
+    if (lastAskingDate == null) {
+      return null;
+    }
+    return DateTime.fromMillisecondsSinceEpoch(lastAskingDate);
+  }
+
+  Future<void> openStoreListing() {
+    if (_env.appStoreId == null) {
+      throw Exception(
+        '''appStoreId is not defined in your environment, check [environnements.dart] file''',
+      );
+    }
+    return _inAppReview.openStoreListing(appStoreId: _env.appStoreId);
+  }
+
+  Future<void> showRatingDialog() {
+    return _inAppReview.requestReview();
+  }
+
+  Future<void> saveHasReviewApp() async {
+    await _prefs.setBool(_hasReviewAppKey, true);
+  }
+
+  Future<bool> hasReviewApp() async {
+    final hasReviewApp = _prefs.getBool(_hasReviewAppKey);
+    return hasReviewApp ?? false;
+  }
+
+  Future<void> saveLastReviewAskingDate() async {
+    final now = DateTime.now();
+    await _prefs.setInt(_lastAskForReviewKey, now.millisecondsSinceEpoch);
+  }
+
+  Future<DateTime?> lastReviewAskingDate() async {
+    final lastAskingDate = _prefs.getInt(_lastAskForReviewKey);
+    if (lastAskingDate == null) {
+      return null;
+    }
+    return DateTime.fromMillisecondsSinceEpoch(lastAskingDate);
+  }
+}

package/templates/firebase/lib/core/rating/models/rating.dart

@@ -0,0 +1,52 @@
+import 'package:kasy_kit/core/rating/api/rating_api.dart';
+
+class RatingSettings {
+  final Duration delayBeforeAsking;
+  final Duration delayBeforeAskingAgain;
+
+  RatingSettings({
+    required this.delayBeforeAsking,
+    required this.delayBeforeAskingAgain,
+  });
+}
+
+class Rating {
+  final RatingApi _ratingApi;
+  final RatingSettings settings;
+  final DateTime? lastAskingDate;
+  final DateTime? userCreationDate;
+  final DateTime _current;
+  final bool hasRateApp;
+
+  Rating({
+    required this.settings,
+    required RatingApi ratingApi,
+    required this.lastAskingDate,
+    required this.userCreationDate,
+    required this.hasRateApp,
+    DateTime? current,
+  })  : _ratingApi = ratingApi,
+        _current = current ?? DateTime.now();
+
+  bool shouldAsk() {
+    if (userCreationDate == null) {
+      return false;
+    }
+    if (hasRateApp) {
+      return false;
+    }
+    final appInstallDiff = _current.difference(userCreationDate!);
+    if (appInstallDiff < settings.delayBeforeAsking) {
+      return false;
+    }
+    if (lastAskingDate == null) {
+      return true;
+    }
+    return lastAskingDate!.difference(_current) >
+        settings.delayBeforeAskingAgain;
+  }
+
+  Future<void> openStoreListing() => _ratingApi.openStoreListing();
+
+  Future<void> showRatingDialog() => _ratingApi.showRatingDialog();
+}

package/templates/firebase/lib/core/rating/models/review.dart

@@ -0,0 +1,70 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/rating/api/rating_api.dart';
+
+class ReviewSettings {
+  /// delay before asking for the first time
+  final Duration delayBeforeAsking;
+
+  /// delay before asking again
+  final Duration delayBeforeAskingAgain;
+
+  /// max delay to ask for a review. If provded and the app is installed for more than this delay, we will not ask for a review
+  final Duration? maxDelay;
+
+  ReviewSettings({
+    required this.delayBeforeAsking,
+    required this.delayBeforeAskingAgain,
+    this.maxDelay,
+  });
+}
+
+class Review {
+  final RatingApi _ratingApi;
+  final ReviewSettings settings;
+  final DateTime? lastAskingDate;
+  final DateTime userCreationDate;
+  final DateTime _current;
+  final bool hasReviewApp;
+
+  Review({
+    required this.settings,
+    required RatingApi ratingApi,
+    required this.lastAskingDate,
+    required this.userCreationDate,
+    required this.hasReviewApp,
+    DateTime? current,
+  })  : _ratingApi = ratingApi,
+        _current = current ?? DateTime.now();
+
+  bool shouldAsk() {
+    if (hasReviewApp) {
+      debugPrint("👉 [Review] hasReviewApp");
+      return false;
+    }
+    final appInstallDiff = _current.difference(userCreationDate);
+    if (settings.maxDelay != null && appInstallDiff > settings.maxDelay!) {
+      debugPrint(
+          "👉 [Review] appInstallDiff > maxDelay (${settings.maxDelay})");
+      return false;
+    }
+    if (appInstallDiff < settings.delayBeforeAsking) {
+      debugPrint("👉 [Review] appInstallDiff < delayBeforeAsking (${settings.delayBeforeAsking})");
+      return false;
+    }
+    if (lastAskingDate == null) {
+      return true;
+    }
+    final lastAskingDiff = _current.difference(lastAskingDate!);
+    debugPrint("👉 [Review] lastAskingDiff ($lastAskingDiff)");
+    return lastAskingDiff > settings.delayBeforeAskingAgain;
+  }
+
+  Future<void> review() async {
+    await _ratingApi.saveHasReviewApp();
+    return _ratingApi.openStoreListing();
+  }
+
+  Future<void> delay() async {
+    await _ratingApi.saveLastReviewAskingDate();
+  }
+}