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.

Libraries

fluxy_platform