Skip to main content

flowium 1.0.0 copy "flowium: ^1.0.0" to clipboard
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! 🚀

0
likes
150
points
32
downloads

Documentation

Documentation
API reference

Publisher

unverified uploader

Weekly Downloads

A powerful yet simple Flutter state management package that combines the power of BLoC with the simplicity of GetX. Lightweight, performant, and developer-friendly.

Repository (GitHub)
View/report issues

License

MIT (license)

Dependencies

flutter, meta

More

Packages that depend on flowium