flutter_simple_architecture 2.1.0

A robust Flutter bootstrapping tool and project template emphasizing a clean, layer-first architecture with strict state management.

2.1.0

Improvements

• CLI Templates Refinement:
  • Union States: Now generated using sealed class for better exhaustiveness checking with state.when or pattern matching.
  • Sync States: Now generated using abstract class with a private internal constructor (const UIState._()), following the project's entity pattern.
• Consistency: Unified state templates across page and async component generators.
• Robustness: Fixed syntax issues in generated boilerplate for sync state models.

2.0.0

⚠️ BREAKING CHANGES

• Core Rename: ViewBuilder is now AppViewBuilder.
• Terminology Shift:
  • Smart is now Async.
  • Simple is now Sync.
• CLI Flags: fsa generate page --type=smart is now --type=async. fsa generate page --type=simple is now --type=sync.
• Generator Command: fsa generate smart is now fsa generate async.

Improvements

• Renaming: Renamed ViewBuilder to AppViewBuilder to follow core widget naming conventions.
• Terminology Update: Renamed Smart to Async and Simple to Sync for more intuitive architecture guidance. Updated CLI flags and documentation accordingly.
• Architectural Rule: Added a strict rule that AppViewBuilder variants should only be used if the view needs to listen to an initial async task.

1.2.2

• State Management: Pivoted to .autoDispose providers by default across the entire architecture to optimize memory usage and state cleanup.
• Documentation: Updated README.md and GEMINI.md with strict guidelines on when to use Smart, Simple, and Static pages, and the new auto-dispose policy.
• Guidance: Aligned documentation with the new fsa-validator skill heuristics.
• Testing: Fixed widget_test.dart to support ProviderScope and match the new Todo app template.

1.2.1

• Documentation: Updated README.md with strict guidelines on when to use Smart, Simple, and Static pages.
• Guidance: Aligned documentation with the new fsa-validator skill heuristics.

1.2.0

• New Page Types: Added --type flag to fsa generate page supporting smart (default), simple, and static archetypes.
• Architectural Refinement: Reduced boilerplate for simple features by allowing data-class state or stateless pages.
• Internal: Fixed casing logic in generators to support CamelCase inputs correctly.

1.1.0

• New Architectural Pattern: Introduced the SideEffect Notifier for managing non-interactive events (Success, Failure, Info, Warning).
• AppViewBuilder Enhancement: Added the onSideEffect hook to AppViewBuilder for customizable side-effect handling (e.g., SnackBars instead of Dialogs).
• Generator Updates: The CLI now generates Notifiers and Views pre-configured with the SideEffect pattern.
• Improved Scaffolding: Added automatic copying of architecture templates for globally activated CLI usage.

1.0.2

• Fixed template directory resolution when the CLI is run as a globally activated package.
• Improved reliability of fsa create in external directories.

1.0.1

• Improved fsa create bootstrapping logic to ensure all dependencies and configurations are correctly applied.
• Cleaned up lib/main.dart template by removing default Flutter counter boilerplate.
• Added copying of .fvmrc and GEMINI.md to new projects.
• Added automated tests for project bootstrapping.

1.0.0

• Initial release of FSA (Flutter Simple Architecture).
• Integrated CLI tool with create and generate commands.
• Layer-first architecture template including core, domain, and presentation.
• Centralized design system with sealed widgets.
• Functional error handling with fpdart.
• Automated logging with LoggerService.