coregen-cli 3.1.6__py3-none-any.whl

generators/static/templates/user_profile/infrastructure/user_profile_repository_template.jinja

@@ -0,0 +1,82 @@
+/*
+ * UserProfile repository implementation
+ * Provides concrete implementation of IUserProfileRepository
+ * 
+ * NOTE: This is a skeleton implementation. Uncomment and implement
+ * the necessary parts to integrate with your backend API or local storage.
+ * 
+ * Implementation options:
+ * 1. API integration: Use Retrofit/Dio to call backend endpoints
+ * 2. Local storage: Use Hive/SharedPreferences/SQLite for offline support
+ * 3. Hybrid: Combine API calls with local caching
+ */
+
+import 'package:dartz/dartz.dart';
+import 'package:injectable/injectable.dart';
+import 'package:[[project_name]]/domain/auth/model/i_auth_facade.dart';
+import 'package:[[project_name]]/domain/user_profile/model/user_profile.dart';
+import 'package:[[project_name]]/domain/user_profile/model/i_user_profile_repository.dart';
+import 'package:[[project_name]]/domain/user_profile/model/user_profile_failure.dart';
+import 'package:[[project_name]]/domain/user_profile/infrastructure/user_profile_service.dart';
+
+@Injectable(as: IUserProfileRepository)
+class UserProfileRepository implements IUserProfileRepository {
+  final IAuthFacade _authFacade;
+  final UserProfileService _userProfileService;
+
+  UserProfileRepository(
+    this._authFacade,
+    this._userProfileService,
+  );
+
+  @override
+  Future<Either<UserProfileFailure, UserProfile>> getCurrentUserProfile() async {
+    // Example implementation:
+    // try {
+    //   final dto = await _userProfileService.getCurrentUserProfile();
+    //   return right(dto.toDomain());
+    // } catch (e) {
+    //   return left(const UserProfileFailure.unexpected());
+    // }
+
+    return left(const UserProfileFailure.unexpected());
+  }
+
+  @override
+  Future<Either<UserProfileFailure, UserProfile>> updateCurrentUserProfile(UserProfile userProfile) async {
+    // Example implementation:
+    // try {
+    //   final updateData = {
+    //     'name': userProfile.name.getOrCrash(),
+    //     'avatar_url': userProfile.avatarUrl.fold(() => null, (url) => url),
+    //   };
+    //   await _userProfileService.updateCurrentUserProfile(updateData);
+    //   final dto = await _userProfileService.getCurrentUserProfile();
+    //   return right(dto.toDomain());
+    // } catch (e) {
+    //   return left(const UserProfileFailure.unableToUpdate());
+    // }
+
+    return left(const UserProfileFailure.unableToUpdate());
+  }
+
+  @override
+  Future<Either<UserProfileFailure, String>> uploadAvatar(String filePath) async {
+    // Example implementation:
+    // try {
+    //   // Upload file to storage (e.g., Supabase, Firebase Storage)
+    //   // Return the public URL of the uploaded file
+    //   return right('https://example.com/avatar.png');
+    // } catch (e) {
+    //   return left(const UserProfileFailure.unexpected());
+    // }
+
+    return left(const UserProfileFailure.unexpected());
+  }
+
+  @override
+  Future<Either<UserProfileFailure, void>> logout() async {
+    await _authFacade.signOut();
+    return right(unit);
+  }
+}

generators/static/templates/user_profile/infrastructure/user_profile_service_template.jinja

@@ -0,0 +1,27 @@
+import 'package:dio/dio.dart';
+import 'package:injectable/injectable.dart';
+import 'package:[[project_name]]/apis/common/constants.dart';
+import 'package:[[project_name]]/domain/user_profile/infrastructure/user_profile_dto.dart';
+import 'package:retrofit/retrofit.dart';
+
+part 'user_profile_service.g.dart';
+
+@module
+abstract class UserProfileRemoteModule {
+  @lazySingleton
+  UserProfileService userProfileService(Dio dio) {
+    return UserProfileService(dio, baseUrl: Constants.dioBaseUrl);
+  }
+}
+
+@RestApi()
+abstract class UserProfileService {
+  @factoryMethod
+  factory UserProfileService(Dio dio, {String baseUrl}) = _UserProfileService;
+
+  @GET('/get-user-profile')
+  Future<UserProfileDto> getCurrentUserProfile();
+
+  @PATCH('/update-user-profile')
+  Future<void> updateCurrentUserProfile(@Body() Map<String, dynamic> userProfileDto);
+}

generators/static/templates/user_profile/model/i_user_profile_repository_template.jinja

@@ -0,0 +1,34 @@
+/*
+ * UserProfile repository interface
+ * Defines the contract for UserProfile data operations:
+ * - Get current user profile
+ * - Update current user profile
+ * - Upload avatar
+ * - Logout
+ * - Uses Either type for error handling (Left = UserProfileFailure, Right = success)
+ * 
+ * This interface allows different implementations (API, local storage, etc.)
+ * while keeping the business logic independent of data source
+ */
+
+import 'package:dartz/dartz.dart';
+import 'package:[[project_name]]/domain/user_profile/model/user_profile.dart';
+import 'package:[[project_name]]/domain/user_profile/model/user_profile_failure.dart';
+
+abstract class IUserProfileRepository {
+  /// Get the current user's profile
+  /// Returns the UserProfile if found, otherwise returns UserProfileFailure
+  Future<Either<UserProfileFailure, UserProfile>> getCurrentUserProfile();
+
+  /// Update the current user's profile
+  /// Returns the updated UserProfile or UserProfileFailure if operation fails
+  Future<Either<UserProfileFailure, UserProfile>> updateCurrentUserProfile(UserProfile userProfile);
+
+  /// Upload user avatar
+  /// Uploads the image at filePath to storage and returns the public URL
+  Future<Either<UserProfileFailure, String>> uploadAvatar(String filePath);
+
+  /// Logout user
+  /// Returns the result of the logout operation
+  Future<Either<UserProfileFailure, void>> logout();
+}

generators/static/templates/user_profile/model/user_profile_failure_template.jinja

@@ -0,0 +1,11 @@
+import 'package:freezed_annotation/freezed_annotation.dart';
+
+part 'user_profile_failure.freezed.dart';
+
+@freezed
+abstract class UserProfileFailure with _$UserProfileFailure {
+  const factory UserProfileFailure.unexpected() = Unexpected;
+  const factory UserProfileFailure.insufficientPermission() = InsufficientPermission;
+  const factory UserProfileFailure.unableToUpdate() = UnableToUpdate;
+  const factory UserProfileFailure.notFound() = NotFound;
+}

generators/static/templates/user_profile/model/user_profile_template.jinja

@@ -0,0 +1,31 @@
+/*
+ * UserProfile entity template
+ * Represents the user profile stored in the application database
+ * 
+ * This entity is separate from the authentication User entity:
+ * - User (auth): Used by AuthBloc and authentication flow
+ * - UserProfile (database): Extended profile with additional fields
+ * 
+ * Both entities use the same ID (authId) to correlate them.
+ * The UserProfile is automatically created/updated when a user authenticates.
+ */
+
+import 'package:dartz/dartz.dart';
+import 'package:freezed_annotation/freezed_annotation.dart';
+import 'package:[[project_name]]/domain/auth/model/value_objects.dart';
+import 'package:[[project_name]]/core/model/entity.dart';
+import 'package:[[project_name]]/core/model/value_objects.dart';
+
+part 'user_profile.freezed.dart';
+
+@freezed
+abstract class UserProfile with _$UserProfile implements IEntity {
+  const factory UserProfile({
+    required UniqueId id,
+    required StringSingleLine name,
+    required EmailAddress emailAddress,
+    required Option<String> avatarUrl,
+    required DateTime createdAt,
+    required DateTime updatedAt,
+  }) = _UserProfile;
+}

generators/static/templates/widgets/common/custom_scaffold_template.jinja

@@ -0,0 +1,52 @@
+import 'package:caravaggio_ui/caravaggio_ui.dart';
+import 'package:flutter/material.dart';
+
+/// App-level scaffold wrapping [CScaffold] with project defaults.
+class CustomScaffold extends StatelessWidget {
+  const CustomScaffold({
+    super.key,
+    this.body,
+    this.bodyBuilder,
+    this.title,
+    this.action,
+    this.leading,
+    this.drawer,
+    this.scrollController,
+    this.showBackButton = true,
+    this.hideTitleOnScroll = true,
+    this.titleAlignment = Alignment.centerLeft,
+    this.onBackPressed,
+  });
+
+  final Widget? body;
+  final Widget Function(BuildContext context, double topPadding)? bodyBuilder;
+  final Widget? title;
+  final Widget? action;
+  final Widget? leading;
+  final Widget? drawer;
+  final ScrollController? scrollController;
+  final bool showBackButton;
+  final bool hideTitleOnScroll;
+  final Alignment titleAlignment;
+  final VoidCallback? onBackPressed;
+
+  /// Returns the top padding from the nearest [CustomScaffold] / [CScaffold].
+  static double? topPaddingOf(BuildContext context) => CScaffold.topPaddingOf(context);
+
+  @override
+  Widget build(BuildContext context) {
+    return CScaffold(
+      body: body,
+      bodyBuilder: bodyBuilder,
+      title: title,
+      action: action,
+      leading: leading,
+      drawer: drawer,
+      scrollController: scrollController,
+      showBackButton: showBackButton,
+      hideTitleOnScroll: hideTitleOnScroll,
+      titleAlignment: titleAlignment,
+      onBackPressed: onBackPressed,
+    );
+  }
+}

generators/static/templates/widgets/common/error_widget_template.jinja

@@ -0,0 +1,22 @@
+import 'package:caravaggio_ui/caravaggio_ui.dart';
+import 'package:flutter/material.dart' hide ErrorWidget;
+
+/// Messaggio di errore già localizzato o pronto per la UI.
+class ErrorWidget extends StatelessWidget {
+  const ErrorWidget({super.key, required this.message});
+
+  final String message;
+
+  @override
+  Widget build(BuildContext context) {
+    return Center(
+      child: Padding(
+        padding: const EdgeInsets.all(16),
+        child: CText.body(
+          message,
+          textAlign: TextAlign.center,
+        ),
+      ),
+    );
+  }
+}

generators/static/templates/widgets/common/loading_widget_template.jinja

@@ -0,0 +1,14 @@
+import 'package:caravaggio_ui/caravaggio_ui.dart';
+import 'package:flutter/material.dart';
+
+/// Indicatore di caricamento condiviso (wrapper su [CLoader]).
+class LoadingWidget extends StatelessWidget {
+  const LoadingWidget({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return Center(
+      child: CLoader.bouncing(),
+    );
+  }
+}

generators/static/templates/widgets/common/unknown_state_widget_template.jinja

@@ -0,0 +1,23 @@
+import 'package:caravaggio_ui/caravaggio_ui.dart';
+import 'package:flutter/material.dart';
+
+/// Stato del BLoC non previsto dal widget (fallback).
+class UnknownStateWidget extends StatelessWidget {
+  const UnknownStateWidget({super.key, this.hint});
+
+  /// Testo opzionale per debug o supporto.
+  final String? hint;
+
+  @override
+  Widget build(BuildContext context) {
+    return Center(
+      child: Padding(
+        padding: const EdgeInsets.all(16),
+        child: CText.body(
+          hint ?? 'Stato non gestito',
+          textAlign: TextAlign.center,
+        ),
+      ),
+    );
+  }
+}

generators/templates/__init__.py

@@ -0,0 +1 @@
+from .main import generate_files

generators/templates/_core/core_generator.py

@@ -0,0 +1,121 @@
+from pathlib import Path
+from ..copier import generate_file
+
+
+def infer_has_login(lib_path: Path) -> bool:
+    """Detect whether the project includes generated auth/sign-in (``coregen create --login``).
+
+    Used when regenerating ``error_localizer.dart`` outside of ``create`` (e.g. ``add-domain``),
+    so ``localizeAuthFailure`` is preserved.
+    """
+    return (
+        lib_path / "features" / "auth" / "sign_in_form" / "presentation" / "sign_in_form.dart"
+    ).exists()
+
+
+def generate_files(project_name: str, lib_path: Path, has_login: bool):
+    generate_app_widget(project_name, lib_path, has_login)
+    generate_model(project_name, lib_path)
+    generate_infrastructure(project_name, lib_path)
+    generate_error_localizer(project_name, lib_path, domain_folder="domain", has_login=has_login)
+    generate_common_widgets(project_name, lib_path)
+
+
+def generate_common_widgets(project_name: str, lib_path: Path) -> None:
+    """Write shared UI widgets under lib/widgets/common/ (new project create)."""
+    generate_file(project_name, lib_path, "widgets/common/custom_scaffold_template.jinja", "widgets/common/custom_scaffold.dart")
+    generate_file(project_name, lib_path, "widgets/common/loading_widget_template.jinja", "widgets/common/loading_widget.dart")
+    generate_file(project_name, lib_path, "widgets/common/error_widget_template.jinja", "widgets/common/error_widget.dart")
+    generate_file(project_name, lib_path, "widgets/common/unknown_state_widget_template.jinja", "widgets/common/unknown_state_widget.dart")
+
+
+def ensure_common_widgets(project_name: str, lib_path: Path) -> None:
+    """Ensure lib/widgets/common exists (e.g. add-component on older projects)."""
+    if (lib_path / "widgets" / "common" / "loading_widget.dart").exists():
+        return
+    generate_common_widgets(project_name, lib_path)
+
+def generate_model(project_name: str, lib_path: Path):
+    generate_common_interfaces(project_name, lib_path)
+    generate_entity(project_name, lib_path)
+    generate_errors(project_name, lib_path)
+    generate_failures(project_name, lib_path)
+    generate_value_objects(project_name, lib_path)
+    generate_value_validators(project_name, lib_path)
+
+def generate_infrastructure(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "core/infrastructure/base_mapper_template.jinja", "core/infrastructure/base_mapper.dart")
+    generate_file(project_name, lib_path, "core/infrastructure/repository_error_handler_template.jinja", "core/infrastructure/repository_error_handler.dart")
+    generate_file(project_name, lib_path, "core/infrastructure/base_repository_mixin_template.jinja", "core/infrastructure/base_repository_mixin.dart")
+
+
+def generate_error_localizer(project_name: str, lib_path: Path, domain_folder: str = "domain", has_login: bool = False):
+    """Generate error_localizer.dart with a localize method per domain failure.
+
+    Scans ``lib_path / domain_folder`` for domain models that have a
+    corresponding ``*_failure.dart`` file and builds the template context
+    so the error localizer contains one method per domain failure.
+
+    ``localizeAuthFailure`` is emitted when login UI was generated (``has_login``)
+    **or** when ``domain/auth/model/auth_failure.dart`` exists, so sign-in code
+    can localize errors even on projects created without ``--login``.
+    """
+    from generators.helpers.feature import find_domain_models_with_class_names
+
+    auth_failure_path = lib_path / domain_folder / "auth" / "model" / "auth_failure.dart"
+    include_auth_failure_localizer = bool(has_login or auth_failure_path.is_file())
+
+    domain_failures = []
+    models = find_domain_models_with_class_names(lib_path, domain_folder) if lib_path.exists() else {}
+
+    for file_stem, info in sorted(models.items()):
+        failure_file = lib_path / domain_folder / info['folder'] / "model" / f"{file_stem}_failure.dart"
+        if not failure_file.exists():
+            continue
+
+        class_name = info['class_name']
+        failure_class = f"{class_name}Failure"
+        # Dedicated AuthFailure block below; skip generic template for entity stem "auth".
+        if include_auth_failure_localizer and file_stem == "auth" and failure_class == "AuthFailure":
+            continue
+        alias = f"{file_stem}_failure"
+        import_path = f"{project_name}/{domain_folder}/{info['folder']}/model/{file_stem}_failure.dart"
+
+        domain_failures.append({
+            "import_path": import_path,
+            "alias": alias,
+            "failure_class": failure_class,
+            "class_name": class_name,
+        })
+
+    generate_file(
+        project_name, lib_path,
+        "core/errors/error_localizer_template.jinja",
+        "core/errors/error_localizer.dart",
+        {"domain_failures": domain_failures, "has_login": include_auth_failure_localizer},
+    )
+
+
+def generate_app_widget(project_name: str, lib_path: Path, has_login: bool):
+    """Generate app widget file using Jinja template"""
+    generate_file(project_name, lib_path, "core/presentation/app_widget_template.jinja", "core/presentation/app_widget.dart", {
+        "has_login": has_login
+    })
+
+def generate_common_interfaces(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "core/model/common_interfaces_template.jinja", "core/model/common_interfaces.dart")
+
+def generate_entity(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "core/model/entity_template.jinja", "core/model/entity.dart")
+
+def generate_errors(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "core/model/errors_template.jinja", "core/model/errors.dart")
+
+def generate_failures(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "core/model/failures_template.jinja", "core/model/failures.dart")
+
+def generate_value_objects(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "core/model/value_objects_template.jinja", "core/model/value_objects.dart")
+
+def generate_value_validators(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "core/model/value_validators_template.jinja", "core/model/value_validators.dart")

generators/templates/apis/apis_generator.py

@@ -0,0 +1,50 @@
+from pathlib import Path
+from ..copier import generate_file
+from generators.helpers.data_source import regenerate_data_source_config
+
+
+def generate_files(project_name: str, lib_path: Path, has_login: bool = False):
+    generate_common(project_name, lib_path, has_login=has_login)
+    generate_core(project_name, lib_path)
+    generate_interceptors(project_name, lib_path, has_login=has_login)
+
+
+def generate_common(project_name: str, lib_path: Path, has_login: bool = False):
+    generate_constants(project_name, lib_path)
+    regenerate_data_source_config(
+        project_name,
+        lib_path,
+        domain_folder="domain",
+        has_login=has_login,
+    )
+
+
+def generate_core(project_name: str, lib_path: Path):
+    generate_api_injectable_module(project_name, lib_path)
+
+
+def generate_interceptors(project_name: str, lib_path: Path, has_login: bool = False):
+    generate_api_logger(project_name, lib_path)
+    generate_auth_interceptor(project_name, lib_path, has_login=has_login)
+
+
+def generate_constants(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "apis/common/constants_template.jinja", "apis/common/constants.dart")
+
+
+def generate_api_injectable_module(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "apis/core/api_injectable_module_template.jinja", "apis/core/api_injectable_module.dart")
+
+
+def generate_api_logger(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "apis/interceptors/api_logger_template.jinja", "apis/interceptors/api_logger.dart")
+
+
+def generate_auth_interceptor(project_name: str, lib_path: Path, has_login: bool = False):
+    generate_file(
+        project_name,
+        lib_path,
+        "apis/interceptors/auth_interceptor_template.jinja",
+        "apis/interceptors/auth_interceptor.dart",
+        {"has_login": has_login},
+    )

generators/templates/auth/auth_generator.py

@@ -0,0 +1,40 @@
+from pathlib import Path
+from ..copier import generate_file
+
+def generate_files(project_name: str, lib_path: Path):
+    generate_presentation(project_name, lib_path)
+    generate_model(project_name, lib_path)
+    generate_application(project_name, lib_path)
+    generate_infrastructure(project_name, lib_path)
+    generate_user_profile(project_name, lib_path)
+
+def generate_presentation(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "auth/presentation/login_screen_template.jinja", "features/auth/presentation/login_page.dart")
+
+def generate_model(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "auth/model/auth_failure_template.jinja", "domain/auth/model/auth_failure.dart")
+    generate_file(project_name, lib_path, "auth/model/i_auth_facade_template.jinja", "domain/auth/model/i_auth_facade.dart")
+    generate_file(project_name, lib_path, "auth/model/user_template.jinja", "domain/auth/model/user.dart")
+    generate_file(project_name, lib_path, "auth/model/value_objects_template.jinja", "domain/auth/model/value_objects.dart")
+
+def generate_application(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "auth/application/auth_bloc_template.jinja", "features/auth/application/auth_bloc.dart")
+    generate_file(project_name, lib_path, "auth/application/auth_event_template.jinja", "features/auth/application/auth_event.dart")
+    generate_file(project_name, lib_path, "auth/application/auth_state_template.jinja", "features/auth/application/auth_state.dart")
+
+def generate_infrastructure(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "auth/infrastructure/auth_facade_template.jinja", "domain/auth/infrastructure/auth_facade.dart")
+    generate_file(project_name, lib_path, "auth/infrastructure/mock_auth_facade_template.jinja", "domain/auth/infrastructure/mock_auth_facade.dart")
+    generate_file(project_name, lib_path, "auth/infrastructure/auth_facade_module_template.jinja", "domain/auth/infrastructure/auth_facade_module.dart")
+
+def generate_user_profile(project_name: str, lib_path: Path):
+    """Generate user_profile domain as a separate domain entity."""
+    # Model layer
+    generate_file(project_name, lib_path, "user_profile/model/user_profile_template.jinja", "domain/user_profile/model/user_profile.dart")
+    generate_file(project_name, lib_path, "user_profile/model/user_profile_failure_template.jinja", "domain/user_profile/model/user_profile_failure.dart")
+    generate_file(project_name, lib_path, "user_profile/model/i_user_profile_repository_template.jinja", "domain/user_profile/model/i_user_profile_repository.dart")
+    # Infrastructure layer
+    generate_file(project_name, lib_path, "user_profile/infrastructure/user_profile_dto_template.jinja", "domain/user_profile/infrastructure/user_profile_dto.dart")
+    generate_file(project_name, lib_path, "user_profile/infrastructure/user_profile_mapper_template.jinja", "domain/user_profile/infrastructure/user_profile_mapper.dart")
+    generate_file(project_name, lib_path, "user_profile/infrastructure/user_profile_repository_template.jinja", "domain/user_profile/infrastructure/user_profile_repository.dart")
+    generate_file(project_name, lib_path, "user_profile/infrastructure/user_profile_service_template.jinja", "domain/user_profile/infrastructure/user_profile_service.dart")

generators/templates/auth/sign_in_form_generator.py

@@ -0,0 +1,22 @@
+from pathlib import Path
+from ..copier import generate_file
+
+def generate_files(project_name: str, lib_path: Path):
+    generate_presentation(project_name, lib_path)
+    generate_model(project_name, lib_path)
+    generate_application(project_name, lib_path)
+    generate_infrastructure(project_name, lib_path)
+
+def generate_presentation(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "auth/sign_in_form/presentation/sign_in_form_template.jinja", "features/auth/sign_in_form/presentation/sign_in_form.dart")
+
+def generate_model(project_name: str, lib_path: Path):
+    pass
+
+def generate_application(project_name: str, lib_path: Path):
+    generate_file(project_name, lib_path, "auth/sign_in_form/application/sign_in_form_bloc_template.jinja", "features/auth/sign_in_form/application/sign_in_form_bloc.dart")
+    generate_file(project_name, lib_path, "auth/sign_in_form/application/sign_in_form_event_template.jinja", "features/auth/sign_in_form/application/sign_in_form_event.dart")
+    generate_file(project_name, lib_path, "auth/sign_in_form/application/sign_in_form_state_template.jinja", "features/auth/sign_in_form/application/sign_in_form_state.dart")
+
+def generate_infrastructure(project_name: str, lib_path: Path):
+    pass

generators/templates/copier.py

@@ -0,0 +1,51 @@
+from pathlib import Path
+from jinja2 import Template
+
+
+BASE_DIR = Path(__file__).parent  
+TEMPLATE_DIR = BASE_DIR.parent / "static" / "templates"
+
+def hex_to_dart_color(hex_color: str) -> str:
+    """
+    Convert hex color string to Dart Color object.
+    
+    Args:
+        hex_color: Hex color string (e.g., "#2196F3" or "2196F3")
+    
+    Returns:
+        Dart Color string (e.g., "Color(0xFF2196F3)")
+    """
+    # Remove # if present
+    hex_color = hex_color.lstrip('#')
+    
+    # Ensure it's 6 characters
+    if len(hex_color) != 6:
+        # Default to blue if invalid
+        hex_color = "2196F3"
+    
+    # Convert to uppercase for consistency
+    hex_color = hex_color.upper()
+    
+    # Return Dart Color format
+    return f"Color(0xFF{hex_color})"
+
+def generate_file(project_name: str, lib_path: Path, template_name: str, output_path: str, args: dict = None):
+    template_content = (TEMPLATE_DIR / template_name).read_text()
+    
+    # Use custom delimiters to avoid conflicts with Dart string interpolation
+    template = Template(template_content, variable_start_string='[[', variable_end_string=']]')
+    
+    # Prepare variables for substitution
+    template_vars = {"project_name": project_name, "feature_name": args.get("feature_name", "") if args else ""}
+    if args:
+        template_vars.update(args)
+    
+    # Add special variables for complex expressions
+    template_vars.update({
+        "err_response_statusMessage": "err.response?.statusMessage",
+    })
+    
+    content = template.render(**template_vars)
+    output_file = lib_path / output_path
+    output_file.parent.mkdir(parents=True, exist_ok=True)
+    output_file.write_text(content)

generators/templates/home/home_generator.py

@@ -0,0 +1,26 @@
+from pathlib import Path
+from ..copier import generate_file
+
+def generate_files(project_name: str, lib_path: Path, has_login: bool = False):
+    generate_presentation(project_name, lib_path, has_login)
+    generate_model(project_name, lib_path)
+    generate_application(project_name, lib_path)
+    generate_infrastructure(project_name, lib_path)
+
+def generate_presentation(project_name: str, lib_path: Path, has_login: bool = False):
+    generate_file(
+        project_name,
+        lib_path,
+        "home/presentation/home_screen_template.jinja",
+        "features/home/home_page.dart",
+        {"has_login": has_login},
+    )
+    
+def generate_model(project_name: str, lib_path: Path):
+    pass
+
+def generate_application(project_name: str, lib_path: Path):
+    pass
+
+def generate_infrastructure(project_name: str, lib_path: Path):
+    pass