SparkleServer Hub

EXIT

A BLE-powered field utility app built in Flutter for scanning, spoofing, and executing protocol-driven actions in physical spaces. Designed for field teams, simulations, and creative tech workflows.

Directional BLE Scanning

Real-time, filterable scans with token parsing and protocol matching.

Beacon Spoofing

Custom broadcast profiles with rotating/adaptive packets.

Protocol Builder

JSON-defined action sequences for scans, broadcasts, alerts, delays, and execution chains.

Dropkits

Preconfigured protocol blocks and BLE bundles for one-touch launches.

Token Sync + Cloud Hooks

Local token storage with optional cloud integration pathways.

Offline + Debug Ready

Local-first storage, built-in logger, and a live debug overlay.

Protocol-Driven Core

Protocols are JSON-driven lists of actions (scan, broadcast, delay, alert, execute) with optional triggers. The Protocol Executor dispatches each step, and handlers live in dedicated action modules.

Operational Notes

  • Android-first; BLE spoofing is not fully supported on iOS.
  • Supports delivery & affiliate integrations (UberEATS, DoorDash, Instacart, Grubhub).
  • Dropkits enable pre-deployment broadcasts, emergency spoofing, and one-touch triggers.

Tech Stack

  • Flutter + Dart
  • `flutter_blue_plus` for BLE
  • `permission_handler`
  • Custom Protocol Engine (JSON-defined)

Setup & Testing

Run:

flutter pub get
flutter run

Testing:

flutter test

On Windows, if `flutter pub get` fails due to locked files, run `fix_pubget.bat` in the project root.