create-flutterinit 0.1.0

package/templates/base/lib/src/extensions/context_extension.dart.hbs

@@ -0,0 +1,167 @@
+import 'package:flutter/material.dart';
+{{#if (eq flags.routerPackage "go_router")}}
+import 'package:go_router/go_router.dart';
+{{/if}}
+
+import '../theme/color_schemes.dart';
+import '../theme/theme.dart';
+import '../shared/enums/snack_bar_type.dart';
+
+extension ContextExtension on BuildContext {
+  // ── Theme shortcuts ──────────────────────────────────────────────────────
+  ThemeData get theme => Theme.of(this);
+  TextTheme get typography => theme.textTheme;
+  TextTheme get textTheme => theme.textTheme;
+  ColorScheme get colors => theme.colorScheme;
+  bool get isDarkMode => theme.brightness == Brightness.dark;
+
+  /// Semantic/custom colors (success, warning, info).
+  AppColorsExtension get appColors =>
+      theme.extension<AppColorsExtension>() ?? (isDarkMode ? AppPalettes.dark : AppPalettes.light);
+
+  /// Design tokens (spacing, border radii, elevation defaults).
+  AppDesignTokens get designTokens =>
+      theme.extension<AppDesignTokens>() ?? AppDesignTokens.fallback;
+
+  // ── MediaQuery shortcuts ─────────────────────────────────────────────────
+  Size get mediaQuerySize => MediaQuery.sizeOf(this);
+  Size get screenSize => mediaQuerySize;
+  double get width => mediaQuerySize.width;
+  double get height => mediaQuerySize.height;
+
+  /// Safe-area insets for the current view.
+  EdgeInsets get safeArea => MediaQuery.paddingOf(this);
+
+  // ── Keyboard ──────────────────────────────────────────────────────────────
+  bool get isKeyboardVisible => MediaQuery.viewInsetsOf(this).bottom > 0;
+  void hideKeyboard() => FocusScope.of(this).unfocus();
+
+  // ── Platform ─────────────────────────────────────────────────────────────
+  bool get isIOS => theme.platform == TargetPlatform.iOS;
+  bool get isAndroid => theme.platform == TargetPlatform.android;
+
+  // ── Overlays ─────────────────────────────────────────────────────────────
+  void showSnackBar(
+    String message, {
+    SnackBarAction? action,
+    Duration duration = const Duration(seconds: 3),
+  }) {
+    ScaffoldMessenger.of(this)
+      ..clearSnackBars()
+      ..showSnackBar(
+        SnackBar(
+          content: Text(message),
+          action: action,
+          duration: duration,
+        ),
+      );
+  }
+
+  void showSuccessSnackBar(String message) {
+    ScaffoldMessenger.of(this)
+      ..clearSnackBars()
+      ..showSnackBar(
+        SnackBar(
+          content: Text(message),
+          backgroundColor: appColors.success,
+        ),
+      );
+  }
+
+  void showErrorSnackBar(String message) {
+    ScaffoldMessenger.of(this)
+      ..clearSnackBars()
+      ..showSnackBar(
+        SnackBar(
+          content: Text(message),
+          backgroundColor: colors.error,
+        ),
+      );
+  }
+
+  Future<T?> showAppBottomSheet<T>({
+    required WidgetBuilder builder,
+    bool isScrollControlled = true,
+    bool useSafeArea = true,
+  }) {
+    return showModalBottomSheet<T>(
+      context: this,
+      builder: builder,
+      isScrollControlled: isScrollControlled,
+      useSafeArea: useSafeArea,
+    );
+  }
+
+  Future<T?> showAppDialog<T>({required WidgetBuilder builder}) {
+    return showDialog<T>(
+      context: this,
+      builder: builder,
+    );
+  }
+
+  /// Shows a snackbar with a colour driven by [SnackBarType].
+  ///
+  /// ```dart
+  /// context.showTypedSnackBar('Saved!', type: SnackBarType.success);
+  /// ```
+  void showTypedSnackBar(
+    String message, {
+    SnackBarType type = SnackBarType.info,
+    Duration duration = const Duration(seconds: 3),
+  }) {
+    final bg = switch (type) {
+      SnackBarType.success => appColors.success,
+      SnackBarType.warning => appColors.warning,
+      SnackBarType.error   => colors.error,
+      SnackBarType.info    => colors.inverseSurface,
+    };
+    ScaffoldMessenger.of(this)
+      ..clearSnackBars()
+      ..showSnackBar(
+        SnackBar(
+          content: Text(message),
+          backgroundColor: bg,
+          duration: duration,
+        ),
+      );
+  }
+
+  // ── Routing shortcuts ────────────────────────────────────────────────────
+  {{#if (eq flags.routerPackage "go_router")}}
+  String get currentRoute {
+    final router = GoRouter.of(this);
+    final RouteMatch lastMatch = router.routerDelegate.currentConfiguration.last;
+    final RouteMatchList matchList = lastMatch is ImperativeRouteMatch
+        ? lastMatch.matches
+        : router.routerDelegate.currentConfiguration;
+    return matchList.uri.toString();
+  }
+  {{/if}}
+
+  {{#unless flags.routerPackage}}
+  void pop<T extends Object?>([T? result]) => Navigator.of(this).pop<T>(result);
+
+  Future<T?> push<T extends Object?>(Route<T> route) {
+    return Navigator.of(this).push<T>(route);
+  }
+
+  Future<T?> pushNamed<T extends Object?>(
+    String routeName, {
+    Object? arguments,
+  }) {
+    return Navigator.of(this).pushNamed<T>(routeName, arguments: arguments);
+  }
+
+  Future<T?> pushReplacementNamed<T extends Object?, TO extends Object?>(
+    String routeName, {
+    TO? result,
+    Object? arguments,
+  }) {
+    return Navigator.of(this).pushReplacementNamed<T, TO>(
+      routeName,
+      result: result,
+      arguments: arguments,
+    );
+  }
+  {{/unless}}
+}

package/templates/base/lib/src/extensions/date_time_extension.dart.hbs

@@ -0,0 +1,40 @@
+extension DateTimeExtension on DateTime {
+  bool get isToday {
+    final now = DateTime.now();
+    return year == now.year && month == now.month && day == now.day;
+  }
+
+  bool get isYesterday {
+    final yesterday = DateTime.now().subtract(const Duration(days: 1));
+    return year == yesterday.year && month == yesterday.month && day == yesterday.day;
+  }
+
+  bool isSameDay(DateTime other) {
+    return year == other.year && month == other.month && day == other.day;
+  }
+
+  String get toIso8601DateOnly {
+    return '${year.toString().padLeft(4, '0')}-${month.toString().padLeft(2, '0')}-${day.toString().padLeft(2, '0')}';
+  }
+
+  String timeAgo() {
+    final now = DateTime.now();
+    final difference = now.difference(this);
+
+    if (difference.inDays > 365) {
+      return '${(difference.inDays / 365).floor()} years ago';
+    } else if (difference.inDays > 30) {
+      return '${(difference.inDays / 30).floor()} months ago';
+    } else if (difference.inDays > 7) {
+      return '${(difference.inDays / 7).floor()} weeks ago';
+    } else if (difference.inDays >= 1) {
+      return '${difference.inDays} days ago';
+    } else if (difference.inHours >= 1) {
+      return '${difference.inHours} hours ago';
+    } else if (difference.inMinutes >= 1) {
+      return '${difference.inMinutes} minutes ago';
+    } else {
+      return 'just now';
+    }
+  }
+}

package/templates/base/lib/src/extensions/extensions.dart.hbs

@@ -0,0 +1,6 @@
+export 'collection_extension.dart';
+export 'context_extension.dart';
+export 'date_time_extension.dart';
+export 'num_extension.dart';
+export 'string_extension.dart';
+export 'widget_extension.dart';

package/templates/base/lib/src/extensions/num_extension.dart.hbs

@@ -0,0 +1,14 @@
+import 'package:flutter/material.dart';
+
+extension NumExtension on num {
+  // SizedBox generators
+  Widget get kH => SizedBox(height: toDouble());
+  Widget get kW => SizedBox(width: toDouble());
+
+  // BorderRadius helpers
+  BorderRadius get radius => BorderRadius.circular(toDouble());
+
+  // Duration helpers
+  Duration get ms => Duration(milliseconds: toInt());
+  Duration get seconds => Duration(seconds: toInt());
+}

package/templates/base/lib/src/extensions/string_extension.dart.hbs

@@ -0,0 +1,91 @@
+extension StringExtension on String {
+  // Validators
+  bool get isValidEmail {
+    return RegExp(
+      r"^[a-zA-Z0-9.a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9]+\.[a-zA-Z]+",
+    ).hasMatch(this);
+  }
+
+  bool get isValidPhoneNumber {
+    if (length > 16 || length < 9) return false;
+    return RegExp(r'^[+]*[(]{0,1}[0-9]{1,4}[)]{0,1}[-\s\./0-9]*$').hasMatch(this);
+  }
+
+  bool get isValidUrl {
+    return RegExp(
+      r"^((((H|h)(T|t)|(F|f))(T|t)(P|p)((S|s)?))\://)?(www.|[a-zA-Z0-9].)[a-zA-Z0-9\-\.]+\.[a-zA-Z]{2,6}(\:[0-9]{1,5})*(/($|[a-zA-Z0-9\.\,\;\?\'\\\+&amp;%\$#\=~_\-]+))*$",
+    ).hasMatch(this);
+  }
+
+  // Formatters
+  String get capitalizeFirst {
+    if (isEmpty) return this;
+    return this[0].toUpperCase() + substring(1).toLowerCase();
+  }
+
+  String get toTitleCase {
+    if (isEmpty) return this;
+    return split(' ').map((str) => str.capitalizeFirst).join(' ');
+  }
+
+  String toK() {
+    final value = double.tryParse(this);
+    if (value == null) return this;
+    if (value >= 1000000) {
+      return '${(value / 1000000).toStringAsFixed(value % 1000000 == 0 ? 0 : 1)}M';
+    } else if (value >= 1000) {
+      return '${(value / 1000).toStringAsFixed(value % 1000 == 0 ? 0 : 1)}k';
+    }
+    return this;
+  }
+
+  // Safe Parsers
+  int? get toIntOrNull => int.tryParse(this);
+  double? get toDoubleOrNull => double.tryParse(this);
+
+  // Localization markers
+  String get hardcoded => this;
+
+  // Aliases for validation
+  bool get isPhoneNumber => isValidPhoneNumber;
+  bool get isURL => isValidUrl;
+  bool get isEmail => isValidEmail;
+
+  // Privacy helpers
+  String get maskEmail {
+    if (!isEmail) return this;
+    final parts = split('@');
+    final name = parts[0];
+    final domain = parts[1];
+    if (name.length <= 2) return this;
+    return '${name.substring(0, 2)}****@$domain';
+  }
+
+  String maskCenter([int visibleChars = 4]) {
+    if (length <= visibleChars) return this;
+    final maskedLength = length - visibleChars;
+    final start = (length - maskedLength) ~/ 2;
+    return replaceRange(start, start + maskedLength, '*' * maskedLength);
+  }
+
+  // UI Helpers
+  /// Converts hex string to Color object
+  /// Supports: #RRGGBB, RRGGBB, #AARRGGBB, AARRGGBB
+  dynamic toColor() {
+    // Note: dynamic return to avoid importing Material in this logic-only file
+    // The user can cast it to Color or we can import material here
+    var hexColor = replaceAll('#', '');
+    if (hexColor.length == 6) {
+      hexColor = 'FF$hexColor';
+    }
+    if (hexColor.length == 8) {
+      return int.parse('0x$hexColor');
+    }
+    return null;
+  }
+}
+
+extension StringOptionalExtension on String? {
+  bool get isNullOrEmpty => this == null || this!.trim().isEmpty;
+  bool get isNotNullOrEmpty => !isNullOrEmpty;
+}

package/templates/base/lib/src/extensions/widget_extension.dart.hbs

@@ -0,0 +1,47 @@
+import '../imports/imports.dart';
+
+extension WidgetExtension on Widget {
+  /// Wrap the widget with Padding
+  Widget paddingAll(double value) => Padding(
+        padding: EdgeInsets.all(value),
+        child: this,
+      );
+
+  Widget paddingSymmetric({double horizontal = 0, double vertical = 0}) => Padding(
+        padding: EdgeInsets.symmetric(horizontal: horizontal, vertical: vertical),
+        child: this,
+      );
+
+  Widget paddingOnly({
+    double left = 0,
+    double top = 0,
+    double right = 0,
+    double bottom = 0,
+  }) =>
+      Padding(
+        padding: EdgeInsets.only(left: left, top: top, right: right, bottom: bottom),
+        child: this,
+      );
+
+  /// Wrap the widget with Opacity
+  Widget opacity(double value) => Opacity(opacity: value, child: this);
+
+  /// Wrap the widget with Visibility
+  Widget visible(bool visible, {Widget fallback = const SizedBox.shrink()}) =>
+      visible ? this : fallback;
+
+  /// Wrap the widget with Center
+  Widget get center => Center(child: this);
+
+  /// Wrap the widget with Expanded
+  Widget get expanded => Expanded(child: this);
+
+  /// Wrap the widget with FittedBox
+  Widget get fitted => FittedBox(child: this);
+
+  /// Wrap the widget with Hero
+  Widget hero(Object tag) => Hero(tag: tag, child: this);
+
+  /// Wrap the widget with InkWell
+  Widget tooltip(String message) => Tooltip(message: message, child: this);
+}

package/templates/base/lib/src/imports/core_imports.dart.hbs

@@ -0,0 +1,50 @@
+// Flutter SDK
+export 'package:flutter/material.dart';
+export 'package:flutter/cupertino.dart' hide RefreshCallback;
+export 'package:flutter/foundation.dart';
+export 'package:flutter/services.dart';
+{{#if flags.usesFlutterNativeSplash}}
+export 'package:flutter_native_splash/flutter_native_splash.dart';
+{{/if}}
+
+{{#if flags.supportsLocalization}}
+export 'package:easy_localization/easy_localization.dart' hide TextDirection, MapExtension;
+{{/if}}
+
+// Project Core — everything exported through shared.dart (theme, extensions,
+// utils, widgets, enums) plus routing and services.
+export '../config/app_config.dart';
+export '../routing/app_router.dart';
+export '../routing/app_routes.dart';
+export '../routing/global_navigator.dart';
+{{#if flags.isGetX}}
+export '../routing/app_bindings.dart';
+{{/if}}
+export '../services/services.dart';
+export '../shared/shared.dart';
+
+{{#if (eq architecture "layer-first")}}
+export '../presentation/screens/auth/login_screen.dart';
+export '../presentation/screens/auth/signup_screen.dart';
+export '../presentation/screens/auth/forgot_password_screen.dart';
+export '../presentation/screens/home/home_page.dart';
+export '../presentation/screens/onboarding/onboarding_page.dart';
+{{else if (eq architecture "mvc")}}
+export '../views/auth/login_screen.dart';
+export '../views/auth/signup_screen.dart';
+export '../views/auth/forgot_password_screen.dart';
+export '../views/home/home_page.dart';
+export '../views/onboarding/onboarding_page.dart';
+{{else if (eq architecture "mvvm")}}
+export '../ui/auth/login_screen.dart';
+export '../ui/auth/signup_screen.dart';
+export '../ui/auth/forgot_password_screen.dart';
+export '../ui/home/home_page.dart';
+export '../ui/onboarding/onboarding_page.dart';
+{{else}}
+export '../features/auth/presentation/screens/login_screen.dart';
+export '../features/auth/presentation/screens/signup_screen.dart';
+export '../features/auth/presentation/screens/forgot_password_screen.dart';
+export '../features/home/presentation/screens/home_page.dart';
+export '../features/onboarding/presentation/screens/onboarding_page.dart';
+{{/if}}

package/templates/base/lib/src/imports/imports.dart.hbs

@@ -0,0 +1,2 @@
+export 'core_imports.dart';
+export 'packages_imports.dart';

package/templates/base/lib/src/imports/packages_imports.dart.hbs

@@ -0,0 +1,110 @@
+export 'package:fpdart/fpdart.dart' hide State;
+export 'package:internet_connection_checker_plus/internet_connection_checker_plus.dart';
+{{#if flags.usesScreenutil}}
+export 'package:flutter_screenutil/flutter_screenutil.dart';
+{{/if}}
+{{#if flags.usesFlutterHooks}}
+export 'package:flutter_hooks/flutter_hooks.dart';
+{{/if}}
+export 'package:equatable/equatable.dart';
+{{#if flags.isRiverpod}}
+export 'package:flutter_riverpod/flutter_riverpod.dart';
+export 'package:flutter_riverpod/legacy.dart';
+{{#if flags.usesFlutterHooks}}
+export 'package:hooks_riverpod/hooks_riverpod.dart';
+export 'package:hooks_riverpod/legacy.dart';
+{{/if}}
+{{/if}}
+{{#if (or flags.isProvider flags.isMobX)}}
+export 'package:provider/provider.dart' hide Dispose;
+{{/if}}
+{{#if flags.isBloc}}
+export 'package:flutter_bloc/flutter_bloc.dart';
+{{/if}}
+{{#if (or flags.isGetX (eq flags.routerPackage "getx"))}}
+// For Navigation
+export 'package:get/get_navigation/get_navigation.dart' hide GetContextExtensions;
+// For State Management (.obs, GetxController, Obx)
+{{#if flags.isGetX}}
+export 'package:get/get_state_manager/get_state_manager.dart';
+// For Dependency Management (Get.put, Get.find)
+export 'package:get/get_instance/get_instance.dart';
+{{/if}}
+{{/if}}
+{{#if flags.isMobX}}
+export 'package:mobx/mobx.dart' hide version, StringExtension, Action, Listener, Listenable, Interceptor, Interceptors;
+export 'package:flutter_mobx/flutter_mobx.dart' hide version;
+{{/if}}
+{{#if (eq flags.routerPackage "go_router")}}
+export 'package:{{flags.routerPackage}}/{{flags.routerPackage}}.dart';
+{{else if (eq flags.routerPackage "auto_route")}}
+export 'package:auto_route/auto_route.dart' hide kCupertinoModalBarrierColor, CupertinoPageTransition, CupertinoFullscreenDialogTransition;
+{{/if}}
+{{#if flags.usesDio}}
+export 'package:dio/dio.dart';
+{{/if}}
+{{#if flags.usesHttp}}
+export 'package:http/http.dart'{{#if flags.usesDio}} hide MultipartFile, Response{{/if}};
+{{/if}}
+{{#if flags.usesCachedNetworkImage}}
+export 'package:cached_network_image/cached_network_image.dart';
+{{/if}}
+{{#if flags.usesFlutterSvg}}
+export 'package:flutter_svg/flutter_svg.dart';
+{{/if}}
+{{#if flags.usesIconsaxPlus}}
+export 'package:iconsax_plus/iconsax_plus.dart';
+{{/if}}
+{{#if flags.usesFlutterRemix}}
+export 'package:flutter_remix/flutter_remix.dart';
+{{/if}}
+{{#if flags.usesHugeicons}}
+export 'package:hugeicons/hugeicons.dart';
+{{/if}}
+{{#if flags.usesSkeletonizer}}
+export 'package:skeletonizer/skeletonizer.dart';
+{{/if}}
+export 'package:flutter_animate/flutter_animate.dart' hide ShimmerEffect;
+export 'package:smooth_page_indicator/smooth_page_indicator.dart' hide ScaleEffect, SlideEffect, SwapEffect;
+export 'package:flutter_dotenv/flutter_dotenv.dart';
+{{#if flags.usesHive}}
+export 'package:hive_ce_flutter/hive_ce_flutter.dart';
+{{/if}}
+{{#if flags.usesSharedPreferences}}
+export 'package:shared_preferences/shared_preferences.dart';
+{{/if}}
+{{#if flags.usesSecureStorage}}
+export 'package:flutter_secure_storage/flutter_secure_storage.dart';
+{{/if}}
+{{#if flags.usesLogger}}
+export 'package:logger/logger.dart';
+{{/if}}
+{{#if flags.usesImagePicker}}
+export 'package:image_picker/image_picker.dart';
+{{/if}}
+{{#if flags.usesFilePicker}}
+export 'package:file_picker/file_picker.dart';
+{{/if}}
+{{#if flags.usesPathProvider}}
+export 'package:path_provider/path_provider.dart';
+{{/if}}
+{{#if flags.usesUrlLauncher}}
+export 'package:url_launcher/url_launcher.dart';
+{{/if}}
+{{#if flags.usesSharePlus}}
+export 'package:share_plus/share_plus.dart';
+{{/if}}
+{{#if flags.usesPermissionHandler}}
+export 'package:permission_handler/permission_handler.dart';
+{{/if}}
+{{#if flags.usesGeolocator}}
+export 'package:geolocator/geolocator.dart' hide ServiceStatus;
+{{/if}}
+{{#if flags.usesDeviceInfoPlus}}
+export 'package:device_info_plus/device_info_plus.dart';
+{{/if}}
+{{#if flags.usesAppVersionUpdate}}
+export 'package:app_version_update/app_version_update.dart';
+{{/if}}
+
+

package/templates/base/lib/src/routing/(isGetX)@app_bindings.dart.hbs

@@ -0,0 +1,23 @@
+import 'package:get/get.dart';
+import 'package:{{flags.appSnake}}/src/{{#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';
+
+{{#if (eq architecture "layer-first")}}
+import 'package:{{flags.appSnake}}/src/presentation/controllers/auth/auth_controller.dart';
+{{else if (eq architecture "mvc")}}
+import 'package:{{flags.appSnake}}/src/controllers/auth/auth_controller.dart';
+{{else if (eq architecture "mvvm")}}
+import 'package:{{flags.appSnake}}/src/ui/auth/controllers/auth_controller.dart';
+{{else}}
+import 'package:{{flags.appSnake}}/src/features/auth/presentation/controllers/auth_controller.dart';
+{{/if}}
+
+class AppBindings implements Bindings {
+  @override
+  void dependencies() {
+    {{#if flags.isGetX}}
+    Get.lazyPut<AuthController>(
+      () => AuthController(repository: AuthRepositoryImpl()),
+    );
+    {{/if}}
+  }
+}