create-flutterinit 0.1.0

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

@@ -0,0 +1,88 @@
+import '../../imports/imports.dart';
+
+/// A themed horizontal divider using [ColorScheme.outlineVariant].
+///
+/// Prefer this over the raw [Divider] widget to stay consistent with the
+/// app's colour scheme without passing explicit colours everywhere.
+///
+/// Usage:
+/// ```dart
+/// const AppDivider()                  // standard 1-pt divider
+/// const AppDivider.thick()            // 2-pt emphasis divider
+/// AppDivider(indent: 16)              // inset divider (like list separator)
+/// ```
+class AppDivider extends StatelessWidget {
+  const AppDivider({
+    super.key,
+    this.height = 1,
+    this.thickness = 1,
+    this.indent = 0,
+    this.endIndent = 0,
+    this.color,
+  });
+
+  /// 2-pt visually prominent divider — use between major content sections.
+  const AppDivider.thick({
+    super.key,
+    this.height = 2,
+    this.thickness = 2,
+    this.indent = 0,
+    this.endIndent = 0,
+    this.color,
+  });
+
+  final double height;
+  final double thickness;
+  final double indent;
+  final double endIndent;
+  final Color? color;
+
+  @override
+  Widget build(BuildContext context) {
+    return Divider(
+      height: height,
+      thickness: thickness,
+      indent: indent,
+      endIndent: endIndent,
+      color: color ?? context.theme.colorScheme.outlineVariant,
+    );
+  }
+}
+
+/// A themed vertical divider using [ColorScheme.outlineVariant].
+///
+/// Usage:
+/// ```dart
+/// Row(children: [
+///   Text('Left'),
+///   const AppVerticalDivider(),
+///   Text('Right'),
+/// ])
+/// ```
+class AppVerticalDivider extends StatelessWidget {
+  const AppVerticalDivider({
+    super.key,
+    this.width = 1,
+    this.thickness = 1,
+    this.indent = 0,
+    this.endIndent = 0,
+    this.color,
+  });
+
+  final double width;
+  final double thickness;
+  final double indent;
+  final double endIndent;
+  final Color? color;
+
+  @override
+  Widget build(BuildContext context) {
+    return VerticalDivider(
+      width: width,
+      thickness: thickness,
+      indent: indent,
+      endIndent: endIndent,
+      color: color ?? context.theme.colorScheme.outlineVariant,
+    );
+  }
+}

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

@@ -0,0 +1,73 @@
+import '../../imports/imports.dart';
+
+/// Displays an empty state with an icon, title, optional subtitle, and action.
+///
+/// Usage:
+/// ```dart
+/// AppEmptyState(
+///   icon: Icons.inbox_outlined,
+///   title: 'No messages yet',
+///   subtitle: 'Your inbox will appear here.',
+///   actionLabel: 'Refresh',
+///   onAction: _refresh,
+/// )
+/// ```
+class AppEmptyState extends StatelessWidget {
+  const AppEmptyState({
+    super.key,
+    this.icon = {{#if flags.usesIconsaxPlus}}IconsaxPlusLinear.box{{else if flags.usesFlutterRemix}}FlutterRemix.inbox_line{{else if flags.usesHugeicons}}HugeIcons.strokeRoundedInbox{{else}}Icons.inbox_outlined{{/if}},
+    required this.title,
+    this.subtitle,
+    this.actionLabel,
+    this.onAction,
+  });
+
+  final dynamic icon;
+  final String title;
+  final String? subtitle;
+  final String? actionLabel;
+  final VoidCallback? onAction;
+
+  @override
+  Widget build(BuildContext context) {
+    final cs = context.theme.colorScheme;
+    final tt = context.theme.textTheme;
+
+    return Center(
+      child: Padding(
+        padding: {{#if flags.usesScreenutil}}EdgeInsets.all(40.w){{else}}const EdgeInsets.all(40){{/if}},
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            AppIcon(icon: icon, size: {{res 64 'sp' flags.usesScreenutil}}, color: cs.onSurfaceVariant.withValues(alpha: 0.5)),
+            {{#if flags.usesScreenutil}}SizedBox(height: 20.h){{else}}const SizedBox(height: 20){{/if}},
+            Text(
+              title,
+              style: tt.titleMedium?.copyWith(
+                color: cs.onSurface,
+                fontWeight: FontWeight.w600,
+              ),
+              textAlign: TextAlign.center,
+            ),
+            if (subtitle != null) ...[
+              {{#if flags.usesScreenutil}}SizedBox(height: 8.h){{else}}const SizedBox(height: 8){{/if}},
+              Text(
+                subtitle!,
+                style: tt.bodyMedium?.copyWith(color: cs.onSurfaceVariant),
+                textAlign: TextAlign.center,
+              ),
+            ],
+            if (actionLabel != null && onAction != null) ...[
+              {{#if flags.usesScreenutil}}SizedBox(height: 28.h){{else}}const SizedBox(height: 28){{/if}},
+              AppButton(
+                label: actionLabel!,
+                onPressed: onAction,
+                variant: ButtonVariant.secondary,
+              ),
+            ],
+          ],
+        ),
+      ),
+    );
+  }
+}

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

@@ -0,0 +1,69 @@
+import '../../imports/imports.dart';
+
+/// Displays an error state with an icon, title, optional body, and retry button.
+///
+/// Usage:
+/// ```dart
+/// AppErrorWidget(
+///   title: 'Something went wrong',
+///   message: error.toString(),
+///   onRetry: () => ref.invalidate(myProvider),
+/// )
+/// ```
+class AppErrorWidget extends StatelessWidget {
+  const AppErrorWidget({
+    super.key,
+    this.title = 'Something went wrong',
+    this.message,
+    this.onRetry,
+    this.icon = {{#if flags.usesIconsaxPlus}}IconsaxPlusLinear.danger{{else if flags.usesFlutterRemix}}FlutterRemix.error_warning_line{{else if flags.usesHugeicons}}HugeIcons.strokeRoundedAlertCircle{{else}}Icons.error_outline_rounded{{/if}},
+  });
+
+  final String title;
+  final String? message;
+  final VoidCallback? onRetry;
+  final dynamic icon;
+
+  @override
+  Widget build(BuildContext context) {
+    final cs = context.theme.colorScheme;
+    final tt = context.theme.textTheme;
+
+    return Center(
+      child: Padding(
+        padding: const EdgeInsets.all(32),
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            AppIcon(icon: icon, size: 56, color: cs.error),
+            const SizedBox(height: 16),
+            Text(
+              title,
+              style: tt.titleMedium?.copyWith(
+                color: cs.onSurface,
+                fontWeight: FontWeight.bold,
+              ),
+              textAlign: TextAlign.center,
+            ),
+            if (message != null) ...[
+              const SizedBox(height: 8),
+              Text(
+                message!,
+                style: tt.bodySmall?.copyWith(color: cs.onSurfaceVariant),
+                textAlign: TextAlign.center,
+              ),
+            ],
+            if (onRetry != null) ...[
+              const SizedBox(height: 24),
+              AppButton(
+                label: 'Try Again',
+                onPressed: onRetry,
+                variant: ButtonVariant.outline,
+              ),
+            ],
+          ],
+        ),
+      ),
+    );
+  }
+}

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

@@ -0,0 +1,25 @@
+import '../../imports/imports.dart';
+
+/// A wrapper widget that handles different icon libraries.
+class AppIcon extends StatelessWidget {
+  const AppIcon({
+    super.key,
+    required this.icon,
+    this.size,
+    this.color,
+  });
+
+  /// The icon to display.
+  final IconData icon;
+  final double? size;
+  final Color? color;
+
+  @override
+  Widget build(BuildContext context) {
+    return Icon(
+      icon,
+      size: size,
+      color: color,
+    );
+  }
+}

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

@@ -0,0 +1,54 @@
+import '../../imports/imports.dart';
+
+/// Centered loading indicator using the primary colour from the theme.
+///
+/// Usage:
+/// ```dart
+/// // Simple inline loader
+/// const AppLoading()
+///
+/// // Full-screen loader with message
+/// AppLoading(message: 'Fetching data...')
+/// ```
+class AppLoading extends StatelessWidget {
+  const AppLoading({
+    super.key,
+    this.message,
+    this.size = 28,
+    this.strokeWidth = 3,
+  });
+
+  final String? message;
+  final double size;
+  final double strokeWidth;
+
+  @override
+  Widget build(BuildContext context) {
+    final cs = context.theme.colorScheme;
+    return Center(
+      child: Column(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          SizedBox(
+            width: size,
+            height: size,
+            child: CircularProgressIndicator(
+              strokeWidth: strokeWidth,
+              color: cs.primary,
+            ),
+          ),
+          if (message != null) ...[
+            {{#if flags.usesScreenutil}}SizedBox(height: 16.h){{else}}const SizedBox(height: 16){{/if}},
+            Text(
+              message!,
+              style: context.theme.textTheme.bodyMedium?.copyWith(
+                    color: cs.onSurfaceVariant,
+                  ),
+              textAlign: TextAlign.center,
+            ),
+          ],
+        ],
+      ),
+    );
+  }
+}

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

@@ -0,0 +1,89 @@
+import '../../imports/core_imports.dart';
+
+
+/// A themed text form field wrapping [TextFormField].
+///
+/// Usage:
+/// ```dart
+/// AppTextField(
+///   label: 'Email',
+///   hint: 'you@example.com',
+///   controller: _emailController,
+///   keyboardType: TextInputType.emailAddress,
+///   validator: (v) => v!.isEmpty ? 'Required' : null,
+/// )
+/// ```
+class AppTextField extends StatelessWidget {
+  const AppTextField({
+    super.key,
+    this.label,
+    this.hint,
+    this.controller,
+    this.validator,
+    this.onChanged,
+    this.onFieldSubmitted,
+    this.focusNode,
+    this.keyboardType,
+    this.textInputAction,
+    this.obscureText = false,
+    this.readOnly = false,
+    this.enabled = true,
+    this.maxLines = 1,
+    this.minLines,
+    this.prefixIcon,
+    this.suffixIcon,
+    this.initialValue,
+    this.autofocus = false,
+  });
+
+  final String? label;
+  final String? hint;
+  final TextEditingController? controller;
+  final FormFieldValidator<String>? validator;
+  final ValueChanged<String>? onChanged;
+  final ValueChanged<String>? onFieldSubmitted;
+  final FocusNode? focusNode;
+  final TextInputType? keyboardType;
+  final TextInputAction? textInputAction;
+  final bool obscureText;
+  final bool readOnly;
+  final bool enabled;
+  final int? maxLines;
+  final int? minLines;
+  final Widget? prefixIcon;
+  final Widget? suffixIcon;
+  final String? initialValue;
+  final bool autofocus;
+
+  @override
+  Widget build(BuildContext context) {
+    final cs = context.theme.colorScheme;
+    final tt = context.theme.textTheme;
+
+    return TextFormField(
+      controller: controller,
+      initialValue: initialValue,
+      validator: validator,
+      onChanged: onChanged,
+      onFieldSubmitted: onFieldSubmitted,
+      focusNode: focusNode,
+      keyboardType: keyboardType,
+      textInputAction: textInputAction,
+      obscureText: obscureText,
+      readOnly: readOnly,
+      enabled: enabled,
+      maxLines: obscureText ? 1 : maxLines,
+      minLines: minLines,
+      autofocus: autofocus,
+      style: tt.bodyLarge?.copyWith(color: cs.onSurface),
+      cursorColor: cs.primary,
+      decoration: InputDecoration(
+        isDense: true,
+        labelText: label,
+        hintText: hint,
+        prefixIcon: prefixIcon,
+        suffixIcon: suffixIcon,
+      ),
+    );
+  }
+}

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

@@ -0,0 +1,105 @@
+import '../../imports/imports.dart';
+
+class AppTopBar extends StatelessWidget implements PreferredSizeWidget {
+  const AppTopBar({
+    super.key,
+    required this.title,
+    this.titleWidget,
+    this.actions,
+    this.centerTitle = true,
+    this.onPressed,
+    this.isTransparent = false,
+  });
+
+  final String title;
+  final Widget? titleWidget;
+  final List<Widget>? actions;
+  final VoidCallback? onPressed;
+  final bool? centerTitle;
+  final bool isTransparent;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = context.theme;
+    
+    // Check if we can pop
+    {{#if (eq flags.routerPackage "go_router")}}
+    final bool canPop = context.canPop();
+    {{else if (eq flags.routerPackage "auto_route")}}
+    final bool canPop = context.router.canPop();
+    {{else}}
+    final bool canPop = Navigator.canPop(context);
+    {{/if}}
+
+    void handleBack() {
+      if (onPressed != null) {
+        onPressed!();
+      } else if (canPop) {
+        {{#if (eq flags.routerPackage "go_router")}}
+        context.pop();
+        {{else if (eq flags.routerPackage "auto_route")}}
+        context.router.maybePop();
+        {{else}}
+        Navigator.maybePop(context);
+        {{/if}}
+      } else {
+        {{#if (eq flags.routerPackage "go_router")}}
+        context.go(AppRoutes.home);
+        {{else if (eq flags.routerPackage "auto_route")}}
+        context.router.replaceAll([const HomeRoute()]);
+        {{else}}
+        Navigator.pushReplacementNamed(context, AppRoutes.home);
+        {{/if}}
+      }
+    }
+
+    return AppBar(
+      centerTitle: centerTitle,
+      elevation: 0,
+      backgroundColor: isTransparent ? Colors.transparent : null,
+      shadowColor: Colors.transparent,
+      title: titleWidget ??
+          Text(
+            title,
+            style: theme.appBarTheme.titleTextStyle?.copyWith(
+              fontWeight: FontWeight.w600,
+            ) ?? theme.textTheme.titleMedium?.copyWith(
+              fontWeight: FontWeight.w600,
+            ),
+          ),
+      leadingWidth: {{res 40 'w' flags.usesScreenutil}},
+      leading: GestureDetector(
+        onTap: handleBack,
+        child: ColoredBox(
+          color: Colors.transparent,
+          child: {{#if flags.usesHugeicons}}
+              HugeIcon(
+                icon: HugeIcons.strokeRoundedArrowLeft01,
+                size: {{res 24 'sp' flags.usesScreenutil}},
+              )
+            {{else if flags.usesIconsaxPlus}}
+              Icon(
+                IconsaxPlusLinear.arrow_left,
+                color: theme.appBarTheme.iconTheme?.color ?? theme.colorScheme.onSurface,
+              )
+            {{else if flags.usesFlutterRemix}}
+              Icon(
+                FlutterRemix.arrow_left_line,
+                color: theme.appBarTheme.iconTheme?.color ?? theme.colorScheme.onSurface,
+              )
+            {{else}}
+              Icon(
+                Icons.arrow_back,
+                color: theme.appBarTheme.iconTheme?.color ?? theme.colorScheme.onSurface,
+              )
+            {{/if}},
+        ),
+      ),
+      iconTheme: theme.appBarTheme.iconTheme,
+      actions: actions ?? [],
+    );
+  }
+
+  @override
+  Size get preferredSize => const Size.fromHeight(kToolbarHeight);
+}

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

@@ -0,0 +1,120 @@
+import '../../imports/imports.dart';
+
+
+/// A multi-purpose image widget that handles network images, SVGs, and local assets.
+/// 
+/// Automatically uses [CachedNetworkImage] if enabled for web images.
+/// Automatically uses [SvgPicture] if enabled for SVG files.
+class CommonImage extends StatelessWidget {
+  final String imageUrl;
+  final double? width;
+  final double? height;
+  final BoxFit fit;
+  final Color? color;
+  final Widget? placeholder;
+  final Widget? errorWidget;
+  final BorderRadius? borderRadius;
+
+  const CommonImage({
+    super.key,
+    required this.imageUrl,
+    this.width,
+    this.height,
+    this.fit = BoxFit.cover,
+    this.color,
+    this.placeholder,
+    this.errorWidget,
+    this.borderRadius,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final double? adjustedWidth = {{#if flags.usesScreenutil}}width?.w{{else}}width{{/if}};
+    final double? adjustedHeight = {{#if flags.usesScreenutil}}height?.h{{else}}height{{/if}};
+
+    Widget image;
+
+    if (imageUrl.startsWith('http')) {
+      {{#if flags.usesCachedNetworkImage}}
+      image = AppCachedImage(
+        imageUrl: imageUrl,
+        width: width,
+        height: height,
+        fit: fit,
+        color: color,
+        placeholder: placeholder,
+        errorWidget: errorWidget,
+        borderRadius: borderRadius,
+      );
+      {{else}}
+      image = Image.network(
+        imageUrl,
+        width: adjustedWidth,
+        height: adjustedHeight,
+        fit: fit,
+        color: color,
+        errorBuilder: (context, error, stackTrace) => errorWidget ?? _buildDefaultErrorWidget(),
+      );
+      {{/if}}
+    } else if (imageUrl.endsWith('.svg')) {
+      {{#if flags.usesFlutterSvg}}
+      image = SvgPicture.asset(
+        imageUrl,
+        width: adjustedWidth,
+        height: adjustedHeight,
+        fit: fit,
+        colorFilter: color != null ? ColorFilter.mode(color!, BlendMode.srcIn) : null,
+      );
+      {{else}}
+      image = const Icon(Icons.broken_image, color: Colors.grey);
+      {{/if}}
+    } else {
+      image = Image.asset(
+        imageUrl,
+        width: adjustedWidth,
+        height: adjustedHeight,
+        fit: fit,
+        color: color,
+        errorBuilder: (context, error, stackTrace) => errorWidget ?? _buildDefaultErrorWidget(),
+      );
+    }
+
+    if (borderRadius != null) {
+      return ClipRRect(
+        borderRadius: borderRadius!,
+        child: image,
+      );
+    }
+
+    return image;
+  }
+
+  Widget _buildDefaultErrorWidget() {
+    return Container(
+      width: width,
+      height: height,
+      color: Colors.grey[200],
+      child: {{#if flags.usesHugeicons}}
+          HugeIcon(
+            icon: HugeIcons.strokeRoundedImageNotFound02,
+            size: {{res 24 'sp' flags.usesScreenutil}},
+          )
+        {{else if flags.usesIconsaxPlus}}
+          const Icon(
+            IconsaxPlusBold.image,
+            color: Colors.grey,
+          )
+        {{else if flags.usesFlutterRemix}}
+          const Icon(
+            FlutterRemix.image_line,
+            color: Colors.grey,
+          )
+        {{else}}
+          const Icon(
+            Icons.error_outline,
+            color: Colors.grey,
+          )
+        {{/if}},
+    );
+  }
+}

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

@@ -0,0 +1,4 @@
+export 'toast.dart';
+export 'toast_card.dart';
+export 'raw_toast.dart';
+