god_of_flutter_printer 0.1.1

God of Flutter Printer — cross-platform thermal & label printing (ESC/POS, TSPL, ZPL) for Windows, Android, iOS, and Web. USB, Bluetooth/BLE, and network TCP.

God of Flutter Printer

Cross-platform thermal & label printing for Flutter POS apps — ESC/POS, TSPL, ZPL on Windows, Android, iOS, and Web.

One JSON print job from your database → validate → route by platform → print. No printer registry inside the package.

---

Author

Balamurugan · AI Architect · Chennai, India

Email	[e-mail]
WhatsApp	[phone]
Custom solutions	POS printing, multi-platform integrations, Tamil/Hindi receipts, Print Hub setup

Need a custom printer integration, white-label POS printing, or enterprise deployment? Connect on WhatsApp or email — I build tailored Flutter printing solutions.

---

Support this project

If God of Flutter Printer saved you time on your POS app, consider buying me a coffee:

Method	Details
UPI (India)	balamuruganm2102-1@okaxis
Buy Me a Coffee	buymeacoffee.com — search Balamurugan or use UPI above

Your support helps maintain cross-platform printer drivers, BLE/iOS updates, and new template features.

---

Documentation

Guide	Link
Full HTML guide (all platforms)	doc/index.html — open in browser
Markdown integration guide	doc/HOW_TO_USE.md
Monorepo overview	../README.md
Print Hub (web)	../print_agent/README.md

# Open HTML guide (macOS)
open doc/index.html

---

Install

From pub.dev (when published)

dependencies:
  god_of_flutter_printer: ^0.1.1

Local path (development)

dependencies:
  god_of_flutter_printer:
    path: ../god_of_flutter_printer

import 'package:god_of_flutter_printer/god_of_flutter_printer.dart';

---

Quick start

final result = await PrintWorker.instance.printFromMap({
  'type': 'template',
  'templateId': 'tamil_check_80',
  'data': {
    'orderId': 'TA-1001',
    'shopName': 'அகம கடை',
    'total': '200.00',
  },
  'printer': printerRowFromDb,
  'protocol': 'escPos',
  'paperWidthMm': 80,
});

if (result.failedInstantly) {
  showError(result.errorMessage);
} else if (result.isSuccess) {
  showOk('Printed ${result.bytesSent} bytes');
}

---

Platforms

Runtime	USB	Bluetooth	Network (TCP)	How
Windows	Direct	Classic SPP	Direct	Native plugin
Android	USB OTG	Classic SPP (paired)	Direct	Native plugin
iOS	No	BLE	Direct	Native plugin
Web (Chrome)	Via Print Hub	Via Print Hub	Via Print Hub	print_agent

• Web needs printer.hubUrl (Print Hub on counter PC).
• Native apps print directly — no agent.

Full platform setup: doc/index.html#platforms

---

API summary

Method	Use
printFromMap(map)	Primary — JSON from DB/API
printBody(PrintJobBody)	Same, typed
validateJob(spec)	Instant validation, no I/O
listUsbPrinters()	USB discovery (Windows, Android)
listBluetoothDevices()	BT/BLE discovery
probePrintAgent(url)	Web — check Print Hub

Full API: doc/index.html#api

---

Built-in templates

tamil_check_80 · kitchen_kot_80 · invoice_80 · day_close_80

Tamil/Hindi: set options.allowRasterFallback: true (default).

---

Example app

cd example
flutter run -d windows
flutter run -d chrome
flutter run -d <device>   # Android / iOS

---

Publishing checklist (pub.dev)

cd god_of_flutter_printer
dart pub publish --dry-run
dart pub publish

Requires: LICENSE, CHANGELOG.md, README.md, valid homepage / repository URLs.

---

License

MIT License — Copyright © 2026 Balamurugan, Chennai, India.

Permission is granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, subject to the following conditions:

• The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
• THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Full license text: LICENSE
Publisher: wallei.in · Repository: GitHub

---

Made with ❤️ in Chennai · Email · WhatsApp · UPI: balamuruganm2102-1@okaxis