flowium 1.0.0
flowium: ^1.0.0 copied to clipboard
A powerful yet simple Flutter state management package that combines the power of BLoC with the simplicity of GetX. Lightweight, performant, and developer-friendly.
Changelog #
All notable changes to the Flowium package will be documented in this file.
1.0.0 - 2024-01-19 #
🎉 Initial Release #
-
✅ Core State Management
- FlowiumController with lifecycle support
- FlowiumState with built-in states (Initial, Loading, Success, Error)
- AsyncFlowiumController for async operations
-
✅ UI Widgets
- FlowiumBuilder for reactive UI building
- FlowiumConsumer for state consumption
- FlowiumMultiConsumer for multiple controllers
- FlowiumSelectiveConsumer for performance optimization
- FlowiumProvider for dependency injection
- FlowiumMultiProvider for multiple dependencies
-
✅ Dependency Injection
- FlowiumDI container with singleton and factory support
- Context extensions for easy access
- Automatic cleanup and disposal
-
✅ Comprehensive Logging System
- FlowiumLogger with multiple log levels (Debug, Info, Warning, Error, Critical)
- State transition logging
- Performance monitoring
- API call logging
- User action logging
- Multiple output options (Console, Memory, File)
-
✅ Clean Architecture Support
- Base entities and value objects
- Repository pattern with logging
- Use case pattern with performance tracking
- Data source abstractions
- Result wrapper for error handling
- Service layer for business logic
-
✅ Developer Tools
- FlowiumDevTools with debugging panels
- Controller inspection
- Log viewer with filtering
- Performance metrics
- Dependency injection management
- Real-time monitoring
🚀 Key Features #
- BLoC-like Power - Strong architecture patterns
- GetX-like Simplicity - Minimal boilerplate
- Riverpod-like Streams - Reactive programming
- Cross-Platform - Android, iOS, Web, Desktop support
- Type Safe - Full generics support
- Performance Optimized - Selective rebuilds
- Developer Friendly - Built-in debugging tools
📦 Package Structure #
flowium/
├── lib/
│ ├── flowium.dart # Main export
│ └── src/
│ ├── flowium_state.dart # State classes
│ ├── flowium_controller.dart # Controllers
│ ├── flowium_builder.dart # UI widgets
│ ├── flowium_consumer.dart # Consumer widgets
│ ├── flowium_provider.dart # DI providers
│ ├── flowium_dependency_injection.dart # DI system
│ ├── flowium_logger.dart # Logging system
│ ├── flowium_architecture.dart # Clean architecture
│ └── flowium_dev_tools.dart # Developer tools
├── example/ # Example app
├── test/ # Tests
├── LICENSE # MIT License
├── CHANGELOG.md # This file
└── README.md # Documentation
🎯 Usage Examples #
Basic State Management
class MyController extends FlowiumController<MyState> {
void updateData() {
emit(state.copyWith(data: 'New Data'));
}
}
Dependency Injection
FlowiumDI().registerSingleton<MyController>(() => MyController());
final controller = context.flowDI<MyController>();
Logging
FlowiumLogger.instance.info('User action', tag: 'ACTION');
FlowiumLogger.instance.logPerformance('Operation', duration);
Developer Tools
MaterialApp(
home: myWidget.withDevTools(),
)
🌍 Platform Support #
- ✅ Android
- ✅ iOS
- ✅ Web
- ✅ Windows
- ✅ macOS
- ✅ Linux
🔧 Dependencies #
- Flutter SDK ^3.9.2
- meta ^1.15.0
🚀 Future Roadmap #
1.1.0 Planned #
-
❌ Enhanced Dev Tools
- Hot reload support
- State history viewer
- Performance graphs
- Export/import configurations
-
❌ Advanced Logging
- Remote logging server
- Log filtering by tags
- Log export functionality
-
❌ More Architecture Patterns
- Repository caching
- Event sourcing support
- CQRS pattern examples
-
❌ Performance Optimizations
- Lazy loading for controllers
- Memory usage monitoring
- Bundle size optimization
-
❌ Developer Experience
- Code generation tools
- Migration helpers
- Better error messages
Flowium - State management made simple yet powerful! 🚀