Smart POS-Offline Point of Sale System for Android

✨ Key Features

• True offline billing: Create invoices, apply taxes/discounts, and record payments with no internet.
• Barcode & SKU search: Camera or USB/Bluetooth scanners; fast lookup with cached index.
• Thermal printing (ESC/POS): Print 80 mm/58 mm receipts via Bluetooth/USB/network; customizable templates.
• Inventory on device: Products, variants/units, stock counts, low-stock alerts; CSV import.
• Customer ledger: Basic CRM, due/advance, and invoice history.
• Taxes & pricing: Inclusive/exclusive VAT/GST, price levels, item or bill level discounts.
• Cash drawer & sessions: Open/close shift, cash in/out, X/Z reports.
• Reports: Sales by hour/cashier, item performance, payment mix, day-end summary (PDF/CSV).
• Optional sync: Background sync to a web backend when online (conflict-safe upserts).
• Multi-language & RTL: Localized UI, number formats, and RTL layouts.

⚙️ Technical Stack

• App framework: Flutter 3.x (Dart, null-safety) or Native Android (Kotlin/Java) build variants
• Local database: SQLite (sqflite / Room)
• Printing: ESC/POS over Bluetooth/USB/TCP; PDF via native share/print
• Barcode: Camera ZXing/ML Kit (or mobile_scanner in Flutter)
• Optional sync API: REST (Laravel 10 / Node.js) with JSON and token auth
• Minimum OS: Android 6.0 (API 23)+; 64-bit AAB compliant

🧩 Installation Guide

1. Open the project in Android Studio/VS Code → run flutter pub get or Gradle sync.
2. Brand & configure: App name, icons, currency, tax mode, receipt template, and printer type.
3. Seed data: Import products/customers via CSV (sample provided).
4. (Optional) Sync: Set BASE_URL and token in config.dart/Config.kt.
5. Test peripherals: Pair Bluetooth printer/scanner → test scan → print demo receipt.
6. Build release: Generate signed AAB, enable ProGuard/R8, complete Play Data Safety form.

📦 Deliverables

• Complete Android POS source code (Flutter or Native variant)
• Local DB schema, DAO/repository layer, and seed/import tools
• Receipt templates (58/80 mm) and printer adapters (BT/USB/TCP)
• Barcode scanning module + SKU search
• Report generators (PDF/CSV) and Z-report flow
• Sample CSVs (products, customers, taxes)
• Quick-start docs + GPL license & redistribution notice

📱 Supported Platforms

• Android devices: Phones, 7–10″ tablets, and Android POS terminals
• Printers: ESC/POS 58/80 mm (Bluetooth/USB/Network)
• Scanners: Camera, Bluetooth HID, or USB HID barcode scanners

🧠 Notes

• License: Distributed under the GPL for learning, audits, and derivative works.
• Customization (Expertise): Map tax profiles per outlet; create “quick keys” for fast-moving items; add background sync with exponential backoff; enable role-based lock for refunds/voids.
• Performance: Pre-index barcode/SKU columns; debounce scanner input; pre-render receipt lines for instant print.
• Data safety: Encrypt local DB (SQLCipher optional); schedule automatic local backups; export day-end to USB/Drive.
• Store SEO: Use keywords “offline POS,” “cash register,” “barcode billing,” “thermal receipt” in the Play listing; add printer compatibility list.

👨‍💻 Original Developer Credit

This description acknowledges the original Smart POS (Offline) author(s) as listed on marketplaces such as
CodeCanyon.
Please support the original developer if your deployment requires their commercial license, updates, or premium support.

🔒 Disclaimer

Provided for educational and evaluation purposes under the GPL.
You are responsible for local tax and receipt compliance, privacy policies, and any payment/printing device certifications in your region.
Third-party brand names and sample data remain the property of their owners. No demo links are included.