Why Fluxy?

Fluxy is not just another state management library. It is a "Managed Application Platform" for Flutter that unifies state, networking, dependency injection, and industrial-grade platform modules into a single, cohesive engine with a modular architecture (v1.2.0).

While other libraries solve one problem (e.g., Riverpod for state, Dio for networking, GetIt for DI), Fluxy solves the entire development lifecycle by providing a Unified Platform Layer with modular packages.

What's New in v1.2.0

Industrial Engine

• Context-Aware Flex Safety: Prevents ParentDataWidget crashes automatically
• Alignment Aliases: Full compatibility with Flutter's alignment properties
• Hot-Reload Routing: Dynamic route provider for seamless development
• Reactivity Tracker: Real-time audit of signal usage in builds
• Inferred Alignment: Smart centering in box widgets

Modular Architecture

• Smaller Core Package: Focused & lightweight foundation
• 19+ Modular Packages: Add only features you need
• Independent Versioning: Each module evolves separately
• Migration Support: Seamless upgrade from v1.0.x

Professional Logging System (v0.2.6)

• Semantic Tags: [KERNEL], [SYS], [DATA], [IO]
• Standardized Levels: [INIT], [READY], [AUDIT], [REPAIR], [FATAL], [PANIC]
• ASCII Framing: Clean diagnostic summaries
• Experimental Guardrails: Clear warnings for OTA, SDUI, Cloud CLI

Platform Era (v0.2.5)

• Managed Runtime Architecture: FluxyPluginEngine
• Unified Platform API: Fx.platform for centralized access
• Auto-Registration: Fluxy.autoRegister() for zero-config setup

At a Glance Comparison

The "Platform Era" Vision

Fluxy moves beyond being a framework and becomes a Platform.

1. Unified Platform API (Fx.platform)

All core heavy-lifting (Authentication, Permissions, Storage, Camera, Notifications) is now centralized under the Fx.platform namespace. This ensures that as underlying plugins evolve, your application code remains stable and unified.

2. Managed Runtime Architecture

With Fluxy.autoRegister(), the framework handles the wiring of all installed platform modules effortlessly. No more manual Fluxy.register() calls for every plugin.

3. Stability Kernel™

Fluxy is the first Flutter framework to include a Stability Kernel that proactively detects, intercepts, and auto-repairs common crashes like "Infinite Constraint" violations or "Async Dispose Races."

4. Professional Logging System (v0.2.6)

Fluxy v0.2.6 introduced an industrial-grade logging system that replaces emoji-based logs with semantic bracketed tags:

// Professional Log Tags
[KERNEL] [SYS] [DATA] [IO]    // System components
[INIT] [READY] [AUDIT] [REPAIR] [FATAL] [PANIC]  // Log levels
[EXPERIMENTAL]               // Experimental features

Key Features:

• Semantic Tags: Clear categorization of log messages
• Standardized Levels: Consistent severity indicators
• ASCII Framing: Clean diagnostic summaries without visual clutter
• Experimental Guardrails: Clear warnings for advanced features

The Fluxy Solution

Fluxy provides all these essentials as First-Class Citizens that are designed to work together.

1. Unified Reactivity

State triggers UI updates. Network requests trigger state. Fluxy's Flux<T> is the universal language.

// Networking directly feeds State
final users = fluxAsync(() => Fx.http.get('/users'));

// State directly feeds UI
Fx(() => users.on(
  data: (list) => UserList(list),
  loading: () => Fx.loader.shimmer(),
  error: (e) => ErrorView(e),
))

2. Architectural Authority

Fluxy enforces a clean, scalable architecture with Controllers and Repositories.

• FluxController: Lifecycle-aware logic (onInit, onReady, onDispose).
• Modules: Standardized platform features added via fluxy module add <name>.

3. Atomic Styling DSL

Stop wrestling with nested Container and Decoration objects. Fluxy's atomic DSL allows you to style standard Flutter widgets with chainable modifiers.

Flutter:

Container(
  padding: EdgeInsets.all(16),
  decoration: BoxDecoration(
    color: Colors.blue,
    borderRadius: BorderRadius.circular(8),
    boxShadow: [BoxShadow(blurRadius: 10)],
  ),
  child: Text("Hello"),
)

Fluxy:

Fx.text("Hello")
  .p(16)
  .bg(Colors.blue)
  .rounded(8)
  .shadow.md()

Migration Cheat Sheet

Coming from another framework? Here is how familiar concepts map to Fluxy.

From Provider / Riverpod

From GetX

From Bloc

Conclusion

Choose Fluxy if you want:

• A Managed Platform (State, UI, Net, DI, Modules).
• To write 70% less glue code.
• Proactive Stability Guards to prevent production crashes.
• A consistent, unified API for your entire enterprise application.

Explore the Flutter to Fluxy Dictionary →