PROFESSIONALLY ADD A COMPLETE UNIVERSAL BILL PRINTING SYSTEM TO MY APP “TS PRICE MANAGER” WITHOUT BREAKING EXISTING UI, FIREBASE, ANALYTICS, BILLING SYSTEM, CLOUD SYNC, THEMES, OR MOBILE PERFORMANCE.

The printing system must be FAST, SIMPLE, STABLE, MODERN, MOBILE-FRIENDLY, AND PRODUCTION READY.

==================================================

1. MAIN GOAL
   ==================================================

Add ONE-CLICK BILL PRINTING SYSTEM.

User should:
• create bill
• tap ONE print button
• instantly print receipt/bill

The system must support:
• Bluetooth thermal printers
• USB printers
• OTG-connected printers
• WiFi printers
• Standard mobile printers
• 58mm thermal printers
• 80mm thermal printers

Must work on:
• Android devices
• Different mobile brands
• Different printer brands

Design system in scalable way for future expansion.

==================================================
2. UNIVERSAL PRINTER SUPPORT
============================

Create a UNIVERSAL printer compatibility layer.

Support:
• ESC/POS thermal printers
• Generic Bluetooth printers
• USB OTG printers
• Wireless/WiFi printers

The app should:
• auto detect supported printers
• reconnect saved printer automatically
• remember previous printer
• allow switching printers easily

Printer connection methods:
(A) Bluetooth
(B) USB / OTG
(C) WiFi/IP Address

Requirements:
• stable connection
• fast printing
• retry on failed print
• loading indicators
• connection status
• printer pairing UI

==================================================
3. PRINT BUTTON SYSTEM
======================

After bill generation:

Show:
[ Print Bill ]

One tap should:
• instantly open printer selection if no printer connected
• otherwise directly print

Fast cashier workflow required.

Add:
• print preview option
• reprint option
• multiple copies option

==================================================
4. CUSTOM PRINTER SETTINGS MENU
===============================

Create NEW section in menu section:

“Printer Settings”

Design premium modern settings page.

==================================================
5. PRINTER SETTINGS FEATURES
============================

Inside Printer Settings provide:

(A) CONNECT PRINTER
• Scan Bluetooth printers
• Detect USB printers
• Add WiFi printer manually
• Save connected printer

(B) PAPER SIZE
Options:
• 58mm
• 80mm
• Custom Width

(C) FONT SETTINGS
• Small
• Medium
• Large
• Bold title

(D) STORE HEADER SETTINGS
User can customize:
• Store Name
• Address
• Phone Number
• GST Number (optional) 
• Footer Message

(E) LOGO SUPPORT
• upload store logo
• print logo at top

(F) PRINT ALIGNMENT
• left
• center
• right

(G) QR CODE SETTINGS
• Enable QR
• UPI QR support
• Payment QR support

(H) AUTO PRINT
Toggle:
• automatically print after bill generation

(I) DUPLICATE COPIES
User selects:
• 1 copy
• 2 copies
• custom copies

(J) LANGUAGE SUPPORT
Printing should support:
• English
• Hindi
• Marathi
• Hinglish-compatible text

(L) DATE/TIME FORMAT
Customizable:
• 12hr / 24hr
• DD-MM-YYYY
==================================================
6. BILL DESIGN FORMAT
=====================

Printed bill must look PROFESSIONAL and CLEAN.

At top:
• Store Logo
• Store Name
• Address
• Phone Number
• GST Number (optional)

## Then:

Bill Number
Date
Time
Customer Name (if available)

---

ITEM TABLE

Columns:
• Item Name
• Qty
• Rate
• Total

---

Then:
• subtotal
• discount
• tax (if available)
• final total

Then:
• payment mode
• received cash
• returned change

Then:
Footer:
“Thank You Visit Again”

Optional:
• QR code
• custom footer message

==================================================
7. ADVANCED CASHIER FEATURES
============================

Add:
• quick print after payment
• print from bill history
• reprint old bills
• share PDF bill
• download PDF invoice
• thermal optimized formatting

==================================================
8. BILL HISTORY INTEGRATION
===========================

Connect printing system with:
• bill history
• analytics
• revenue tracking
• profit tracking

Store:
• print timestamp
• number of prints
• reprint history

==================================================
9. PDF + THERMAL HYBRID SUPPORT
===============================

User can choose:
(A) Thermal Print
(B) Save PDF
(C) Share PDF
(D) WhatsApp Share

PDF should:
• match thermal bill structure
• mobile friendly
• A4 printable

==================================================
10. PERFORMANCE REQUIREMENTS
============================

Printing system must:
• work offline after bill generation
• print instantly
• avoid lag
• avoid app freeze
• support 8000+ bills
• support long & very long item lists

Use:
• optimized queue system
• async printing
• lightweight rendering

==================================================
11. MOBILE EXPERIENCE
=====================

Optimize for:
• one hand usage
• fast cashier workflow
• touch-friendly buttons
• low-end Android devices

Add:
• haptic feedback
• smooth animations
• modern transitions

==================================================
12. ERROR HANDLING
==================

Add professional error handling.

Examples:
• printer disconnected
• paper unavailable
• Bluetooth off
• print failed
• USB permission denied

Show:
• clean user-friendly popup
• retry button
• reconnect button

==================================================
13. SECURITY & STABILITY
========================

IMPORTANT:
• Do NOT break existing app
• Do NOT affect Firebase Authentication
• Do NOT affect Vercel deployment
• Do NOT affect analytics
• Do NOT affect cloud sync
• Maintain existing UI themes
• Maintain app performance
• Prevent duplicate React key warnings
• Ensure stable rendering
• Ensure production-ready implementation

==================================================
14. FUTURE READY STRUCTURE
==========================

Design architecture scalable for future features:
• GST invoices
• barcode printing
• kitchen printing
• multi-counter billing
• multi-printer routing
• customer digital receipts

==================================================
15. FINAL GOAL
==============

The final printing experience should feel like a REAL PROFESSIONAL POS SYSTEM used in modern retail stores, kirana shops, dry fruit shops, wholesalers, and supermarkets.

Focus on:
• speed
• simplicity
• reliability
• professional appearance
• universal compatibility
• mobile-first design