create-flutterinit 0.1.0

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

@@ -0,0 +1,431 @@
+import 'package:flutter/material.dart';
+import 'package:flutter/cupertino.dart';
+
+import 'text_theme.dart';
+import 'color_schemes.dart';
+
+Color _colorFromHex(String hex) {
+  final cleaned = hex.replaceFirst('#', '');
+  return Color(int.parse('ff$cleaned', radix: 16));
+}
+
+/// Custom theme extension for spacing and other design tokens
+class AppDesignTokens extends ThemeExtension<AppDesignTokens> {
+  const AppDesignTokens({
+    required this.paddingSmall,
+    required this.paddingMedium,
+    required this.paddingLarge,
+    required this.borderRadiusSmall,
+    required this.borderRadiusMedium,
+    required this.borderRadiusLarge,
+    required this.cardElevation,
+  });
+
+  final double paddingSmall;
+  final double paddingMedium;
+  final double paddingLarge;
+  final double borderRadiusSmall;
+  final double borderRadiusMedium;
+  final double borderRadiusLarge;
+  final double cardElevation;
+
+  static const fallback = AppDesignTokens(
+    paddingSmall: 8,
+    paddingMedium: 16,
+    paddingLarge: 24,
+    borderRadiusSmall: 4,
+    borderRadiusMedium: 12,
+    borderRadiusLarge: 24,
+    cardElevation: 0,
+  );
+
+  @override
+  ThemeExtension<AppDesignTokens> copyWith({
+    double? paddingSmall,
+    double? paddingMedium,
+    double? paddingLarge,
+    double? borderRadiusSmall,
+    double? borderRadiusMedium,
+    double? borderRadiusLarge,
+    double? cardElevation,
+  }) {
+    return AppDesignTokens(
+      paddingSmall: paddingSmall ?? this.paddingSmall,
+      paddingMedium: paddingMedium ?? this.paddingMedium,
+      paddingLarge: paddingLarge ?? this.paddingLarge,
+      borderRadiusSmall: borderRadiusSmall ?? this.borderRadiusSmall,
+      borderRadiusMedium: borderRadiusMedium ?? this.borderRadiusMedium,
+      borderRadiusLarge: borderRadiusLarge ?? this.borderRadiusLarge,
+      cardElevation: cardElevation ?? this.cardElevation,
+    );
+  }
+
+  @override
+  ThemeExtension<AppDesignTokens> lerp(
+    covariant ThemeExtension<AppDesignTokens>? other,
+    double t,
+  ) {
+    if (other is! AppDesignTokens) return this;
+    return AppDesignTokens(
+      paddingSmall: lerpDouble(paddingSmall, other.paddingSmall, t)!,
+      paddingMedium: lerpDouble(paddingMedium, other.paddingMedium, t)!,
+      paddingLarge: lerpDouble(paddingLarge, other.paddingLarge, t)!,
+      borderRadiusSmall: lerpDouble(borderRadiusSmall, other.borderRadiusSmall, t)!,
+      borderRadiusMedium: lerpDouble(borderRadiusMedium, other.borderRadiusMedium, t)!,
+      borderRadiusLarge: lerpDouble(borderRadiusLarge, other.borderRadiusLarge, t)!,
+      cardElevation: lerpDouble(cardElevation, other.cardElevation, t)!,
+    );
+  }
+
+  static double? lerpDouble(double? a, double? b, double t) {
+    if (a == null && b == null) return null;
+    a ??= 0.0;
+    b ??= 0.0;
+    return a + (b - a) * t;
+  }
+}
+
+ThemeData _buildTheme(ColorScheme colorScheme, AppColorsExtension customColors) {
+  final textTheme = buildTextTheme();
+  
+  return ThemeData(
+    useMaterial3: true,
+    primaryColor: colorScheme.primary,
+    colorScheme: colorScheme,
+    textTheme: textTheme,
+    {{#if flags.hasCustomFonts}}
+    fontFamily: '{{flags.primaryFontFamily}}',
+    {{/if}}
+    extensions: [
+      customColors,
+      AppDesignTokens.fallback,
+    ],
+    
+    // --- Basic Elements ---
+    scaffoldBackgroundColor: colorScheme.surface,
+    dividerTheme: DividerThemeData(
+      color: colorScheme.outlineVariant,
+      thickness: 1,
+      space: 1,
+    ),
+    iconTheme: IconThemeData(
+      color: colorScheme.onSurface,
+      size: 24,
+    ),
+    
+    // --- Widget Themes ---
+
+    // App Bar Theme
+    appBarTheme: AppBarTheme(
+      backgroundColor: colorScheme.surface,
+      foregroundColor: colorScheme.onSurface,
+      elevation: 0,
+      centerTitle: true,
+      titleTextStyle: textTheme.titleMedium?.copyWith(
+        fontWeight: FontWeight.w600,
+        color: colorScheme.onSurface,
+      ),
+    ),
+
+    // Button Themes
+    elevatedButtonTheme: ElevatedButtonThemeData(
+      style: ElevatedButton.styleFrom(
+        backgroundColor: colorScheme.primary,
+        foregroundColor: colorScheme.onPrimary,
+        minimumSize: const Size(88, 48),
+        padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 12),
+        shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(12)),
+        elevation: 0,
+      ).copyWith(
+        elevation: WidgetStateProperty.resolveWith((states) {
+          if (states.contains(WidgetState.hovered)) return 2;
+          return 0;
+        }),
+      ),
+    ),
+
+    filledButtonTheme: FilledButtonThemeData(
+      style: FilledButton.styleFrom(
+        minimumSize: const Size(88, 48),
+        padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 12),
+        shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(12)),
+      ),
+    ),
+
+    outlinedButtonTheme: OutlinedButtonThemeData(
+      style: OutlinedButton.styleFrom(
+        minimumSize: const Size(88, 48),
+        padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 12),
+        shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(12)),
+        side: BorderSide(color: colorScheme.outline, width: 1.5),
+      ),
+    ),
+
+    textButtonTheme: TextButtonThemeData(
+      style: TextButton.styleFrom(
+        minimumSize: const Size(88, 40),
+        shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(8)),
+      ),
+    ),
+
+    // Card Theme
+    cardTheme: CardThemeData(
+      clipBehavior: Clip.antiAlias,
+      elevation: AppDesignTokens.fallback.cardElevation,
+      margin: EdgeInsets.zero,
+      shape: RoundedRectangleBorder(
+        side: BorderSide(color: colorScheme.outlineVariant, width: 1),
+        borderRadius: BorderRadius.circular(16),
+      ),
+      color: colorScheme.surfaceContainerLow,
+    ),
+
+    // Input Decoration Theme
+    inputDecorationTheme: InputDecorationTheme(
+      filled: true,
+      fillColor: colorScheme.surfaceContainerHighest.withValues(alpha: 0.5),
+      border: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(12),
+        
+        borderSide: BorderSide(color: colorScheme.outline),
+      ),
+      enabledBorder: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(12),
+        borderSide: BorderSide(color: colorScheme.outline),
+      ),
+      focusedBorder: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(12),
+        borderSide: BorderSide(color: colorScheme.primary, width: 2),
+      ),
+      errorBorder: OutlineInputBorder(
+        borderRadius: BorderRadius.circular(12),
+        borderSide: BorderSide(color: colorScheme.error),
+      ),
+      floatingLabelStyle: TextStyle(color: colorScheme.primary),
+      labelStyle: textTheme.labelMedium?.copyWith(color: colorScheme.onSurfaceVariant.withValues(alpha: 0.5)),
+      hintStyle: textTheme.labelMedium?.copyWith(color: colorScheme.onSurfaceVariant.withValues(alpha: 0.5)),
+    ),
+
+    // Navigation Bar Theme
+    navigationBarTheme: NavigationBarThemeData(
+      backgroundColor: colorScheme.surface,
+      indicatorColor: colorScheme.secondaryContainer,
+      elevation: 8,
+      labelBehavior: NavigationDestinationLabelBehavior.alwaysShow,
+      height: 80,
+      labelTextStyle: WidgetStateProperty.resolveWith((states) {
+        if (states.contains(WidgetState.selected)) {
+          return textTheme.labelSmall?.copyWith(color: colorScheme.primary, fontWeight: FontWeight.bold);
+        }
+        return textTheme.labelSmall?.copyWith(color: colorScheme.onSurfaceVariant);
+      }),
+    ),
+
+    // Navigation Rail Theme
+    navigationRailTheme: NavigationRailThemeData(
+      backgroundColor: colorScheme.surface,
+      indicatorColor: colorScheme.secondaryContainer,
+      labelType: NavigationRailLabelType.all,
+      unselectedLabelTextStyle: textTheme.labelSmall?.copyWith(color: colorScheme.onSurfaceVariant),
+      selectedLabelTextStyle: textTheme.labelSmall?.copyWith(color: colorScheme.primary, fontWeight: FontWeight.bold),
+    ),
+
+    // Tab Bar Theme
+    tabBarTheme: TabBarThemeData(
+      labelColor: colorScheme.primary,
+      unselectedLabelColor: colorScheme.onSurfaceVariant,
+      indicatorColor: colorScheme.primary,
+      indicatorSize: TabBarIndicatorSize.label,
+      labelStyle: textTheme.titleSmall?.copyWith(fontWeight: FontWeight.bold),
+      unselectedLabelStyle: textTheme.titleSmall,
+    ),
+
+    // Floating Action Button Theme
+    floatingActionButtonTheme: FloatingActionButtonThemeData(
+      backgroundColor: colorScheme.primary,
+      foregroundColor: colorScheme.onPrimaryContainer,
+      elevation: 2,
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(16)),
+    ),
+
+    // Chip Theme
+    chipTheme: ChipThemeData(
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(8)),
+      side: BorderSide(color: colorScheme.outlineVariant),
+      backgroundColor: colorScheme.surfaceContainerLow,
+      padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
+      labelStyle: textTheme.labelMedium,
+    ),
+
+    // List Tile Theme
+    listTileTheme: ListTileThemeData(
+      contentPadding: const EdgeInsets.symmetric(horizontal: 16, vertical: 4),
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(12)),
+      visualDensity: VisualDensity.comfortable,
+      titleTextStyle: textTheme.titleMedium?.copyWith(fontWeight: FontWeight.w600),
+      subtitleTextStyle: textTheme.bodyMedium?.copyWith(color: colorScheme.onSurfaceVariant),
+    ),
+
+    // Checkbox Theme
+    checkboxTheme: CheckboxThemeData(
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(6)),
+    ),
+
+    // Switch Theme
+    switchTheme: SwitchThemeData(
+      thumbColor: WidgetStateProperty.resolveWith((states) {
+        if (states.contains(WidgetState.selected)) return colorScheme.primary;
+        return colorScheme.outline;
+      }),
+      trackColor: WidgetStateProperty.resolveWith((states) {
+        if (states.contains(WidgetState.selected)) return colorScheme.primaryContainer;
+        return colorScheme.surfaceContainerHighest;
+      }),
+    ),
+
+    // SnackBar Theme
+    snackBarTheme: SnackBarThemeData(
+      behavior: SnackBarBehavior.floating,
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(12)),
+      elevation: 4,
+      backgroundColor: colorScheme.inverseSurface,
+      contentTextStyle: textTheme.bodyMedium?.copyWith(color: colorScheme.onInverseSurface),
+    ),
+
+    // Dialog Theme
+    dialogTheme: DialogThemeData(
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(24)),
+      elevation: 0,
+      backgroundColor: colorScheme.surface,
+      titleTextStyle: textTheme.titleLarge?.copyWith(fontWeight: FontWeight.bold),
+      contentTextStyle: textTheme.bodyMedium,
+    ),
+
+    // Bottom Sheet Theme
+    bottomSheetTheme: const BottomSheetThemeData(
+      showDragHandle: true,
+      elevation: 0,
+      shape: RoundedRectangleBorder(
+        borderRadius: BorderRadius.vertical(
+          top: Radius.circular(28),
+        ),
+      ),
+    ),
+
+    // Search Bar Theme
+    searchBarTheme: SearchBarThemeData(
+      elevation: WidgetStateProperty.all(0),
+      backgroundColor: WidgetStateProperty.all(colorScheme.surfaceContainerLow),
+      shape: WidgetStateProperty.all(RoundedRectangleBorder(borderRadius: BorderRadius.circular(28))),
+      padding: WidgetStateProperty.all(const EdgeInsets.symmetric(horizontal: 16)),
+      hintStyle: WidgetStateProperty.all(textTheme.bodyLarge?.copyWith(color: colorScheme.onSurfaceVariant)),
+    ),
+
+    // Badge Theme
+    badgeTheme: BadgeThemeData(
+      backgroundColor: colorScheme.error,
+      textColor: colorScheme.onError,
+      textStyle: textTheme.labelSmall?.copyWith(fontWeight: FontWeight.bold),
+    ),
+
+    // Segmented Button Theme
+    segmentedButtonTheme: SegmentedButtonThemeData(
+      style: SegmentedButton.styleFrom(
+        selectedBackgroundColor: colorScheme.secondaryContainer,
+        selectedForegroundColor: colorScheme.onSecondaryContainer,
+        side: BorderSide(color: colorScheme.outline),
+      ),
+    ),
+
+    // Tooltip Theme
+    tooltipTheme: TooltipThemeData(
+      decoration: BoxDecoration(
+        color: colorScheme.inverseSurface.withValues(alpha: 0.9),
+        borderRadius: BorderRadius.circular(8),
+      ),
+      textStyle: textTheme.labelSmall?.copyWith(color: colorScheme.onInverseSurface),
+    ),
+  );
+}
+
+ThemeData buildLightTheme({required String primaryColorHex}) {
+  final seed = _colorFromHex(primaryColorHex.isNotEmpty ? primaryColorHex : '#6750A4');
+  final colorScheme = ColorScheme.fromSeed(
+    seedColor: seed,
+    brightness: Brightness.light,
+  );
+  return _buildTheme(colorScheme, AppPalettes.light);
+}
+
+ThemeData buildDarkTheme({required String primaryColorHex}) {
+  final seed = _colorFromHex(primaryColorHex.isNotEmpty ? primaryColorHex : '#6750A4');
+  final colorScheme = ColorScheme.fromSeed(
+    seedColor: seed,
+    brightness: Brightness.dark,
+  );
+  return _buildTheme(colorScheme, AppPalettes.dark);
+}
+
+CupertinoThemeData buildCupertinoTheme({required String primaryColorHex}) {
+  final seed = _colorFromHex(primaryColorHex.isNotEmpty ? primaryColorHex : '#007AFF');
+
+  return CupertinoThemeData(
+    applyThemeToAll: true,
+    primaryColor: seed,
+    primaryContrastingColor: CupertinoColors.white,
+    {{#if flags.hasDarkMode}}
+    {{#if theme.darkMode.system}}
+    brightness: null, // Allow system-wide dark mode support
+    {{else}}
+    brightness: Brightness.dark,
+    {{/if}}
+    {{else}}
+    brightness: Brightness.light,
+    {{/if}}
+    scaffoldBackgroundColor: CupertinoColors.systemBackground,
+    barBackgroundColor: CupertinoColors.systemGrey6,
+    textTheme: CupertinoTextThemeData(
+      primaryColor: seed,
+      textStyle: const TextStyle(
+        {{#if flags.hasCustomFonts}}fontFamily: '{{flags.primaryFontFamily}}',{{/if}}
+        fontSize: 17,
+        letterSpacing: -0.41,
+      ),
+      actionTextStyle: TextStyle(
+        {{#if flags.hasCustomFonts}}fontFamily: '{{flags.primaryFontFamily}}',{{/if}}
+        color: seed,
+        fontSize: 17,
+        fontWeight: FontWeight.w400,
+      ),
+      navTitleTextStyle: const TextStyle(
+        {{#if flags.hasCustomFonts}}fontFamily: '{{flags.primaryFontFamily}}',{{/if}}
+        fontWeight: FontWeight.w600,
+        fontSize: 17,
+        letterSpacing: -0.41,
+      ),
+      navLargeTitleTextStyle: const TextStyle(
+        {{#if flags.hasCustomFonts}}fontFamily: '{{flags.primaryFontFamily}}',{{/if}}
+        fontWeight: FontWeight.bold,
+        fontSize: 34,
+        letterSpacing: 0.41,
+      ),
+      tabLabelTextStyle: const TextStyle(
+        {{#if flags.hasCustomFonts}}fontFamily: '{{flags.primaryFontFamily}}',{{/if}}
+        fontSize: 10,
+        fontWeight: FontWeight.w500,
+        letterSpacing: -0.24,
+      ),
+      pickerTextStyle: const TextStyle(
+        {{#if flags.hasCustomFonts}}fontFamily: '{{flags.primaryFontFamily}}',{{/if}}
+        fontSize: 21,
+        letterSpacing: -0.41,
+      ),
+      dateTimePickerTextStyle: const TextStyle(
+        {{#if flags.hasCustomFonts}}fontFamily: '{{flags.primaryFontFamily}}',{{/if}}
+        fontSize: 21,
+        letterSpacing: -0.41,
+      ),
+    ),
+  );
+}
+

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

@@ -0,0 +1,20 @@
+/// Barrel export for all theme constants.
+///
+/// Import this single file to access all design foundation values:
+/// ```dart
+/// import 'package:{{appSlug}}/src/theme/theme_constants.dart';
+///
+/// SizedBox(height: AppSpacing.md)
+/// Container(decoration: BoxDecoration(borderRadius: AppBorders.card))
+/// AnimatedContainer(duration: AppDurations.normal, curve: AppCurves.standard)
+/// ```
+library;
+
+export 'app_spacing.dart';
+export 'app_borders.dart';
+export 'app_shadows.dart';
+export 'app_durations.dart';
+export 'app_curves.dart';
+export 'color_schemes.dart';
+export 'text_theme.dart';
+export 'theme.dart';

package/templates/base/lib/src/utils/app_utils.dart.hbs

@@ -0,0 +1,46 @@
+class AppUtils {
+  /// Checks if data is null.
+  static bool isNull(dynamic value) => value == null;
+
+  /// Checks if data is null or blank (empty or only contains whitespace).
+  static bool isBlank(dynamic value) {
+    if (value == null) return true;
+    if (value is String) {
+      return value.trim().isEmpty;
+    }
+    if (value is Iterable || value is Map) {
+      return value.isEmpty;
+    }
+    return false;
+  }
+
+  /// Uppercase first letter inside string and let the others lowercase.
+  /// Example: your name => Your name
+  static String? capitalizeFirst(String s) {
+    if (isBlank(s)) return s;
+    return s[0].toUpperCase() + s.substring(1).toLowerCase();
+  }
+
+  /// Checks if string is phone number.
+  static bool isPhoneNumber(String s) {
+    if (s.length > 16 || s.length < 9) return false;
+    return hasMatch(s, r'^[+]*[(]{0,1}[0-9]{1,4}[)]{0,1}[-\s\./0-9]*$');
+  }
+
+  static bool hasMatch(String? value, String pattern) {
+    return (value == null) ? false : RegExp(pattern).hasMatch(value);
+  }
+
+  static bool isValidEmail(String s) {
+    final emailRegExp = RegExp(
+      r"^[a-zA-Z0-9.a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9]+\.[a-zA-Z]+",
+    );
+    return emailRegExp.hasMatch(s);
+  }
+
+  /// Checks if string is URL.
+  static bool isURL(String s) => hasMatch(
+        s,
+        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\.\,\;\?\'\\\+&%\$#\=~_\-]+))*$",
+      );
+}

package/templates/base/lib/src/utils/debouncer.dart.hbs

@@ -0,0 +1,31 @@
+import 'dart:async';
+
+class Debouncer {
+  final Duration delay;
+  Timer? _timer;
+
+  Debouncer({this.delay = const Duration(milliseconds: 500)});
+
+  void run(void Function() action) {
+    _timer?.cancel();
+    _timer = Timer(delay, action);
+  }
+
+  void dispose() {
+    _timer?.cancel();
+  }
+}
+
+class Throttler {
+  final Duration delay;
+  bool _isThrottling = false;
+
+  Throttler({this.delay = const Duration(milliseconds: 500)});
+
+  void run(void Function() action) {
+    if (_isThrottling) return;
+    action();
+    _isThrottling = true;
+    Timer(delay, () => _isThrottling = false);
+  }
+}

package/templates/base/lib/src/utils/error_handler.dart.hbs

@@ -0,0 +1,14 @@
+class AppErrorHandler {
+  static String format(dynamic error) {
+    if (error is String) return error;
+    
+    // Add logic for common exceptions (e.g., DioException if using Dio)
+    // For now, basic error message extraction
+    try {
+      if (error?.message != null) return error.message;
+      if (error?.toString() != null) return error.toString();
+    } catch (_) {}
+    
+    return 'An unexpected error occurred';
+  }
+}

package/templates/base/lib/src/utils/failure.dart.hbs

@@ -0,0 +1,30 @@
+import 'package:equatable/equatable.dart';
+
+abstract class Failure extends Equatable {
+  final String message;
+  final dynamic error;
+
+  const Failure(this.message, {this.error});
+
+  @override
+  List<Object?> get props => [message, error];
+
+  @override
+  String toString() => message;
+}
+
+class ServerFailure extends Failure {
+  const ServerFailure(super.message, {super.error});
+}
+
+class CacheFailure extends Failure {
+  const CacheFailure(super.message, {super.error});
+}
+
+class NetworkFailure extends Failure {
+  const NetworkFailure(super.message, {super.error});
+}
+
+class UnknownFailure extends Failure {
+  const UnknownFailure(super.message, {super.error});
+}

package/templates/base/lib/src/utils/input_formatters.dart.hbs

@@ -0,0 +1,27 @@
+import 'package:flutter/services.dart';
+
+class FormCardFormatter extends TextInputFormatter {
+  @override
+  TextEditingValue formatEditUpdate(
+    TextEditingValue oldValue,
+    TextEditingValue newValue,
+  ) {
+    final text = newValue.text;
+    if (newValue.selection.baseOffset == 0) return newValue;
+
+    final buffer = StringBuffer();
+    for (int i = 0; i < text.length; i++) {
+      buffer.write(text[i]);
+      final nonZeroIndex = i + 1;
+      if (nonZeroIndex % 4 == 0 && nonZeroIndex != text.length) {
+        buffer.write(' '); // Add space every 4 digits
+      }
+    }
+
+    final string = buffer.toString();
+    return newValue.copyWith(
+      text: string,
+      selection: TextSelection.collapsed(offset: string.length),
+    );
+  }
+}

package/templates/base/lib/src/utils/logger.dart.hbs

@@ -0,0 +1,37 @@
+import 'dart:developer' as developer;
+import 'package:flutter/foundation.dart';
+
+class AppLogger {
+  static void info(String message) {
+    _log('\x1B[34m$message\x1B[0m', name: 'INFO');
+  }
+
+  static void success(String message) {
+    _log('\x1B[32m$message\x1B[0m', name: 'SUCCESS');
+  }
+
+  static void warning(String message) {
+    _log('\x1B[33m$message\x1B[0m', name: 'WARNING');
+  }
+
+  static void error(String message, [Object? error, StackTrace? stackTrace]) {
+    _log('\x1B[31m$message\x1B[0m', name: 'ERROR', error: error, stackTrace: stackTrace);
+  }
+
+  static void _log(String message, {String name = '', Object? error, StackTrace? stackTrace}) {
+    if (kDebugMode) {
+      developer.log(
+        message,
+        name: name,
+        error: error,
+        stackTrace: stackTrace,
+      );
+    }
+  }
+}
+
+// Global helper functions as requested by the user
+void logInfo(String msg) => AppLogger.info(msg);
+void logSuccess(String msg) => AppLogger.success(msg);
+void logWarning(String msg) => AppLogger.warning(msg);
+void logError(String msg) => AppLogger.error(msg);

package/templates/base/lib/src/utils/platform_info.dart.hbs

@@ -0,0 +1,13 @@
+import 'package:flutter/foundation.dart';
+
+class PlatformInfo {
+  static bool get isWeb => kIsWeb;
+  static bool get isAndroid => defaultTargetPlatform == TargetPlatform.android;
+  static bool get isIOS => defaultTargetPlatform == TargetPlatform.iOS;
+  static bool get isMacOS => defaultTargetPlatform == TargetPlatform.macOS;
+  static bool get isWindows => defaultTargetPlatform == TargetPlatform.windows;
+  static bool get isLinux => defaultTargetPlatform == TargetPlatform.linux;
+
+  static bool get isMobile => isAndroid || isIOS;
+  static bool get isDesktop => isMacOS || isWindows || isLinux;
+}

package/templates/base/lib/src/utils/task_runner.dart.hbs

@@ -0,0 +1,42 @@
+import 'package:fpdart/fpdart.dart';
+
+import '../imports/core_imports.dart';
+
+/// A reusable generic function to handle potential exceptions in async tasks
+/// and map them to the [Either] type matching [FutureEither<T>].
+///
+/// If [requiresNetwork] is `true` and [isNetworkAvailable] returns `false`,
+/// the [action] will not be executed and a [NetworkFailure] will be returned.
+FutureEither<T> runTask<T>(
+  Future<T> Function() action, {
+  bool requiresNetwork = false,
+}) async {
+  if (requiresNetwork) {
+    final hasNetwork = await InternetConnectionService().hasConnection();
+
+    if (!hasNetwork) {
+      AppLogger.warning('Network unavailable for task');
+      showGlobalToast(
+        message:
+            'No internet connection. Please check your connection and try again.',
+        status: 'warning',
+      );
+      return left(
+        const NetworkFailure(
+          'No internet connection. Please check your connection and try again.',
+        ),
+      );
+    }
+  }
+
+  try {
+    final result = await action();
+    return right(result);
+  } catch (error, stackTrace) {
+    AppLogger.error('Task execution failed $error', [error, stackTrace]);
+    final errorMessage = AppErrorHandler.format(error);
+
+    // Depending on logic, map error strings/types to specific Failure variants
+    return left(ServerFailure(errorMessage, error: error));
+  }
+}