create-flutterinit 0.1.0

package/templates/base/lib/src/shared/widgets/toast/raw_toast.dart.hbs

@@ -0,0 +1,109 @@
+import '../../../imports/imports.dart';
+
+class RawToast extends StatefulWidget {
+  final Widget child;
+  final Duration animationDuration;
+  final Duration snackbarDuration;
+  final Curve? animationCurve;
+  final bool autoDismiss;
+  final ToastPosition toastPosition;
+  final double Function() getscaleFactor;
+  final double Function() getPosition;
+  final void Function() onRemove;
+
+  const RawToast({
+    super.key,
+    required this.child,
+    required this.animationDuration,
+    required this.toastPosition,
+    required this.snackbarDuration,
+    required this.onRemove,
+    this.autoDismiss = true,
+    required this.getPosition,
+    this.animationCurve,
+    required this.getscaleFactor,
+  });
+
+  @override
+  State<RawToast> createState() => RawToastState();
+}
+
+class RawToastState extends State<RawToast> {
+  final GlobalKey positionedKey = GlobalKey();
+
+  Widget getChildBasedOnDismiss(Widget child) {
+    return Animate(
+      onComplete: (controller) {
+        if (widget.autoDismiss) {
+          widget.onRemove();
+        }
+      },
+      effects: [
+        SlideEffect(
+          begin: Offset(
+            0,
+            widget.toastPosition == ToastPosition.bottom ? 2 : -2,
+          ),
+          end: Offset.zero,
+          duration: Duration(
+            milliseconds: 2 * widget.animationDuration.inMilliseconds,
+          ),
+          curve: widget.animationCurve ?? Curves.elasticOut,
+        ),
+        FadeEffect(
+          duration: widget.animationDuration,
+          begin: 0,
+          end: 1,
+        ),
+        if (widget.autoDismiss)
+          SlideEffect(
+            delay: widget.snackbarDuration,
+            duration: const Duration(milliseconds: 500),
+            curve: widget.animationCurve ?? Curves.easeInOut,
+            begin: Offset.zero,
+            end: Offset(
+              0,
+              widget.toastPosition == ToastPosition.bottom ? 2 : -2,
+            ),
+          ),
+      ],
+      child: Dismissible(
+        key: UniqueKey(),
+        direction: DismissDirection.up,
+        onDismissed: (direction) {
+          widget.onRemove();
+        },
+        child: widget.child,
+      ),
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return AnimatedPositioned(
+      duration: Duration(
+        milliseconds: widget.animationDuration.inMilliseconds,
+      ),
+      key: positionedKey,
+      curve: Curves.easeOutBack,
+      top: widget.toastPosition == ToastPosition.top
+          ? widget.getPosition() + 55
+          : null,
+      bottom: widget.toastPosition == ToastPosition.bottom
+          ? widget.getPosition() + 60
+          : null,
+      left: 0,
+      right: 0,
+      child: Material(
+        color: Colors.transparent,
+        child: AnimatedScale(
+          duration: widget.animationDuration,
+          curve: Curves.bounceOut,
+          scale: widget.getPosition() == 0 ? 1 : widget.getscaleFactor(),
+          child: getChildBasedOnDismiss(widget.child),
+        ),
+      ),
+    );
+  }
+}
+

package/templates/base/lib/src/shared/widgets/toast/toast.dart.hbs

@@ -0,0 +1,142 @@
+import '../../../imports/imports.dart';
+
+/// Enum for toast positions.
+enum ToastPosition { top, bottom }
+
+/// The gap between stack of cards.
+int gapBetweenCard = 15;
+
+/// Calculate position of old cards based on current position.
+double calculatePosition(List<ToastBar> toastBars, ToastBar self) {
+  if (toastBars.isNotEmpty && self != toastBars.last) {
+    final box =
+        self.info.key.currentContext?.findRenderObject() as RenderBox?;
+    if (box != null) {
+      return gapBetweenCard * (toastBars.length - toastBars.indexOf(self) - 1);
+    }
+  }
+  return 0;
+}
+
+/// Rescale the old cards based on its position.
+double calculateScaleFactor(List<ToastBar> toastBars, ToastBar current) {
+  final int index = toastBars.indexOf(current);
+  final int indexValFromLast = toastBars.length - 1 - index;
+  final double factor = indexValFromLast / 25;
+  final double res = 0.97 - factor;
+  return res < 0 ? 0 : res;
+}
+
+List<ToastBar> _toastBars = [];
+
+/// Toast core class.
+class ToastBar {
+  /// Duration of toast when autoDismiss is true.
+  final Duration toastDuration;
+
+  /// Position of toast.
+  final ToastPosition position;
+
+  /// Set true to dismiss toast automatically based on toastDuration.
+  final bool autoDismiss;
+
+  /// Pass the widget inside builder context.
+  final WidgetBuilder builder;
+
+  /// Duration of animated transitions.
+  final Duration animationDuration;
+
+  /// Animation Curve.
+  final Curve? animationCurve;
+
+  /// Info on each toast.
+  late final SnackBarInfo info;
+
+  /// Initialise ToastBar with required parameters.
+  ToastBar({
+    this.toastDuration = const Duration(milliseconds: 5000),
+    this.position = ToastPosition.bottom,
+    required this.builder,
+    this.animationDuration = const Duration(milliseconds: 700),
+    this.autoDismiss = false,
+    this.animationCurve,
+  }) : assert(
+          toastDuration.inMilliseconds > animationDuration.inMilliseconds,
+        );
+
+  /// Remove individual toastBars on dismiss.
+  void remove() {
+    info.entry.remove();
+    _toastBars.removeWhere((element) => element == this);
+  }
+
+  /// Push the toast in current context.
+  void show(BuildContext context) {
+    final OverlayState overlayState = Navigator.of(context).overlay!;
+    info = SnackBarInfo(
+      key: GlobalKey<RawToastState>(),
+      createdAt: DateTime.now(),
+    );
+    info.entry = OverlayEntry(
+      builder: (_) => RawToast(
+        key: info.key,
+        animationDuration: animationDuration,
+        toastPosition: position,
+        animationCurve: animationCurve,
+        autoDismiss: autoDismiss,
+        getPosition: () => calculatePosition(_toastBars, this),
+        getscaleFactor: () => calculateScaleFactor(_toastBars, this),
+        snackbarDuration: toastDuration,
+        onRemove: remove,
+        child: builder.call(context),
+      ),
+    );
+
+    _toastBars.add(this);
+    overlayState.insert(info.entry);
+  }
+
+  /// Remove all the toasts in the context.
+  static void removeAll() {
+    for (int i = 0; i < _toastBars.length; i++) {
+      _toastBars[i].info.entry.remove();
+    }
+    _toastBars.removeWhere((element) => true);
+  }
+}
+
+/// Snackbar info class.
+class SnackBarInfo {
+  late final OverlayEntry entry;
+  final GlobalKey<RawToastState> key;
+  final DateTime createdAt;
+
+  SnackBarInfo({
+    required this.key,
+    required this.createdAt,
+  });
+
+  @override
+  bool operator ==(Object other) {
+    if (identical(this, other)) return true;
+
+    return other is SnackBarInfo &&
+        other.entry == entry &&
+        other.key == key &&
+        other.createdAt == createdAt;
+  }
+
+  @override
+  int get hashCode => entry.hashCode ^ key.hashCode ^ createdAt.hashCode;
+}
+
+/// Get all the toastBars which are currently on context.
+extension Cleaner on List<ToastBar> {
+  /// Clean function to iterate over toastBars which are in context.
+  List<ToastBar> clean() {
+    return where(
+      (element) => element.info.key.currentState != null,
+    ).toList();
+  }
+}
+

package/templates/base/lib/src/shared/widgets/toast/toast_card.dart.hbs

@@ -0,0 +1,57 @@
+import '../../../imports/imports.dart';
+
+/// ToastCard widget to display decent and rich looking toast.
+class ToastCard extends StatelessWidget {
+  final Widget title;
+  final Widget? subtitle;
+  final Widget? leading;
+  final Widget? trailing;
+  final Color? color;
+  final Color? shadowColor;
+  final void Function()? onTap;
+
+  const ToastCard({
+    super.key,
+    required this.title,
+    this.subtitle,
+    this.leading,
+    this.color,
+    this.shadowColor,
+    this.trailing,
+    this.onTap,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return Container(
+      margin: const EdgeInsets.symmetric(horizontal: 20),
+      decoration: BoxDecoration(
+        color: color ?? context.theme.dialogTheme.backgroundColor,
+        borderRadius: BorderRadius.circular(16),
+        border: Border.all(
+          color: context.theme.colorScheme.outline,
+        ),
+        boxShadow: [
+          BoxShadow(
+            blurRadius: 10,
+            spreadRadius: 0,
+            offset: Offset.zero,
+            color: shadowColor ?? Colors.black.withValues(alpha: 0.05),
+          ),
+        ],
+      ),
+      child: ListTile(
+        contentPadding: const EdgeInsets.symmetric(horizontal: 8),
+        leading: Padding(
+          padding: const EdgeInsets.only(left: 10),
+          child: leading,
+        ),
+        trailing: trailing,
+        subtitle: subtitle,
+        title: title,
+        onTap: onTap,
+      ),
+    );
+  }
+}
+

package/templates/base/lib/src/shared/widgets/widgets.dart.hbs

@@ -0,0 +1,14 @@
+export 'app_icon.dart';
+export 'app_button.dart';
+export 'app_text_field.dart';
+export 'app_loading.dart';
+export 'app_error_widget.dart';
+export 'app_empty_state.dart';
+export 'app_card.dart';
+export 'app_divider.dart';
+export 'app_top_bar.dart';
+export 'common_image.dart';
+export 'toast/imports.dart';
+{{#if flags.usesCachedNetworkImage}}
+export 'app_cached_image.dart';
+{{/if}}

package/templates/base/lib/src/shared/wrappers/(isRiverpod,isProvider,isBloc,isGetX,isMobX)@state_wrapper.dart.hbs

@@ -0,0 +1,51 @@
+import '../../imports/imports.dart';
+{{#if flags.isBloc}}
+import '../../{{#if (eq architecture "layer-first")}}data/repositories/{{else if (eq architecture "mvc")}}services/{{else if (eq architecture "mvvm")}}data/repositories/{{else}}features/auth/data/repositories/{{/if}}auth_repository_impl.dart';
+import '../../{{#if (eq architecture "layer-first")}}presentation/providers/session_bloc.dart{{else if (eq architecture "mvc")}}controllers/auth/session_bloc.dart{{else if (eq architecture "mvvm")}}ui/auth/bloc/session_bloc.dart{{else}}features/auth/presentation/providers/session_bloc.dart{{/if}}';
+{{else if flags.isProvider}}
+import '../../{{#if (eq architecture "layer-first")}}data/repositories/{{else if (eq architecture "mvc")}}services/{{else if (eq architecture "mvvm")}}data/repositories/{{else}}features/auth/data/repositories/{{/if}}auth_repository_impl.dart';
+import '../../{{#if (eq architecture "layer-first")}}presentation/providers/session_provider.dart{{else if (eq architecture "mvc")}}controllers/auth/session_provider.dart{{else if (eq architecture "mvvm")}}ui/auth/providers/session_provider.dart{{else}}features/auth/presentation/providers/session_provider.dart{{/if}}';
+{{else if flags.isMobX}}
+import '../../{{#if (eq architecture "layer-first")}}data/repositories/{{else if (eq architecture "mvc")}}services/{{else if (eq architecture "mvvm")}}data/repositories/{{else}}features/auth/data/repositories/{{/if}}auth_repository_impl.dart';
+import '../../{{#if (eq architecture "layer-first")}}presentation/providers/session_store.dart{{else if (eq architecture "mvc")}}controllers/auth/session_store.dart{{else if (eq architecture "mvvm")}}ui/auth/stores/session_store.dart{{else}}features/auth/presentation/providers/session_store.dart{{/if}}';
+{{/if}}
+
+/// A wrapper to initialize the chosen State Management library.
+class StateWrapper extends StatelessWidget {
+  final Widget child;
+
+  const StateWrapper({
+    super.key,
+    required this.child,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    {{#if flags.isRiverpod}}
+    return ProviderScope(child: child);
+    {{else if flags.isProvider}}
+    return MultiProvider(
+      providers: [
+        ChangeNotifierProvider<SessionProvider>(create: (_) => SessionProvider(repository: AuthRepositoryImpl())),
+      ],
+      child: child,
+    );
+    {{else if flags.isBloc}}
+    return MultiBlocProvider(
+      providers: [
+        BlocProvider<SessionBloc>(create: (_) => SessionBloc(repository: AuthRepositoryImpl())),
+      ],
+      child: child,
+    );
+    {{else if flags.isMobX}}
+    return MultiProvider(
+      providers: [
+        Provider<SessionStore>(create: (_) => SessionStore(repository: AuthRepositoryImpl())),
+      ],
+      child: child,
+    );
+    {{else}}
+    return child;
+    {{/if}}
+  }
+}

package/templates/base/lib/src/shared/wrappers/(supportsLocalization)@localization_wrapper.dart.hbs

@@ -0,0 +1,25 @@
+import '../../imports/core_imports.dart';
+
+/// A wrapper to initialize [EasyLocalization] with supported locales.
+class LocalizationWrapper extends StatelessWidget {
+  final Widget child;
+
+  const LocalizationWrapper({
+    super.key,
+    required this.child,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return EasyLocalization(
+      supportedLocales: const [
+        {{#each flags.supportedLocales}}
+        Locale('{{this}}'),
+        {{/each}}
+      ],
+      path: 'assets/translations',
+      fallbackLocale: const Locale('{{flags.fallbackLocale}}'),
+      child: child,
+    );
+  }
+}

package/templates/base/lib/src/shared/wrappers/(usesScreenutil)@screen_util_wrapper.dart.hbs

@@ -0,0 +1,27 @@
+import '../../imports/imports.dart';
+
+/// A wrapper to initialize [ScreenUtil] with design-specific constraints.
+class ScreenUtilWrapper extends StatelessWidget {
+  final Widget child;
+  final Size designSize;
+  final bool minTextAdapt;
+  final bool splitScreenMode;
+
+  const ScreenUtilWrapper({
+    super.key,
+    required this.child,
+    this.designSize = const Size(360, 690),
+    this.minTextAdapt = true,
+    this.splitScreenMode = true,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return ScreenUtilInit(
+      designSize: designSize,
+      minTextAdapt: minTextAdapt,
+      splitScreenMode: splitScreenMode,
+      builder: (context, _) => child,
+    );
+  }
+}

package/templates/base/lib/src/shared/wrappers/(usesSkeletonizer)@skeleton_wrapper.dart.hbs

@@ -0,0 +1,81 @@
+import '../../imports/imports.dart';
+
+/// A wrapper widget that provides skeleton loading effects.
+/// 
+/// Uses [Skeletonizer] if enabled.
+class SkeletonWrapper extends StatelessWidget {
+  final Widget child;
+  final bool isLoading;
+  final bool enabled;
+
+  /// Custom skeleton effect (e.g., ShimmerEffect, PulseEffect)
+  final ShimmerEffect? effect;
+
+  /// Whether to animate the transition between skeleton and content
+  final bool enableSwitchAnimation;
+
+  /// Configuration for the switch animation
+  final SwitchAnimationConfig? switchAnimationConfig;
+
+  /// Whether to justify multi-line text bones
+  final bool? justifyMultiLineText;
+
+  /// Whether to ignore all containers and only skeletonize their children
+  final bool ignoreContainers;
+
+  /// If provided, all containers will be painted with this color
+  final Color? containersColor;
+
+  /// The border radius of the text bones
+  final TextBoneBorderRadius? textBoneBorderRadius;
+
+  /// Whether to ignore pointers when loading
+  final bool ignorePointers;
+
+  const SkeletonWrapper({
+    super.key,
+    required this.child,
+    this.isLoading = false,
+    this.enabled = true,
+    this.effect,
+    this.enableSwitchAnimation = false,
+    this.switchAnimationConfig,
+    this.justifyMultiLineText,
+    this.ignoreContainers = false,
+    this.containersColor,
+    this.textBoneBorderRadius,
+    this.ignorePointers = true,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    if (!enabled) return child;
+
+    {{#if flags.usesSkeletonizer}}
+    return Skeletonizer(
+      enabled: isLoading,
+      effect: effect,
+      enableSwitchAnimation: enableSwitchAnimation,
+      switchAnimationConfig: switchAnimationConfig,
+      justifyMultiLineText: justifyMultiLineText,
+      ignoreContainers: ignoreContainers,
+      containersColor: containersColor,
+      textBoneBorderRadius: textBoneBorderRadius,
+      ignorePointers: ignorePointers,
+      child: child,
+    );
+    {{else}}
+    if (isLoading) {
+      // Simple fallback for loading state if skeletonizer is not enabled
+      return AbsorbPointer(
+        absorbing: ignorePointers,
+        child: Opacity(
+          opacity: 0.5,
+          child: child,
+        ),
+      );
+    }
+    return child;
+    {{/if}}
+  }
+}