๐Ÿ“ฆ BlueThermal Plus --- Flutter Bluetooth Thermal Printer Plugin

A high-performance Flutter plugin for printing to thermal printers over Bluetooth Low Energy (BLE) and Bluetooth Classic (SPP) on Android and iOS.

Built with a clean transport-layer architecture for reliability, scalability, and production-grade stability.

โœจ Features

  • BLE printing with MTU-aware chunking\
  • Bluetooth Classic (SPP) support\
  • Automatic MTU negotiation\
  • Smart data chunking & retry system\
  • Auto-disconnect after print\
  • Real-time device discovery events\
  • Unified transport interface\
  • Production tested

๐Ÿ“ฑ Supported Platforms

Platform BLE Classic


Android โœ… โœ… iOS โœ… โš ๏ธ (BLE only)

๐Ÿง  Architecture

Flutter โ†’ TransportRouter โ†’ PrinterTransportManager โ†’ (BleTransport / ClassicTransport)

๐Ÿš€ Installation

dependencies:
  blue_thermal_plus: ^1.0.0

๐Ÿ“ก Basic Usage

final printer = BlueThermalPlus();
printer.startScan();
printer.connect(deviceId);
printer.printRaw(bytes);

โš™๏ธ BLE Config Example

printer.configure({
  "chunkSize": 200,
  "chunkDelayMs": 10,
  "autoDisconnectMs": 3000
});

๐Ÿ“ข Events

scanStarted, deviceFound, connected, ready, status, error, disconnected

๐Ÿงช Testing

Flutter contract tests + native core logic + real device integration.

๐Ÿ‘จโ€๐Ÿ’ป Author

Mateus Polonini Cardoso

๐Ÿ“„ License

MIT