nexora_sdk 1.0.0

A high-performance Flutter SDK providing native-level hardware access (Camera, Bluetooth, GPS) with responsive UI system and zero-lag architecture.

Nexora SDK 🚀

Native Power, Flutter Simplicity

A high-performance Flutter SDK providing native-level hardware access (Camera, Bluetooth, GPS) with an internally managed responsive UI system and a zero-lag architecture.

Stop struggling with complex native integrations. Nexora SDK uses pure Platform Views internally while wrapping everything inside a stunning 1-line API for Flutter.

---

🌟 Features

• Native Camera View: Zero-lag CameraX (Android) and AVFoundation (iOS) feeds rendered completely natively, with simple Flutter overlays on top.
• Auto Bluetooth: BLE scanning, connection bounds, and streaming with pre-configured optimized chunking.
• Real-Time GPS: High-frequency, battery-friendly GPS location updates mapped natively.
• Smart Modes: Let the SDK automatically manage lifecycles, memory purging, and background throttling with Auto Mode.
• Enterprise-Grade: Completely eliminates Flutter garbage collection lag on heavy processes (like binary streams and live image rendering).

---

📦 Installation

Add the dependency to your pubspec.yaml:

dependencies:
  nexora_sdk: ^1.0.0

Don't forget to request standard permissions in AndroidManifest.xml and Info.plist (e.g., Camera, Location, Bluetooth).

---

⚡ Quick Start (The Magic 1-Liners)

Initialize the SDK once in your main() method:

void main() {
  NexoraSdk.initialize();
  NexoraSdk.enableAutoMode(); // Auto-manages lifecycle & throttling
  runApp(const MyApp());
}

Now use hardware anywhere seamlessly.

Live GPS Tracking

// Auto-requests permissions and starts native engine based on AutoMode
await NexoraSdk.startGPS();

NexoraSdk.gpsStream.listen((location) {
  print('Tracking live: ${location.latitude}, ${location.longitude}');
});

Bluetooth Device Scanner

await NexoraSdk.startBluetoothScan();

NexoraSdk.bluetoothStream.listen((device) {
  print('Found awesome BLE device: ${device.name}');
});

---

📸 Native Camera Example

Unlike standard flutter camera packages that drag frame bytes across the Method Channel, Nexora uses PlatformViews to completely offset rendering natively, maintaining absolute 120hz smoothness.

import 'package:nexora_sdk/nexora_sdk.dart';

Widget cameraScreen() {
  final controller = HardwareCameraController();

  return HardwareCameraView(
    controller: controller,
    // Add ANY Flutter UI safely on top of Native Render
    overlay: Center(
      child: ElevatedButton(
         onPressed: () async {
            final bytes = await controller.capturePhoto();
            print("Captured super fast!");
         },
         child: Text("Scan Now"),
      ),
    ),
  );
}

---

🔴 Advanced Usage (Total Control)

If you need system-level control over exactly how the native engines are executing, bypass the 1-liners and use the sub-module configs:

// Launch the GPS with an aggressive profile!
await NexoraSdk.gps.start(
  config: GpsConfig(
    accuracy: GpsAccuracy.high,
    intervalMs: 500, // Very fast!
    distanceFilterMeters: 0,
  ),
);

---

🔧 Performance Benefits

1. Zero UI Blocking: Nexora SDK offloads 100% of the byte-handling overhead to CameraX and AVFoundation via Platform Views.
2. Auto Throttling: When enableAutoMode() is active, the SDK natively binds to your App's Lifecycle Events (via OS hooks). When your user sends the app to the background, Nexora powers off the Bluetooth chip, stops the Camera lens, and throttles the GPS to conserve battery, firing back to life instantly on resume!

---

📷 Screenshots

(Replace with production links when hosted)