create-flutterinit 0.1.0

package/templates/base/lib/src/shared/wrappers/session_listener_wrapper.dart.hbs

@@ -0,0 +1,258 @@
+import 'package:{{flags.appSnake}}/src/imports/core_imports.dart';
+{{#unless flags.isNoneState}}
+import 'package:{{flags.appSnake}}/src/imports/packages_imports.dart';
+{{/unless}}
+
+{{#if flags.isRiverpod}}
+import 'package:{{flags.appSnake}}/src/{{#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.isBloc}}
+import 'package:{{flags.appSnake}}/src/{{#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.isGetX}}
+import 'package:{{flags.appSnake}}/src/{{#if (eq architecture "layer-first")}}presentation/providers/session_controller.dart{{else if (eq architecture "mvc")}}controllers/auth/session_controller.dart{{else if (eq architecture "mvvm")}}ui/auth/controllers/session_controller.dart{{else}}features/auth/presentation/providers/session_controller.dart{{/if}}';
+{{else if flags.isMobX}}
+import 'package:{{flags.appSnake}}/src/{{#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}}';
+{{else if flags.isProvider}}
+import 'package:{{flags.appSnake}}/src/{{#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.isNoneState}}
+// No session listener needed for NoneState — widget rebuilds are manual
+{{else}}
+// session_manager not easily retrieved via context globally if not using Provider, assuming single instance
+import 'package:{{flags.appSnake}}/src/{{#if (eq architecture "layer-first")}}presentation/providers/session_manager.dart{{else if (eq architecture "mvc")}}controllers/auth/session_manager.dart{{else if (eq architecture "mvvm")}}ui/auth/view_models/session_manager.dart{{else}}features/auth/presentation/providers/session_manager.dart{{/if}}';
+{{/if}}
+
+
+{{#if flags.isRiverpod}}
+class SessionListenerWrapper extends ConsumerWidget {
+  final Widget child;
+  const SessionListenerWrapper({super.key, required this.child});
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    ref.listen<SessionState>(sessionProvider, (prev, next) {
+      if (next.status != SessionStatus.unknown) {
+        {{#if flags.usesFlutterNativeSplash}}
+        FlutterNativeSplash.remove();
+        {{/if}}
+        if (next.status == SessionStatus.authenticated) {
+          {{#if (eq flags.routerPackage "go_router")}}
+          context.go(AppRoutes.home);
+          {{else if (eq flags.routerPackage "auto_route")}}
+          context.replaceRoute(const HomeRoute());
+          {{else}}
+          Navigator.pushReplacementNamed(context, AppRoutes.home);
+          {{/if}}
+        } else if (next.status == SessionStatus.unauthenticated) {
+          {{#if (eq flags.routerPackage "go_router")}}
+          context.go(AppRoutes.onboarding);
+          {{else if (eq flags.routerPackage "auto_route")}}
+          context.replaceRoute(const OnboardingRoute());
+          {{else}}
+          Navigator.pushReplacementNamed(context, AppRoutes.onboarding);
+          {{/if}}
+        }
+      }
+    });
+
+    return child;
+  }
+}
+{{else if flags.isBloc}}
+class SessionListenerWrapper extends StatelessWidget {
+  final Widget child;
+  const SessionListenerWrapper({super.key, required this.child});
+
+  @override
+  Widget build(BuildContext context) {
+    return BlocListener<SessionBloc, SessionState>(
+      listenWhen: (prev, next) => prev.status != next.status,
+      listener: (context, state) {
+        if (state.status != SessionStatus.unknown) {
+          {{#if flags.usesFlutterNativeSplash}}
+          FlutterNativeSplash.remove();
+          {{/if}}
+          if (state.status == SessionStatus.authenticated) {
+            {{#if (eq flags.routerPackage "go_router")}}
+            context.go(AppRoutes.home);
+            {{else if (eq flags.routerPackage "auto_route")}}
+            context.replaceRoute(const HomeRoute());
+            {{else}}
+            Navigator.pushReplacementNamed(context, AppRoutes.home);
+            {{/if}}
+          } else if (state.status == SessionStatus.unauthenticated) {
+            {{#if (eq flags.routerPackage "go_router")}}
+            context.go(AppRoutes.onboarding);
+            {{else if (eq flags.routerPackage "auto_route")}}
+            context.replaceRoute(const OnboardingRoute());
+            {{else}}
+            Navigator.pushReplacementNamed(context, AppRoutes.onboarding);
+            {{/if}}
+          }
+        }
+      },
+      child: child,
+    );
+  }
+}
+{{else if flags.isGetX}}
+class SessionListenerWrapper extends StatefulWidget {
+  final Widget child;
+  const SessionListenerWrapper({super.key, required this.child});
+
+  @override
+  State<SessionListenerWrapper> createState() => _SessionListenerWrapperState();
+}
+
+class _SessionListenerWrapperState extends State<SessionListenerWrapper> {
+  Worker? _worker;
+
+  @override
+  void initState() {
+    super.initState();
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      final session = Get.find<SessionController>();
+      _worker = ever(session.status, (status) {
+        if (status != SessionStatus.unknown) {
+          {{#if flags.usesFlutterNativeSplash}}
+          FlutterNativeSplash.remove();
+          {{/if}}
+          if (status == SessionStatus.authenticated) {
+            Get.offAllNamed(AppRoutes.home);
+          } else if (status == SessionStatus.unauthenticated) {
+            Get.offAllNamed(AppRoutes.onboarding);
+          }
+        }
+      }, condition: () => session.status.value != SessionStatus.unknown);
+    });
+  }
+
+  @override
+  void dispose() {
+    _worker?.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return widget.child;
+  }
+}
+{{else if flags.isMobX}}
+class SessionListenerWrapper extends StatefulWidget {
+  final Widget child;
+  const SessionListenerWrapper({super.key, required this.child});
+
+  @override
+  State<SessionListenerWrapper> createState() => _SessionListenerWrapperState();
+}
+
+class _SessionListenerWrapperState extends State<SessionListenerWrapper> {
+  late final ReactionDisposer _disposer;
+
+  @override
+  void didChangeDependencies() {
+    super.didChangeDependencies();
+    final sessionStore = Provider.of<SessionStore>(context, listen: false);
+    _disposer = reaction(
+      (_) => sessionStore.status,
+      (SessionStatus status) {
+        if (status != SessionStatus.unknown) {
+          {{#if flags.usesFlutterNativeSplash}}
+          FlutterNativeSplash.remove();
+          {{/if}}
+          if (status == SessionStatus.authenticated) {
+            {{#if (eq flags.routerPackage "go_router")}}
+            context.go(AppRoutes.home);
+            {{else if (eq flags.routerPackage "auto_route")}}
+            context.replaceRoute(const HomeRoute());
+            {{else}}
+            Navigator.pushReplacementNamed(context, AppRoutes.home);
+            {{/if}}
+          } else if (status == SessionStatus.unauthenticated) {
+            {{#if (eq flags.routerPackage "go_router")}}
+            context.go(AppRoutes.onboarding);
+            {{else if (eq flags.routerPackage "auto_route")}}
+            context.replaceRoute(const OnboardingRoute());
+            {{else}}
+            Navigator.pushReplacementNamed(context, AppRoutes.onboarding);
+            {{/if}}
+          }
+        }
+      },
+      fireImmediately: true,
+    );
+  }
+
+  @override
+  void dispose() {
+    _disposer();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return widget.child;
+  }
+}
+{{else if flags.isProvider}}
+class SessionListenerWrapper extends StatefulWidget {
+  final Widget child;
+  const SessionListenerWrapper({super.key, required this.child});
+
+  @override
+  State<SessionListenerWrapper> createState() => _SessionListenerWrapperState();
+}
+
+class _SessionListenerWrapperState extends State<SessionListenerWrapper> {
+  @override
+  void didChangeDependencies() {
+    super.didChangeDependencies();
+    final session = Provider.of<SessionProvider>(context);
+    if (session.status != SessionStatus.unknown) {
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        if (!mounted) return;
+        {{#if flags.usesFlutterNativeSplash}}
+        FlutterNativeSplash.remove();
+        {{/if}}
+        if (session.status == SessionStatus.authenticated) {
+          {{#if (eq flags.routerPackage "go_router")}}
+          context.go(AppRoutes.home);
+          {{else if (eq flags.routerPackage "auto_route")}}
+          context.replaceRoute(const HomeRoute());
+          {{else}}
+          Navigator.pushReplacementNamed(context, AppRoutes.home);
+          {{/if}}
+        } else if (session.status == SessionStatus.unauthenticated) {
+          {{#if (eq flags.routerPackage "go_router")}}
+          context.go(AppRoutes.onboarding);
+          {{else if (eq flags.routerPackage "auto_route")}}
+          context.replaceRoute(const OnboardingRoute());
+          {{else}}
+          Navigator.pushReplacementNamed(context, AppRoutes.onboarding);
+          {{/if}}
+        }
+      });
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return widget.child;
+  }
+}
+{{else}}
+class SessionListenerWrapper extends StatefulWidget {
+  final Widget child;
+  const SessionListenerWrapper({super.key, required this.child});
+
+  @override
+  State<SessionListenerWrapper> createState() => _SessionListenerWrapperState();
+}
+
+class _SessionListenerWrapperState extends State<SessionListenerWrapper> {
+  // Logic left to implement for vanilla flutter. Ideally pass SessionManager logic.
+  @override
+  Widget build(BuildContext context) {
+    return widget.child;
+  }
+}
+{{/if}}

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

@@ -0,0 +1,15 @@
+
+{{#if flags.usesScreenutil}}
+export 'screen_util_wrapper.dart';
+{{/if}}
+{{#if flags.usesSkeletonizer}}
+export 'skeleton_wrapper.dart';
+{{/if}}
+{{#if flags.supportsLocalization}}
+export 'localization_wrapper.dart';
+{{/if}}
+{{#if (or flags.isRiverpod flags.isProvider flags.isBloc flags.isGetX flags.isMobX)}}
+export 'state_wrapper.dart';
+{{/if}}
+
+export 'session_listener_wrapper.dart';

package/templates/base/lib/src/theme/app_borders.dart.hbs

@@ -0,0 +1,70 @@
+import 'package:flutter/material.dart';
+
+/// Reusable border radii and border shapes used across the app.
+///
+/// Usage:
+/// ```dart
+/// Container(decoration: BoxDecoration(borderRadius: AppBorders.md))
+/// ```
+abstract final class AppBorders {
+  AppBorders._();
+
+  // ── Border Radii ──────────────────────────────────────────────────────────
+
+  /// 4 pt — subtle rounding, used for small chips, badges.
+  static const BorderRadius xs = BorderRadius.all(Radius.circular(4));
+
+  /// 8 pt — standard rounding for buttons, text fields.
+  static const BorderRadius sm = BorderRadius.all(Radius.circular(8));
+
+  /// 12 pt — medium rounding for cards, list tiles.
+  static const BorderRadius md = BorderRadius.all(Radius.circular(12));
+
+  /// 16 pt — large rounding for modals, bottom sheets.
+  static const BorderRadius lg = BorderRadius.all(Radius.circular(16));
+
+  /// 24 pt — extra large rounding for dialogs, feature cards.
+  static const BorderRadius xl = BorderRadius.all(Radius.circular(24));
+
+  /// 28 pt — Material 3 bottom sheet top radius.
+  static const BorderRadius bottomSheet = BorderRadius.vertical(
+    top: Radius.circular(28),
+  );
+
+  /// Fully circular (pill/stadium shape).
+  static const BorderRadius full = BorderRadius.all(Radius.circular(999));
+
+  // ── Semantic aliases ──────────────────────────────────────────────────────
+
+  /// Default button border radius.
+  static const BorderRadius button = lg;
+
+  /// Default card border radius.
+  static const BorderRadius card = md;
+
+  /// Default input field border radius.
+  static const BorderRadius input = sm;
+
+  /// Default dialog border radius.
+  static const BorderRadius dialog = xl;
+
+  // ── RoundedRectangleBorder shapes (for ShapeBorder APIs) ─────────────────
+
+  /// Small rounded rectangle shape (8 pt).
+  static const RoundedRectangleBorder shapeSm = RoundedRectangleBorder(
+    borderRadius: sm,
+  );
+
+  /// Medium rounded rectangle shape (12 pt).
+  static const RoundedRectangleBorder shapeMd = RoundedRectangleBorder(
+    borderRadius: md,
+  );
+
+  /// Large rounded rectangle shape (16 pt).
+  static const RoundedRectangleBorder shapeLg = RoundedRectangleBorder(
+    borderRadius: lg,
+  );
+
+  /// Fully circular/stadium shape.
+  static const StadiumBorder stadium = StadiumBorder();
+}

package/templates/base/lib/src/theme/app_curves.dart.hbs

@@ -0,0 +1,69 @@
+import 'package:flutter/material.dart';
+
+/// Named animation curves following Material 3 motion guidelines.
+///
+/// Material 3 defines four core easing families:
+/// - **Standard** — most UI transitions
+/// - **Emphasized** — important / expressive transitions  
+/// - **Decelerate** — elements entering the screen
+/// - **Accelerate** — elements leaving the screen
+///
+/// Usage:
+/// ```dart
+/// AnimatedContainer(
+///   duration: AppDurations.normal,
+///   curve: AppCurves.standard,
+/// )
+/// ```
+abstract final class AppCurves {
+  AppCurves._();
+
+  // ── Material 3 Core Easing ────────────────────────────────────────────────
+
+  /// Standard easing — for most UI transitions (enter + exit both).
+  /// Equivalent to M3 "Standard" curve.
+  static const Curve standard = Curves.easeInOut;
+
+  /// Emphasized easing — for important, expressive transitions.
+  /// More dramatic entry, used for large elements or hero moments.
+  static const Curve emphasized = Curves.easeInOutCubicEmphasized;
+
+  /// Decelerate — for elements entering the screen (fly-in).
+  /// Starts fast, slows down to a gentle stop.
+  static const Curve decelerate = Curves.decelerate;
+
+  /// Accelerate — for elements leaving the screen (fly-out).
+  /// Starts slow, picks up speed as it exits.
+  static const Curve accelerate = Curves.easeIn;
+
+  // ── Additional utility curves ─────────────────────────────────────────────
+
+  /// Spring-like overshoot — fun, bouncy interactions (FABs, cards).
+  static const Curve spring = Curves.elasticOut;
+
+  /// Ease out back — slight overshoot then settle; good for scaling pop-ins.
+  static const Curve easeOutBack = Curves.easeOutBack;
+
+  /// Linear — only for continuous loops (loaders, shimmer).
+  static const Curve linear = Curves.linear;
+
+  /// Ease in out cubic — smooth, natural-feeling transitions.
+  static const Curve smooth = Curves.easeInOutCubic;
+
+  // ── Semantic aliases ──────────────────────────────────────────────────────
+
+  /// For page enter transitions.
+  static const Curve pageEnter = decelerate;
+
+  /// For page exit transitions.
+  static const Curve pageExit = accelerate;
+
+  /// For popups and dialogs appearing.
+  static const Curve popupOpen = emphasized;
+
+  /// For modals and sheets closing.
+  static const Curve popupClose = standard;
+
+  /// For micro-interactions (button press, toggle).
+  static const Curve microInteraction = easeOutBack;
+}

package/templates/base/lib/src/theme/app_durations.dart.hbs

@@ -0,0 +1,48 @@
+/// Named animation duration constants following Material 3 motion guidelines.
+///
+/// Usage:
+/// ```dart
+/// AnimatedContainer(duration: AppDurations.normal, curve: AppCurves.standard)
+/// ```
+abstract final class AppDurations {
+  AppDurations._();
+
+  /// 50 ms — nearly instant, icon state swaps.
+  static const Duration instant = Duration(milliseconds: 50);
+
+  /// 100 ms — very fast micro-interaction (ripple, press feedback).
+  static const Duration veryFast = Duration(milliseconds: 100);
+
+  /// 150 ms — fast transition for small, contained elements (checkboxes, chips).
+  static const Duration fast = Duration(milliseconds: 150);
+
+  /// 200 ms — quick transition, tab indicator, list item highlight.
+  static const Duration quick = Duration(milliseconds: 200);
+
+  /// 300 ms — standard transition for most UI animations.
+  /// Follows Material 3 "standard" motion duration guideline.
+  static const Duration normal = Duration(milliseconds: 300);
+
+  /// 400 ms — medium transition for page elements entering from off-screen.
+  static const Duration medium = Duration(milliseconds: 400);
+
+  /// 500 ms — slow, deliberate reveal of large surfaces (drawers, dialogs).
+  static const Duration slow = Duration(milliseconds: 500);
+
+  /// 700 ms — very slow, for complex choreographed sequences.
+  static const Duration verySlow = Duration(milliseconds: 700);
+
+  /// 1000 ms — skeleton/shimmer cycle base duration.
+  static const Duration shimmer = Duration(milliseconds: 1000);
+
+  // ── Semantic aliases ──────────────────────────────────────────────────────
+
+  /// Recommended duration for page transitions.
+  static const Duration pageTransition = medium;
+
+  /// Recommended duration for in-place widget transitions (show/hide).
+  static const Duration widgetTransition = normal;
+
+  /// Recommended duration for micro-interactions (button press, hover).
+  static const Duration microInteraction = fast;
+}

package/templates/base/lib/src/theme/app_shadows.dart.hbs

@@ -0,0 +1,73 @@
+import 'package:flutter/material.dart';
+
+/// Predefined box shadows aligned with Material 3 elevation tiers.
+///
+/// Usage:
+/// ```dart
+/// Container(
+///   decoration: BoxDecoration(
+///     boxShadow: AppShadows.card,
+///   ),
+/// )
+/// ```
+abstract final class AppShadows {
+  AppShadows._();
+
+  /// No shadow — flat, tonal surface (elevation 0).
+  static const List<BoxShadow> none = [];
+
+  /// Minimal shadow — barely lifted surfaces (elevation 1).
+  /// Use for: toggle surfaces, filled cards on white background.
+  static const List<BoxShadow> subtle = [
+    BoxShadow(
+      color: Color(0x0D000000), // 5% black
+      blurRadius: 2,
+      offset: Offset(0, 1),
+    ),
+  ];
+
+  /// Card shadow — clearly elevated content (elevation 2–3).
+  /// Use for: cards, list items that are tappable, floating elements.
+  static const List<BoxShadow> card = [
+    BoxShadow(
+      color: Color(0x14000000), // 8% black
+      blurRadius: 8,
+      offset: Offset(0, 2),
+    ),
+    BoxShadow(
+      color: Color(0x0A000000), // 4% black
+      blurRadius: 2,
+      offset: Offset(0, 1),
+    ),
+  ];
+
+  /// Elevated shadow — significantly raised surface (elevation 6–8).
+  /// Use for: FABs, dropdown menus, tooltips.
+  static const List<BoxShadow> elevated = [
+    BoxShadow(
+      color: Color(0x1F000000), // 12% black
+      blurRadius: 16,
+      offset: Offset(0, 6),
+    ),
+    BoxShadow(
+      color: Color(0x0F000000), // 6% black
+      blurRadius: 4,
+      offset: Offset(0, 2),
+    ),
+  ];
+
+  /// Modal shadow — overlay surfaces, dialogs, bottom sheets (elevation 12+).
+  /// Use for: dialogs, modals, side sheets.
+  static const List<BoxShadow> modal = [
+    BoxShadow(
+      color: Color(0x29000000), // 16% black
+      blurRadius: 32,
+      offset: Offset(0, 12),
+    ),
+    BoxShadow(
+      color: Color(0x14000000), // 8% black
+      blurRadius: 8,
+      offset: Offset(0, 4),
+    ),
+  ];
+}

package/templates/base/lib/src/theme/app_spacing.dart.hbs

@@ -0,0 +1,80 @@
+{{#if flags.usesScreenutil}}
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+{{/if}}
+
+/// Named spacing constants aligned with an 8-pt grid.
+///
+/// Usage:
+/// ```dart
+/// SizedBox(height: AppSpacing.md)        // 16 pt gap
+/// Padding(padding: EdgeInsets.all(AppSpacing.lg))
+/// ```
+abstract final class AppSpacing {
+  AppSpacing._();
+
+  static const double _xxs = 2;
+  static const double _xs = 4;
+  static const double _sm = 8;
+  static const double _ms = 12;
+  static const double _md = 16;
+  static const double _ml = 20;
+  static const double _lg = 24;
+  static const double _xl = 32;
+  static const double _xxl = 48;
+  static const double _xxxl = 64;
+
+  /// 2 pt — hairline gap, icon-to-label spacing.
+  static double get xxs => {{#if flags.usesScreenutil}}_xxs.r{{else}}_xxs{{/if}};
+
+  /// 4 pt — tightest spacing, between tightly coupled elements.
+  static double get xs => {{#if flags.usesScreenutil}}_xs.r{{else}}_xs{{/if}};
+
+  /// 8 pt — small spacing, inside compact components (chip padding, icon gap).
+  static double get sm => {{#if flags.usesScreenutil}}_sm.r{{else}}_sm{{/if}};
+
+  /// 12 pt — medium-small, inner card padding on dense layouts.
+  static double get ms => {{#if flags.usesScreenutil}}_ms.r{{else}}_ms{{/if}};
+
+  /// 16 pt — base unit, standard component padding and list item gaps.
+  static double get md => {{#if flags.usesScreenutil}}_md.r{{else}}_md{{/if}};
+
+  /// 20 pt — medium-large, comfortable section spacing.
+  static double get ml => {{#if flags.usesScreenutil}}_ml.r{{else}}_ml{{/if}};
+
+  /// 24 pt — large, between content sections on a page.
+  static double get lg => {{#if flags.usesScreenutil}}_lg.r{{else}}_lg{{/if}};
+
+  /// 32 pt — extra large, major section breaks or hero padding.
+  static double get xl => {{#if flags.usesScreenutil}}_xl.r{{else}}_xl{{/if}};
+
+  /// 48 pt — 2× large, top-of-page safe area offsets, empty state padding.
+  static double get xxl => {{#if flags.usesScreenutil}}_xxl.r{{else}}_xxl{{/if}};
+
+  /// 64 pt — maximum, full-bleed header heights.
+  static double get xxxl => {{#if flags.usesScreenutil}}_xxxl.r{{else}}_xxxl{{/if}};
+
+  // ── Semantic aliases ──────────────────────────────────────────────────────
+
+  /// Standard horizontal page margin.
+  static double get pagePadding => md;
+
+  /// Gap between list/grid items.
+  static double get itemGap => sm;
+
+  /// Inner padding for cards.
+  static double get cardPadding => md;
+
+  /// Vertical gap between form fields.
+  static double get formFieldGap => ms;
+}
+
+{{#unless flags.usesScreenutil}}
+/// Extension to provide identity scaling when ScreenUtil is disabled.
+/// This allows using .h, .w, .sp, .r on numbers without conditional checks.
+extension ResponsiveNumberExtension on num {
+  double get h => toDouble();
+  double get w => toDouble();
+  double get sp => toDouble();
+  double get r => toDouble();
+}
+{{/unless}}