flutter_architecture_generator 1.2.3

A CLI tool to scaffold professional Flutter projects with Clean, MVVM, BLoC, GetX, or Provider architecture plus DI, routing, and tests.

1.2.3

🚀 New Features

• Sealed Freezed Models: Added support for sealed class generation in model and chat commands for enhanced pattern matching and type safety.
• Overhauled API Engine: Completely re-engineered the api command with:
  • Clean Architecture Support: Automatic generation of Domain Entities and Repository Interfaces.
  • Model Inheritance: Models now correctly extend Entities for better separation of concerns.
  • Local JSON Support: Support for file:/// URLs to generate code from local specifications.
  • Standardized Naming: Unified method naming convention (get{{ClassName}}Data).
• CLI Improvements: Added --force flag to api command and improved consistency across all transactional operations.

🐞 Bug Fixes

• DotEnv Asset Registration: Fixed FileNotFoundError by automatically registering .env.dev and .env.prod as assets in pubspec.yaml.
• API Type Safety: Resolved return type mismatches in repository implementations and improved field inference for complex JSON responses.
• Path Handling: Fixed path leakage for test files in monorepo structures by correctly resolving baseDir.
• Template Fixes: Resolved broken interpolation in Riverpod state management templates.

1.2.2

🏗️ Architectural Core & Stability

• Unified Routing Templates: Re-engineered app.dart, main.dart, and app_router.dart for both AutoRoute and GoRouter. Fixed multiple compilation errors where the router field was missing or incorrectly scoped in the MyApp widget.
• Smart DI Registration: Rewrote the DIRegistrar to independently register architecture-specific logic (layers and use cases) and state-management logic (controllers/blocs). This enables flawless cross-compatibility between patterns like Clean Arch + BLoC and MVVM + Provider.
• Context-Aware State Management: Fixed StateManagementGenerator to correctly target the services directory when using MVVM and repositories when using Clean Architecture for BLoC/Cubit.
• Robust Feature Scaffolding: Completed missing file generation for BLoC, GetX, and Provider patterns. Features now generate ready-to-use business logic files with absolute package imports and proper boilerplate.

🐞 Bug Fixes

• Template Placeholders: Replaced direct Dart interpolation with explicit {{archName}}, {{className}}, and {{fileName}} placeholders for reliable generation and custom template support.
• Undefined Name 'config': Fixed a critical bug where the literal string config would appear in generated files instead of resolved values.
• API Strategy Fix: The api command now correctly respects architecture-specific directories (data/repositories vs repositories).
• Freezed Conventions: Corrected the _className factory implementation naming to match internal Freezed standards.
• GoRouter Integration: Fixed the AppRouter class wrapper in GoRouter templates to ensure it can be properly instantiated and injected into the app.

1.2.1

📦 Automated Dependency Management

• Smart Pubspec Updates: Project initialization and feature generation now automatically add required dependencies to pubspec.yaml.
• Automatic Cleanup: Deleting features (like the Chat module) now automatically removes their specific dependencies from pubspec.yaml.
• Plan Preview: Dependency changes are now included in the execution plan for review before applying.

1.2.0

• Interactive CLI Prompts: init command now uses high-end interactive selection for architecture and state management if flags are omitted.
• Smart Code Refactoring: New refactor model command to safely inject fields into existing Freezed models without overwriting logic.

🎨 Design System & Theming

• Theme Generator: New theme command to generate a full premium Design System with Dark/Light mode, semantic tokens, and HSL gradients.
• Theme Extensions: Specialized tokens for Chat and components now part of the default generated theme.

💬 Professional Chat Module

• Socket.io Pro: Resilient real-time engine with connection status, auth tokens, and dedicated event pipelines.
• Message Lifecycle: Full status tick system (Sending -> Sent -> Delivered -> Read).
• Typing Indicators: Real-time "Typing..." feedback in AppBar and Message List.
• Threaded Replies: Native swipe-to-reply logic with quoted context UI.

📚 Documentation & Community

• Documentation Portal: Full overhaul with deep-dive guides for all core modules.
• Support: Added community support link ("Buy Me A Coffee").

1.1.1

🏗️ Major Refactoring & Transactional Engine

• Transactional Architecture: Introduced a new FileAction system. Every command now follows a Plan -> Confirm -> Execute lifecycle.
• Undo / Rollback: Added the undo command to revert the last 10 operations using a persistent history log.
• Modular Template System: Users can now override default templates by placing .template files in .flutter_arch_gen/templates/.
• Refactored Core: Split the monolithic feature_helper.dart into specialized modules (Generators, Registrars, Helpers).

✨ New Commands

• api — Generate Model + Repository + Service from an endpoint URL or spec.
• screen — Generate pre-wired screens (List, Form, Detail) for a feature.
• widget — Generate StatelessWidget or StatefulWidget.
• service — Generate standalone Services.
• repository — Generate standalone repository interfaces and implementations.
• bloc — Generate standalone BLoCs or Cubits with events and states.
• delete — Safely remove a feature and clean up its registrations.
• rename — Rename an existing feature with full import/directory updates.
• migrate — Switch architecture or state management mid-project.
• undo — Revert the last destructive command.

🚀 Improvements & Features

• Dry Run Support: Added --dry-run to all destructive commands to preview changes.
• Monorepo Support: Added --output flag to target specific packages.
• Config Profiles: Support for multiple configurations via --config.
• Enhanced Initialization: init now supports dry-runs, overwrite protection, and automated template setup.
• Routing: Added support for AutoRoute, GoRouter, and standard Navigator registration.
• Fixed redundant imports and improved documentation across the entire package.

🧪 Testing & Quality

• Expanded test suite to 40+ tests covering versioning, config, and string utilities.
• Resolved all lint and static analysis warnings for a 100% clean check.

1.1.0

• Multi-architecture support: Clean, MVVM, BLoC, GetX, Provider
• State management: BLoC, Riverpod, Provider, GetX
• Routing: GoRouter, AutoRoute
• Firebase integration
• Localization support
• Custom feature generation

1.0.2

• Bug fixes and improvements

1.0.1

• Bug fixes and improvements

1.0.0

• Initial release