blue_thermal_helper 1.0.7
blue_thermal_helper: ^1.0.7 copied to clipboard
Reusable Flutter helper for Bluetooth thermal printer (ESC/POS)
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
1.0.7 - 2026-01-22 #
Added #
- Enhanced
row()Method- Added optional
boldparameter torow()method for bold text styling - Added optional
sizeparameter torow()method for font size control (usingThermalFontSizeenum) - Allows more flexible formatting of two-column rows without using
rowColumns()directly - Example:
receipt.row('Total', '100000', bold: true, size: ThermalFontSize.large)
- Added optional
1.0.6 - 2026-01-22 #
Added #
- Extra Small Font Size Support
- Added
ThermalFontSize.extraSmallenum value - Uses alternative font (fontB) for smaller text rendering
- Useful for detailed information like long addresses, footnotes, or disclaimers
- Example usage in sample app for address and footer text
- Added
Changed #
- Updated example app to demonstrate
extraSmallfont size usage - Enhanced documentation with font size examples
1.0.5 - 2026-01-22 #
Improvements #
-
Code Quality Improvements
- Removed code duplication: consolidated
formatMoney()andwrapText()into shared utilities - Refactored internal structure: moved models to
lib/src/models/ - Moved utilities to
lib/src/utils/(internal, not exported) - Cleaned up example app: removed commented code, improved formatting
- Standardized naming conventions throughout codebase
- Removed code duplication: consolidated
-
Documentation
- Added comprehensive dartdoc comments to all public APIs
- Improved code examples in documentation
- Added detailed parameter descriptions
- Enhanced README with better examples
-
API Improvements
- Better separation of public vs internal APIs
- Cleaner export structure in main library file
- More consistent error handling
Fixed #
- Import issues in example app
- Inconsistent formatting in example code
Internal #
- Created
lib/src/utils/formatting_utils.dartfor shared utilities - Created
lib/src/models/bluetooth_printer.dartfor printer model - Created
lib/src/models/thermal_paper.dartfor paper configuration - Removed duplicate files:
printer_paper.dart,receipt_util.dart,receipt_preview.dart
Notes #
- This is a non-breaking release
- All existing code will continue to work without changes
- Internal refactoring improves maintainability without affecting public API
1.0.4+1 Previous #
- Update README
1.0.4 Previous #
- Add Request Enabling Bluetooth ON
1.0.3 Previous #
- Bug Fix Logo Function
1.0.2 Previous #
- Update README
1.0.1 Previous #
- Update README
1.0.0 - 2026-01-06 #
Features #
- BlueThermalHelper core helper
- Scan, connect, disconnect Bluetooth printer
- ThermalReceipt builder abstraction
- ESC/POS real printing support
- Receipt preview (text-based)
- Support paper size via enum (58mm / 80mm)
- Money formatting with auto-alignment
- Auto-wrap item name
- Print receipt from JSON data
Bug Fixes #
- Preview width mismatch with 58mm paper
- Money column alignment edge cases
- Connection status not updating in UI
Release Notes #
- Initial public release
- Tested with 58mm thermal printer
✅ Compatibility #
Tested on Flutter 3.38.5 with real android devices Oppo Reno 14 and PANDA Thermal Printer PRJ-R58B