blue_whale 1.0.0
blue_whale: ^1.0.0 copied to clipboard
A clean, scalable, and refreshingly intuitive state management, dependency injection, and navigation plugin for Flutter. Dive into a smoother development experience!
0.0.3 #
A massive update introducing the "Signals" paradigm, a CLI tool, memory safety with WhaleScope, and deep DevTools diagnostics.
New Features #
- Functional Reactivity: Introduced
state(),View(),mutate(), andderive()for a minimalist, signal-based DX. - Whale CLI: New command-line tool for scaffolding features (
dart run blue_whale create tank <name>). - WhaleScope: Scoped dependency injection that automatically cleans up memory when widgets are disposed.
- Whale DevTools: Real-time console diagnostics for tracking state mutations and UI rebuilds (
Whale.enableDevTools()). - Persistent State: Automatic local storage syncing with
persistentState('key', value). - Naming Aliases: Standard technical aliases like
Signal,Controller,Store, andInjectorfor easier adoption.
Improvements & Fixes #
- Performance: Optimized the dependency graph to O(affected nodes) for lightning-fast UI updates.
- Batching: Implemented
mutate()to suppress redundant UI repaints during multiple state updates. - Async Handling: Simplified
AsyncPodwith.obx()for cleaner loading/error states. - Architecture: Refined the internal
Reefengine for better stability and predictable teardowns.
0.0.1 #
Initial release of Blue Whale – Intuitive State Management for Flutter.
Features #
- State management using
WhalePod<T>for reactive state andWhaleCurrent<T>for stream-based state. - Dependency injection with
Reef.i.put(),lazyPut(),factory(), anduse<T>(). - Navigation via
BlueWhale.navigatorusing contextless named routes with argument support. - Overlays using
BlueWhale.overlaysto display dialogs, snackbars, and bottom sheets. - UI composition with
WhaleSurface,WhaleBuilder, and lifecycle-awareWhaleTank. - Internationalization (i18n) support using
WhaleTranslationsand the.bwTr()extension. - Clean and intuitive architecture with minimal boilerplate.
Testing #
- Core features are covered by integration tests.
- A sample app is included in the
/exampledirectory.