maxsim-flutter 1.0.0

package/templates/modules/i18n/pubspec.partial.yaml

@@ -0,0 +1,7 @@
+dependencies:
+  flutter_localizations:
+    sdk: flutter
+  intl: ^0.19.0
+
+flutter:
+  generate: true

package/templates/modules/push/lib/features/push/data/datasources/push_datasource.dart.hbs

@@ -0,0 +1,124 @@
+import '../../domain/repositories/push_repository.dart';
+{{#ifEquals modules.push.provider "firebase"}}
+import 'package:firebase_messaging/firebase_messaging.dart';
+{{/ifEquals}}
+{{#ifEquals modules.push.provider "onesignal"}}
+import 'package:onesignal_flutter/onesignal_flutter.dart';
+{{/ifEquals}}
+
+abstract class PushDataSource {
+  Future<bool> requestPermission();
+  Future<String?> getToken();
+  Stream<PushMessage> get onMessage;
+  Stream<PushMessage> get onMessageOpenedApp;
+  Future<void> subscribeToTopic(String topic);
+  Future<void> unsubscribeFromTopic(String topic);
+}
+{{#ifEquals modules.push.provider "firebase"}}
+
+class FirebasePushDataSource implements PushDataSource {
+  final FirebaseMessaging _messaging;
+
+  FirebasePushDataSource({FirebaseMessaging? messaging})
+      : _messaging = messaging ?? FirebaseMessaging.instance;
+
+  @override
+  Future<bool> requestPermission() async {
+    final settings = await _messaging.requestPermission(
+      alert: true,
+      badge: true,
+      sound: true,
+    );
+    return settings.authorizationStatus == AuthorizationStatus.authorized ||
+        settings.authorizationStatus == AuthorizationStatus.provisional;
+  }
+
+  @override
+  Future<String?> getToken() => _messaging.getToken();
+
+  @override
+  Stream<PushMessage> get onMessage => FirebaseMessaging.onMessage.map(
+        (message) => PushMessage(
+          title: message.notification?.title,
+          body: message.notification?.body,
+          data: message.data,
+        ),
+      );
+
+  @override
+  Stream<PushMessage> get onMessageOpenedApp =>
+      FirebaseMessaging.onMessageOpenedApp.map(
+        (message) => PushMessage(
+          title: message.notification?.title,
+          body: message.notification?.body,
+          data: message.data,
+        ),
+      );
+
+  @override
+  Future<void> subscribeToTopic(String topic) =>
+      _messaging.subscribeToTopic(topic);
+
+  @override
+  Future<void> unsubscribeFromTopic(String topic) =>
+      _messaging.unsubscribeFromTopic(topic);
+}
+{{/ifEquals}}
+{{#ifEquals modules.push.provider "onesignal"}}
+
+class OneSignalPushDataSource implements PushDataSource {
+  OneSignalPushDataSource() {
+    OneSignal.initialize('YOUR_ONESIGNAL_APP_ID');
+  }
+
+  @override
+  Future<bool> requestPermission() async {
+    return await OneSignal.Notifications.requestPermission(true);
+  }
+
+  @override
+  Future<String?> getToken() async {
+    return OneSignal.User.pushSubscription.id;
+  }
+
+  @override
+  Stream<PushMessage> get onMessage {
+    final controller = StreamController<PushMessage>.broadcast();
+    OneSignal.Notifications.addForegroundWillDisplayListener((event) {
+      final notification = event.notification;
+      controller.add(PushMessage(
+        title: notification.title,
+        body: notification.body,
+        data: notification.additionalData ?? {},
+      ));
+      event.preventDefault();
+    });
+    return controller.stream;
+  }
+
+  @override
+  Stream<PushMessage> get onMessageOpenedApp {
+    final controller = StreamController<PushMessage>.broadcast();
+    OneSignal.Notifications.addClickListener((event) {
+      final notification = event.notification;
+      controller.add(PushMessage(
+        title: notification.title,
+        body: notification.body,
+        data: notification.additionalData ?? {},
+      ));
+    });
+    return controller.stream;
+  }
+
+  @override
+  Future<void> subscribeToTopic(String topic) async {
+    // OneSignal uses tags instead of topics
+    OneSignal.User.addTag(topic, 'true');
+  }
+
+  @override
+  Future<void> unsubscribeFromTopic(String topic) async {
+    OneSignal.User.removeTag(topic);
+  }
+}
+{{/ifEquals}}

package/templates/modules/push/lib/features/push/data/repositories/push_repository_impl.dart.hbs

@@ -0,0 +1,28 @@
+import '../../domain/repositories/push_repository.dart';
+import '../datasources/push_datasource.dart';
+
+class PushRepositoryImpl implements PushRepository {
+  final PushDataSource _dataSource;
+
+  PushRepositoryImpl(this._dataSource);
+
+  @override
+  Future<bool> requestPermission() => _dataSource.requestPermission();
+
+  @override
+  Future<String?> getToken() => _dataSource.getToken();
+
+  @override
+  Stream<PushMessage> get onMessage => _dataSource.onMessage;
+
+  @override
+  Stream<PushMessage> get onMessageOpenedApp => _dataSource.onMessageOpenedApp;
+
+  @override
+  Future<void> subscribeToTopic(String topic) =>
+      _dataSource.subscribeToTopic(topic);
+
+  @override
+  Future<void> unsubscribeFromTopic(String topic) =>
+      _dataSource.unsubscribeFromTopic(topic);
+}

package/templates/modules/push/lib/features/push/domain/repositories/push_repository.dart.hbs

@@ -0,0 +1,31 @@
+abstract class PushRepository {
+  /// Request permission to receive push notifications.
+  Future<bool> requestPermission();
+
+  /// Get the FCM/device token for this device.
+  Future<String?> getToken();
+
+  /// Stream of incoming foreground messages.
+  Stream<PushMessage> get onMessage;
+
+  /// Stream of messages that opened the app from background.
+  Stream<PushMessage> get onMessageOpenedApp;
+
+  /// Subscribe to a topic (Firebase only).
+  Future<void> subscribeToTopic(String topic);
+
+  /// Unsubscribe from a topic (Firebase only).
+  Future<void> unsubscribeFromTopic(String topic);
+}
+
+class PushMessage {
+  final String? title;
+  final String? body;
+  final Map<String, dynamic> data;
+
+  const PushMessage({
+    this.title,
+    this.body,
+    this.data = const {},
+  });
+}

package/templates/modules/push/lib/features/push/presentation/providers/push_provider.dart.hbs

@@ -0,0 +1,34 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+import '../../data/datasources/push_datasource.dart';
+import '../../data/repositories/push_repository_impl.dart';
+import '../../domain/repositories/push_repository.dart';
+
+part 'push_provider.g.dart';
+
+@riverpod
+PushDataSource pushDataSource(Ref ref) {
+{{#ifEquals modules.push.provider "firebase"}}
+  return FirebasePushDataSource();
+{{/ifEquals}}
+{{#ifEquals modules.push.provider "onesignal"}}
+  return OneSignalPushDataSource();
+{{/ifEquals}}
+}
+
+@riverpod
+PushRepository pushRepository(Ref ref) {
+  return PushRepositoryImpl(ref.watch(pushDataSourceProvider));
+}
+
+@riverpod
+Stream<PushMessage> incomingPushMessages(Ref ref) {
+  return ref.watch(pushRepositoryProvider).onMessage;
+}
+
+@riverpod
+Future<String?> pushToken(Ref ref) async {
+  final repo = ref.watch(pushRepositoryProvider);
+  await repo.requestPermission();
+  return repo.getToken();
+}

package/templates/modules/push/pubspec.partial.yaml

@@ -0,0 +1,8 @@
+{{#ifEquals modules.push.provider "firebase"}}
+dependencies:
+  firebase_messaging: ^15.1.6
+{{/ifEquals}}
+{{#ifEquals modules.push.provider "onesignal"}}
+dependencies:
+  onesignal_flutter: ^5.2.7
+{{/ifEquals}}

package/templates/modules/theme/lib/core/theme/app_theme.dart.hbs

@@ -0,0 +1,74 @@
+import 'package:flutter/material.dart';
+import 'package:google_fonts/google_fonts.dart';
+
+/// Application theme configuration using Material 3 with ColorScheme.fromSeed.
+abstract final class AppTheme {
+  /// Seed color used to generate the color scheme.
+  static final Color seedColor = _colorFromHex('{{modules.theme.seedColor}}');
+
+  /// Light theme with Material 3 seed-based color scheme.
+  static ThemeData get light => _buildTheme(Brightness.light);
+
+{{#if modules.theme.darkMode}}
+  /// Dark theme with Material 3 seed-based color scheme.
+  static ThemeData get dark => _buildTheme(Brightness.dark);
+{{/if}}
+
+  static Color _colorFromHex(String hex) {
+    final buffer = StringBuffer();
+    if (hex.startsWith('#')) hex = hex.substring(1);
+    if (hex.length == 6) buffer.write('FF');
+    buffer.write(hex);
+    return Color(int.parse(buffer.toString(), radix: 16));
+  }
+
+  static ThemeData _buildTheme(Brightness brightness) {
+    final colorScheme = ColorScheme.fromSeed(
+      seedColor: seedColor,
+      brightness: brightness,
+    );
+
+    final textTheme = GoogleFonts.interTextTheme(
+      ThemeData(brightness: brightness).textTheme,
+    );
+
+    return ThemeData(
+      useMaterial3: true,
+      colorScheme: colorScheme,
+      textTheme: textTheme,
+      appBarTheme: AppBarTheme(
+        centerTitle: true,
+        backgroundColor: colorScheme.surface,
+        foregroundColor: colorScheme.onSurface,
+        elevation: 0,
+      ),
+      cardTheme: CardTheme(
+        elevation: 0,
+        shape: RoundedRectangleBorder(
+          borderRadius: BorderRadius.circular(12),
+        ),
+        color: colorScheme.surfaceContainerLow,
+      ),
+      inputDecorationTheme: InputDecorationTheme(
+        filled: true,
+        fillColor: colorScheme.surfaceContainerHighest.withValues(alpha: 0.5),
+        border: OutlineInputBorder(
+          borderRadius: BorderRadius.circular(12),
+          borderSide: BorderSide.none,
+        ),
+        focusedBorder: OutlineInputBorder(
+          borderRadius: BorderRadius.circular(12),
+          borderSide: BorderSide(color: colorScheme.primary, width: 2),
+        ),
+      ),
+      elevatedButtonTheme: ElevatedButtonThemeData(
+        style: ElevatedButton.styleFrom(
+          padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 12),
+          shape: RoundedRectangleBorder(
+            borderRadius: BorderRadius.circular(12),
+          ),
+        ),
+      ),
+    );
+  }
+}

package/templates/modules/theme/lib/core/theme/theme_provider.dart.hbs

@@ -0,0 +1,46 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+import 'app_theme.dart';
+
+part 'theme_provider.g.dart';
+
+{{#if modules.theme.darkMode}}
+/// Notifier that manages the current [ThemeMode] (light, dark, or system).
+@riverpod
+class AppThemeMode extends _$AppThemeMode {
+  @override
+  ThemeMode build() => ThemeMode.system;
+
+  /// Set the theme mode to light.
+  void setLight() => state = ThemeMode.light;
+
+  /// Set the theme mode to dark.
+  void setDark() => state = ThemeMode.dark;
+
+  /// Set the theme mode to follow the system setting.
+  void setSystem() => state = ThemeMode.system;
+
+  /// Toggle between light and dark mode.
+  void toggle() {
+    state = state == ThemeMode.dark ? ThemeMode.light : ThemeMode.dark;
+  }
+}
+{{else}}
+/// Provides the current theme mode. Dark mode is disabled; always returns light.
+@riverpod
+class AppThemeMode extends _$AppThemeMode {
+  @override
+  ThemeMode build() => ThemeMode.light;
+}
+{{/if}}
+
+/// Provides the light [ThemeData] from [AppTheme].
+@riverpod
+ThemeData lightTheme(Ref ref) => AppTheme.light;
+
+{{#if modules.theme.darkMode}}
+/// Provides the dark [ThemeData] from [AppTheme].
+@riverpod
+ThemeData darkTheme(Ref ref) => AppTheme.dark;
+{{/if}}

package/templates/modules/theme/pubspec.partial.yaml

@@ -0,0 +1,2 @@
+dependencies:
+  google_fonts: ^6.2.1