fluxy_platform 1.1.0

A meta-package for the Fluxy framework that includes the core engine and all official plugins.

fluxy_platform

[BUNDLE] The High-Integrity Meta-Package for the Fluxy framework. Combines the core kernel and all official platform modules into a single architectural authority.

[INSTALL] Installation

Via CLI

# Adds the complete platform bundle
fluxy module add platform

Manual pubspec.yaml

dependencies:
  fluxy_platform: ^1.0.0

---

[BOOT] Unified Initialization

When using the fluxy_platform bundle, you still follow the mandatory three-step boot sequence. The bundle ensures all 10+ internal modules are pre-linked to the registry.

import 'package:fluxy_platform/fluxy_platform.dart';

void main() async {
  // 1. Initialize Kernel
  await Fluxy.init();
  
  // 2. Hook the Unified Registry
  Fluxy.registerRegistry(() => registerFluxyPlugins()); 
  
  // 3. Auto-boot all bundled modules
  Fluxy.autoRegister(); 
  
  runApp(MyApp());
}

---

[USAGE] Concentrated Access

The fluxy_platform package provides a unified Fx.platform interface for all hardware and system services.

// Comprehensive Feature Access
await Fx.platform.auth.login(user, pass);
await Fx.platform.biometric.authenticate();
await Fx.platform.camera.fullView(context: context);
await Fx.platform.storage.set('key', 'value', secure: true);

---

[API] Reference (Bundled Modules)

Module	Purpose	Unified API Snippet
Auth	Identity & Sessions	Fx.platform.auth.login()
Storage	Secure Persistence	Fx.platform.storage.set()
Camera	Hardware Capture	Fx.platform.camera.fullView()
Notifications	Alerts & Scheduling	Fx.platform.notifications.show()
Biometrics	Face/Fingerprint	Fx.platform.biometric.challenge()
Connectivity	Network & Queues	Fx.platform.connectivity.whenOnline()
Permissions	System Access	Fx.platform.permissions.request()

---

[RULES] Industrial Standard vs. Outdated Style

Feature	[WRONG] The Outdated Way	[RIGHT] The Fluxy Standard
Plugin Access	Fx.auth, Fx.camera, etc.	Fx.platform.<module>
Registration	Manual Fluxy.register() calls	Fluxy.autoRegister()
UI Updates	Complex StreamBuilders	Reactive Fx() signal context

---

[PITFALLS] Common Pitfalls & Fixes

1. "Binary size is too large"

• The Cause: fluxy_platform includes all hardware plugins (Camera, Biometrics, etc), which adds cumulative binary weight.
• The Fix: For production, move to Individual Packages using fluxy module add <name> for only the modules you actually use.

2. "Module is missing after add"

• The Cause: Neglecting to call Fluxy.registerRegistry().
• The Fix: Ensure your main() hooks the registry generated by the CLI.

License

This package is licensed under the MIT License. See the LICENSE file for details.