create-flutterinit 0.1.0

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/(isBloc)@bloc/auth_bloc.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/auth_logic }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/(isBloc)@bloc/session_bloc.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/session_provider }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/(isGetX)@controllers/auth_controller.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/auth_logic }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/(isGetX)@controllers/session_controller.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/session_provider }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/(isMobX)@stores/auth_store.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/auth_logic }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/(isMobX)@stores/session_store.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/session_provider }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/(isNoneState)@view_models/auth_view_model.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/auth_logic }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/(isNoneState)@view_models/session_manager.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/session_provider }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/(isProvider,isRiverpod)@providers/auth_provider.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/auth_logic }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/(isProvider,isRiverpod)@providers/session_provider.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/session_provider }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/forgot_password_screen.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/forgot_password_screen }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/login_screen.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/login_screen }}

package/templates/overlays/architecture/mvvm/lib/src/ui/auth/signup_screen.dart.hbs

@@ -0,0 +1 @@
+{{> features/auth/signup_screen }}

package/templates/overlays/architecture/mvvm/lib/src/ui/home/home_page.dart.hbs

@@ -0,0 +1 @@
+{{> features/home/home_page }}

package/templates/overlays/architecture/mvvm/lib/src/ui/onboarding/onboarding_page.dart.hbs

@@ -0,0 +1 @@
+{{> features/onboarding/onboarding_page }}

package/templates/overlays/backend/appwrite/lib/src/services/(usesAppwriteAuth)@auth_service.dart.hbs

@@ -0,0 +1,101 @@
+import 'dart:async';
+import '../utils/utils.dart';
+import '../config/app_config.dart';
+import 'package:appwrite/appwrite.dart';
+
+class AuthService {
+  AuthService._();
+  static final AuthService instance = AuthService._();
+
+  Account get _account => AppConfig.appwriteAccount;
+
+  // Appwrite doesn't have a built-in auth state stream, so we manage our own
+  final StreamController<Map<String, dynamic>?> _authStateController =
+      StreamController<Map<String, dynamic>?>.broadcast();
+
+  /// Stream of auth state changes. Emits the current user map or null.
+  Stream<Map<String, dynamic>?> get authStateChanges => _authStateController.stream;
+
+  FutureEither<Map<String, dynamic>?> login({
+    required String email,
+    required String password,
+  }) async {
+    return runTask(() async {
+      await _account.createEmailPasswordSession(
+        email: email, 
+        password: password
+      );
+      final user = await _account.get();
+      final userData = {
+        'id': user.$id,
+        'email': user.email,
+        'name': user.name,
+      };
+      _authStateController.add(userData);
+      return userData;
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<Map<String, dynamic>?> signUp({
+    required String name,
+    required String email,
+    required String password,
+  }) async {
+    return runTask(() async {
+      final user = await _account.create(
+        userId: ID.unique(),
+        email: email, 
+        password: password,
+        name: name,
+      );
+      // login after signup to get session
+      await _account.createEmailPasswordSession(
+        email: email, 
+        password: password
+      );
+      final userData = {
+        'id': user.$id,
+        'email': user.email,
+        'name': user.name,
+      };
+      _authStateController.add(userData);
+      return userData;
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<void> forgotPassword({required String email}) async {
+    return runTask(() async {
+      // url for password recovery in your app
+      await _account.createRecovery(
+        email: email, 
+        url: 'https://example.com/recovery'
+      );
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<void> logout() async {
+    return runTask(() async {
+      await _account.deleteSession(sessionId: 'current');
+      _authStateController.add(null);
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<Map<String, dynamic>?> getCurrentUser() async {
+    return runTask(() async {
+      try {
+        final user = await _account.get();
+        return {
+          'id': user.$id,
+          'email': user.email,
+          'name': user.name,
+        };
+      } catch (e) {
+        return null; // session likely missing or invalid
+      }
+    });
+  }
+
+  void dispose() {
+    _authStateController.close();
+  }
+}

package/templates/overlays/backend/custom/lib/src/services/auth_service.dart.hbs

@@ -0,0 +1,158 @@
+import 'dart:async';
+import '../utils/utils.dart';
+import '../config/app_config.dart';
+{{#if flags.usesDio}}
+import 'package:dio/dio.dart';
+{{else if flags.usesHttp}}
+import 'package:http/http.dart' as http;
+import 'dart:convert';
+{{/if}}
+
+class AuthService {
+  AuthService._();
+  static final AuthService instance = AuthService._();
+
+  {{#if flags.usesDio}}
+  Dio get _dio => AppConfig.dio;
+  {{else if flags.usesHttp}}
+  http.Client get _http => AppConfig.httpClient;
+  {{/if}}
+
+  // Custom Backend doesn't have a built-in auth state stream, so we manage our own
+  final StreamController<Map<String, dynamic>?> _authStateController =
+      StreamController<Map<String, dynamic>?>.broadcast();
+
+  /// Stream of auth state changes. Emits the current user map or null.
+  Stream<Map<String, dynamic>?> get authStateChanges => _authStateController.stream;
+
+  FutureEither<Map<String, dynamic>?> login({
+    required String email,
+    required String password,
+  }) async {
+    return runTask(() async {
+      {{#if flags.usesDio}}
+      final response = await _dio.post<Map<String, dynamic>>('/auth/login', data: {
+        'email': email,
+        'password': password,
+      });
+      final data = response.data!;
+      _authStateController.add(data);
+      return data;
+      {{else if flags.usesHttp}}
+      final http.Response response = await _http.post(
+        Uri.parse('${AppConfig.baseUrl}/auth/login'),
+        body: jsonEncode({'email': email, 'password': password}),
+        headers: {'Content-Type': 'application/json'},
+      );
+      if (response.statusCode != 200) throw Exception('Login failed');
+      final data = jsonDecode(response.body) as Map<String, dynamic>;
+      _authStateController.add(data);
+      return data;
+      {{else}}
+      // Mock implementation if no networking flag is set
+      await Future.delayed(const Duration(seconds: 1));
+      if (email == 'admin@example.com' && password == 'admin123') {
+        final data = {
+          'id': '1',
+          'email': email,
+          'name': 'Admin User',
+        };
+        _authStateController.add(data);
+        return data;
+      }
+      throw Exception('Invalid credentials');
+      {{/if}}
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<Map<String, dynamic>?> signUp({
+    required String name,
+    required String email,
+    required String password,
+  }) async {
+    return runTask(() async {
+      {{#if flags.usesDio}}
+      final response = await _dio.post<Map<String, dynamic>>('/auth/signup', data: {
+        'name': name,
+        'email': email,
+        'password': password,
+      });
+      final data = response.data!;
+      _authStateController.add(data);
+      return data;
+      {{else if flags.usesHttp}}
+      final http.Response response = await _http.post(
+        Uri.parse('${AppConfig.baseUrl}/auth/signup'),
+        body: jsonEncode({
+          'name': name,
+          'email': email,
+          'password': password,
+        }),
+        headers: {'Content-Type': 'application/json'},
+      );
+      if (response.statusCode != 201) throw Exception('Signup failed');
+      final data = jsonDecode(response.body) as Map<String, dynamic>;
+      _authStateController.add(data);
+      return data;
+      {{else}}
+      // Mock implementation if no networking flag is set
+      await Future.delayed(const Duration(seconds: 1));
+      final data = {
+        'id': '100',
+        'email': email,
+        'name': name,
+      };
+      _authStateController.add(data);
+      return data;
+      {{/if}}
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<void> forgotPassword({required String email}) async {
+    return runTask(() async {
+      {{#if flags.usesDio}}
+      await _dio.post<void>('/auth/forgot-password', data: {'email': email});
+      {{else if flags.usesHttp}}
+      final http.Response _ = await _http.post(
+        Uri.parse('${AppConfig.baseUrl}/auth/forgot-password'),
+        body: jsonEncode({'email': email}),
+        headers: {'Content-Type': 'application/json'},
+      );
+      {{else}}
+      await Future.delayed(const Duration(seconds: 1));
+      {{/if}}
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<void> logout() async {
+    return runTask(() async {
+      {{#if flags.usesDio}}
+      await _dio.post<void>('/auth/logout');
+      {{else if flags.usesHttp}}
+      final http.Response _ = await _http.post(Uri.parse('${AppConfig.baseUrl}/auth/logout'));
+      {{else}}
+      await Future.delayed(const Duration(seconds: 1));
+      {{/if}}
+      _authStateController.add(null);
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<Map<String, dynamic>?> getCurrentUser() async {
+    return runTask(() async {
+      {{#if flags.usesDio}}
+      final response = await _dio.get<Map<String, dynamic>>('/auth/me');
+      return response.data;
+      {{else if flags.usesHttp}}
+      final http.Response response = await _http.get(Uri.parse('${AppConfig.baseUrl}/auth/me'));
+      if (response.statusCode != 200) return null;
+      return jsonDecode(response.body) as Map<String, dynamic>;
+      {{else}}
+      return null;
+      {{/if}}
+    });
+  }
+
+  void dispose() {
+    _authStateController.close();
+  }
+}

package/templates/overlays/backend/firebase/lib/src/services/(usesFirebaseAuth)@auth_service.dart.hbs

@@ -0,0 +1,96 @@
+import '../utils/utils.dart';
+import '../config/app_config.dart';
+import 'package:firebase_auth/firebase_auth.dart';
+
+class AuthService {
+  AuthService._();
+  static final AuthService instance = AuthService._();
+
+  FirebaseAuth get _firebaseAuth => AppConfig.firebaseAuth;
+
+  /// Stream of auth state changes. Emits the current user map or null.
+  Stream<Map<String, dynamic>?> get authStateChanges {
+    return _firebaseAuth.authStateChanges().map((User? user) {
+      if (user == null) return null;
+      return {
+        'id': user.uid,
+        'email': user.email ?? '',
+        'name': user.displayName ?? '',
+        'photoUrl': user.photoURL,
+      };
+    });
+  }
+
+  {{#if backend.options.authEmail}}
+  FutureEither<Map<String, dynamic>?> login({
+    required String email,
+    required String password,
+  }) async {
+    return runTask(() async {
+      final credentials = await _firebaseAuth.signInWithEmailAndPassword(
+        email: email, 
+        password: password
+      );
+      final user = credentials.user;
+      if (user == null) return null;
+      return {
+        'id': user.uid,
+        'email': user.email ?? '',
+        'name': user.displayName ?? '',
+        'photoUrl': user.photoURL,
+      };
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<Map<String, dynamic>?> signUp({
+    required String name,
+    required String email,
+    required String password,
+  }) async {
+    return runTask(() async {
+      final credentials = await _firebaseAuth.createUserWithEmailAndPassword(
+        email: email, 
+        password: password
+      );
+      final user = credentials.user;
+      if (user == null) return null;
+      await user.updateDisplayName(name);
+      return {
+        'id': user.uid,
+        'email': user.email ?? '',
+        'name': name,
+        'photoUrl': user.photoURL,
+      };
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<void> forgotPassword({required String email}) async {
+    return runTask(() async {
+      await _firebaseAuth.sendPasswordResetEmail(email: email);
+    }, requiresNetwork: true);
+  }
+  {{/if}}
+
+  FutureEither<void> logout() async {
+    return runTask(() async {
+      await _firebaseAuth.signOut();
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<Map<String, dynamic>?> getCurrentUser() async {
+    return runTask(() async {
+      final user = _firebaseAuth.currentUser;
+      if (user == null) return null;
+      return {
+        'id': user.uid,
+        'email': user.email ?? '',
+        'name': user.displayName ?? '',
+        'photoUrl': user.photoURL,
+      };
+    });
+  }
+
+  void dispose() {
+    // Firebase manages its own streams
+  }
+}

package/templates/overlays/backend/supabase/lib/src/services/(usesSupabaseAuth)@auth_service.dart.hbs

@@ -0,0 +1,97 @@
+import '../utils/utils.dart';
+import '../config/app_config.dart';
+import 'package:supabase_flutter/supabase_flutter.dart';
+
+class AuthService {
+  AuthService._();
+  static final AuthService instance = AuthService._();
+
+  SupabaseClient get _supabaseClient => AppConfig.supabase;
+
+  /// Stream of auth state changes. Emits the current user map or null.
+  Stream<Map<String, dynamic>?> get authStateChanges {
+    return _supabaseClient.auth.onAuthStateChange.map((data) {
+      final session = data.session;
+      if (session == null) return null;
+      final user = session.user;
+      return {
+        'id': user.id,
+        'email': user.email,
+        'name': user.userMetadata?['name'] ?? '',
+        'photoUrl': user.userMetadata?['avatar_url'],
+      };
+    });
+  }
+
+  FutureEither<Map<String, dynamic>?> login({
+    required String email,
+    required String password,
+  }) async {
+    return runTask(() async {
+      final response = await _supabaseClient.auth.signInWithPassword(
+        email: email,
+        password: password,
+      );
+      final user = response.user;
+      if (user == null) return null;
+      return {
+        'id': user.id,
+        'email': user.email,
+        'name': user.userMetadata?['name'] ?? '',
+        'photoUrl': user.userMetadata?['avatar_url'],
+      };
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<Map<String, dynamic>?> signUp({
+    required String name,
+    required String email,
+    required String password,
+  }) async {
+    return runTask(() async {
+      final response = await _supabaseClient.auth.signUp(
+        email: email,
+        password: password,
+        data: {'name': name},
+      );
+      final user = response.user;
+      if (user == null) return null;
+      return {
+        'id': user.id,
+        'email': user.email,
+        'name': name,
+        'photoUrl': user.userMetadata?['avatar_url'],
+      };
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<void> forgotPassword({required String email}) async {
+    return runTask(() async {
+      await _supabaseClient.auth.resetPasswordForEmail(email);
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<void> logout() async {
+    return runTask(() async {
+      await _supabaseClient.auth.signOut();
+    }, requiresNetwork: true);
+  }
+
+  FutureEither<Map<String, dynamic>?> getCurrentUser() async {
+    return runTask(() async {
+      final session = _supabaseClient.auth.currentSession;
+      if (session == null) return null;
+      final user = session.user;
+      return {
+        'id': user.id,
+        'email': user.email,
+        'name': user.userMetadata?['name'] ?? '',
+        'photoUrl': user.userMetadata?['avatar_url'],
+      };
+    });
+  }
+
+  void dispose() {
+    // Supabase manages its own streams
+  }
+}

package/templates/overlays/device/app_version_update/lib/src/services/(usesAppVersionUpdate)@version_update_service.dart.hbs

@@ -0,0 +1,118 @@
+import 'package:app_version_update/data/models/app_version_result.dart';
+
+import '../imports/imports.dart';
+
+/// A service to check for app updates and manage version information using
+/// the `app_version_update` package.
+class VersionUpdateService {
+  VersionUpdateService._();
+  static final VersionUpdateService instance = VersionUpdateService._();
+
+  /// Check if a newer version of the app is available in the store.
+  FutureEither<AppVersionResult?> checkForUpdate({
+    String? appleId,
+    String? playStoreId,
+  }) async {
+    return runTask(() async {
+      return await AppVersionUpdate.checkForUpdates(
+        appleId: appleId,
+        playStoreId: playStoreId,
+      );
+    }, requiresNetwork: true);
+  }
+
+  /// High-level method to check for updates and show the dialog automatically if available.
+  FutureEither<void> checkAndShowUpdate({
+    String? appleId,
+    String? playStoreId,
+    bool mandatory = false,
+  }) async {
+    return runTask(() async {
+      final result = await AppVersionUpdate.checkForUpdates(
+        appleId: appleId,
+        playStoreId: playStoreId,
+      );
+
+      if (result.canUpdate ?? false) {
+        final context = rootContext;
+        if (context == null) {
+          AppLogger.warning('Cannot show update dialog: rootContext is null');
+          return;
+        }
+
+        if(context.mounted){
+          AppVersionUpdate.showAlertUpdate(
+            appVersionResult: result,
+            context: context,
+            mandatory: mandatory,
+          );
+        }
+      }
+    }, requiresNetwork: true);
+  }
+
+  /// Display a platform-specific update dialog.
+  FutureEither<void> showUpdateAlert({
+    required AppVersionResult updateResult,
+    bool mandatory = false,
+    String? title,
+    String? content,
+    String? cancelText,
+    String? updateText,
+  }) async {
+    return runTask(() async {
+      final context = rootContext;
+      if (context == null) return;
+
+      AppVersionUpdate.showAlertUpdate(
+        appVersionResult: updateResult,
+        context: context,
+        mandatory: mandatory,
+        title: title ?? 'New version available',
+        content: content ?? 'Would you like to update your application?',
+        cancelButtonText: cancelText ?? 'UPDATE LATER',
+        updateButtonText: updateText ?? 'UPDATE',
+      );
+    });
+  }
+
+  /// Display a platform-specific update bottom sheet.
+  FutureEither<void> showUpdateBottomSheet({
+    required AppVersionResult updateResult,
+    bool mandatory = false,
+    String? title,
+    Widget? content,
+  }) async {
+    return runTask(() async {
+      final context = rootContext;
+      if (context == null) return;
+
+      AppVersionUpdate.showBottomSheetUpdate(
+        appVersionResult: updateResult,
+        context: context,
+        mandatory: mandatory,
+        title: title ?? 'New version available',
+        content: content,
+      );
+    });
+  }
+
+  /// Display a dedicated update page.
+  FutureEither<void> showUpdatePage({
+    required AppVersionResult updateResult,
+    bool mandatory = false,
+    Widget? page,
+  }) async {
+    return runTask(() async {
+      final context = rootContext;
+      if (context == null) return;
+
+      AppVersionUpdate.showPageUpdate(
+        appVersionResult: updateResult,
+        context: context,
+        mandatory: mandatory,
+        page: page,
+      );
+    });
+  }
+}

package/templates/overlays/device/device_info/lib/src/services/(usesDeviceInfoPlus)@device_info_service.dart.hbs

@@ -0,0 +1,54 @@
+import 'dart:io';
+import 'package:device_info_plus/device_info_plus.dart';
+import '../utils/utils.dart';
+
+/// A service to retrieve detailed information about the current device.
+class DeviceInfoService {
+  DeviceInfoService._();
+  static final DeviceInfoService instance = DeviceInfoService._();
+
+  final DeviceInfoPlugin _deviceInfo = DeviceInfoPlugin();
+
+  /// Retrieve full device information as a Map.
+  FutureEither<Map<String, dynamic>> getFullDeviceInfo() async {
+    return runTask(() async {
+      if (Platform.isAndroid) {
+        final androidInfo = await _deviceInfo.androidInfo;
+        return {
+          'model': androidInfo.model,
+          'manufacturer': androidInfo.manufacturer,
+          'version': androidInfo.version.release,
+          'sdkInt': androidInfo.version.sdkInt,
+          'id': androidInfo.id,
+          'isPhysicalDevice': androidInfo.isPhysicalDevice,
+        };
+      } else if (Platform.isIOS) {
+        final iosInfo = await _deviceInfo.iosInfo;
+        return {
+          'name': iosInfo.name,
+          'model': iosInfo.model,
+          'systemName': iosInfo.systemName,
+          'systemVersion': iosInfo.systemVersion,
+          'identifierForVendor': iosInfo.identifierForVendor,
+          'isPhysicalDevice': iosInfo.isPhysicalDevice,
+        };
+      } else if (Platform.isMacOS) {
+        final macInfo = await _deviceInfo.macOsInfo;
+        return {
+          'computerName': macInfo.computerName,
+          'hostName': macInfo.hostName,
+          'model': macInfo.model,
+          'osRelease': macInfo.osRelease,
+        };
+      } else if (Platform.isWindows) {
+        final winInfo = await _deviceInfo.windowsInfo;
+        return {
+          'computerName': winInfo.computerName,
+          'numberOfCores': winInfo.numberOfCores,
+          'systemMemoryInMegabytes': winInfo.systemMemoryInMegabytes,
+        };
+      }
+      return {'platform': 'unknown'};
+    });
+  }
+}