fast_flows 0.0.2

A light, modern and powerful Flutter framework combining state management, dependency injection, and route management - inspired by GetX but with a cleaner API.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.0.2 - 2026-04-17

Added

• Comprehensive test suite with 281 tests covering all core modules:
  • Flow Dependency Injection tests (17 tests)
  • Lifecycle tests for FlowController (5 tests)
  • Rx types tests (27 tests)
  • RxList tests (14 tests)
  • RxMap tests (13 tests)
  • FlowController/FlowState/FlowLogic tests (14 tests)
  • Flx and FlxValue widget tests (15 tests)
  • FlowPage navigation tests (13 tests)
• Flow.reset() method for testing support
• Test documentation in README.md and README_cn.md

Fixed

• Removed unnecessary override in RxList.value setter to fix lint warning
• Removed unnecessary override in RxMap.value setter to fix lint warning
• Fixed doc comment HTML formatting in rx_types_test.dart

Changed

• Updated README.md with complete English documentation
• Updated README_cn.md with test coverage section
• All tests passing (281/281)
• Flutter analyze: No issues found

0.0.1 - 2026-04-17

Added

• Initial release of Fast Flows framework
• Dependency Injection system with Flow.put, Flow.find, Flow.isRegistered, and Flow.delete
• Reactive State Management with Rx types:
  • Rx<T>, Rxn<T> for generic reactive wrappers
  • RxBool, RxInt, RxDouble, RxString for primitive types
  • RxList<T>, RxMap<K,V> for collections
  • .obs extension for easy reactive type creation
• Route Management with Flow.to, Flow.toNamed, Flow.back, Flow.off, Flow.offAll
• FlowMaterialApp widget for app configuration with theme support
• FlowPage for named route definitions with transition support
• FlowController base class with lifecycle methods (onInit, onClose)
• Flx reactive widget builder
• FlxValue optimized single-value reactive widget
• Logic/State/View architecture pattern support
• Example app demonstrating all features:
  • Counter page with reactive state
  • Home page with UserData editing and theme switching
  • Detail page with route parameter receiving
  • Performance test page with Flx optimization
  • Light/Dark theme switching via global ThemeController
  • Custom app icon configuration
• Comprehensive documentation:
  • README.md (English)
  • README_cn.md (Chinese)
  • CHANGELOG.md
  • CHANGELOG_cn.md
• Multi-platform support:
  • Android
  • iOS
  • Web
  • Windows
  • macOS
  • Linux

Changed

• Package renamed from liteflows to fast_flows to avoid naming conflicts on pub.dev
• Optimized route argument passing to preserve settings.arguments
• Updated default theme colors to cyan/teal (0xFF26C6DA) for brand consistency
• Improved AppBar colors with darker shades for better contrast
• Enhanced example app with editable UserData model
• Refined API design based on GetX inspiration with cleaner syntax

Fixed

• Route arguments not being passed correctly when using FlowMaterialApp
• Theme switching not reflecting in UI
• Type casting issues with nullable UserData parameters
• Static analysis warnings and info messages

Performance

• Single-level observation design for optimal performance
• Zero boilerplate - no StreamControllers, ChangeNotifiers, or InheritedWidgets required
• Efficient widget rebuilding with FlxValue for single-value observation

[Unreleased]

Planned

• Additional Rx operators and utilities
• Middleware support for route navigation
• Enhanced DevTools integration
• More comprehensive test coverage
• Additional example templates

---

Acknowledgments:

This project is inspired by the excellent work on GetX. We want to express our gratitude to Jonny Borges and the GetX community for pioneering reactive state management and dependency injection in Flutter.