๐ฆ 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