Migration to v0.2.3
Guide for Fluxy v0.2.3, featuring the Premium DevTools Overhaul and stability refinements.
Migration to v0.2.3
Fluxy v0.2.3 is a refinement release focused on the Premium DevTools Overhaul and preparing for the 1.0 stability milestone. This version includes significant improvements to the debugging experience and several internal bug fixes.
Major New Features
1. Premium DevTools Overhaul
The Fluxy Inspector has been completely redesigned with a high-end Material 3 aesthetic and high-performance glassmorphism.
- Glassmorphic HUD: Redesigned FAB and inspector shield with smoother blur effects.
- Real-time Update Flashing: Flux/Signal items in the list now briefly flash blue when their value changes, making it easier to track state flow at a glance.
- JSON Prettifier: Direct inspection of network payloads is now much easier with automatic formatting and indentation.
- Advanced Timeline Controls: You can now search, pause, resume, and clear the state update timeline.
- Persistent Search: Search states in the Flux registry, DI container, and Network logs now persist across tab switches.
- Clipboard API: Integrated "Copy to Clipboard" buttons for signal values, network bodies, and log entries.
2. Context-Independent Inspector (v0.2.1+)
The DevTools are now fully self-contained. The framework no longer relies on the application's widget tree context for snackbars or overlays.
- Fixed the "No ScaffoldMessenger found" exception.
- Fixed "No Overlay widget found" and "No MaterialLocalizations found" errors.
Technical Refinements
Layout Safety
The DevTools Floating Action Button (FAB) has been moved up by 60dp to prevent overlap with standard Flutter BottomNavigationBar items, ensuring it doesn't block your app's core navigation.
Search & Live Editing (v0.2.1)
- Flux Search: Quickly filter through hundreds of signals by name or ID.
- Live Value Editing: You can now update
boolean,string, andnumericvalues directly from the inspector, allowing for rapid state testing without hot-reloads.
Performance & Size
- Package Size: Reduced the published package size by ~40% by optimizing the example and internal assets.
- Isolate Safety: Improved crash-resistance in the DI and Network detail views for malformed or large data payloads.
Recommended Upgrade Path
- Update your
pubspec.yamltofluxy: ^0.2.3. - Run
flutter pub get. - If using the CLI, run
dart pub global activate fluxyto ensure your blueprints are up to date. - If you had previously hidden the DevTools due to context errors, you can now safely re-enable them using
Fluxy.debug.
Branding Update
The framework has transitioned to using Flux as the primary branding term for state units, replacing the generic 'Signal' terminology in the DevTools and documentation for better clarity and conflict avoidance.