📋 Quick Navigation
Why Lucky Store? ·
Screenshots ·
Customer Storefront ·
Features ·
Tech Stack ·
Quick Start ·
Deployment ·
Contributing
🤔 Why Lucky Store POS?
Lucky Store POS is purpose-built for the reality of Bangladeshi retail: intermittent internet, bKash dominance, thermal label culture, and the need for both Bangla and English at the counter.
| Feature | Lucky Store POS | Traditional POS | Cloud-Only POS |
|---|
| Offline Mode | Full offline with Drift SQLite; auto-syncs when back online | Paper-based fallback only | Stops working completely |
| bKash Payments | Native bKash checkout built into the POS flow | Manual reconciliation | Not available |
| SSLCommerz Cards | Integrated card + mobile banking gateway | Separate terminal required | May support, generic |
| Bluetooth Label Printing | MHT-P29L TSPL, Code128 barcodes, 40x30mm labels | Manual price tagging | Not supported |
| Bangla Interface | English + Bangla with HindSiliguri font throughout | English-only | English-only |
| Competitor Price Monitoring | AI-powered scraping of Shwapno, Chaldal | Not available | Not available |
| Multi-Tenant Security | Supabase RLS with tenant isolation per store | Basic auth only | Basic auth only |
| Deployment | Hostinger storefront, Vercel admin/previews, APK sideload | Complex server setup | Vendor lock-in |
| Cost | Free & Open Source (Apache 2.0) | License fees + hardware | Monthly SaaS fees |
| Realtime Inventory | Supabase realtime subscriptions; low-stock alerts | End-of-day manual counts | Polling-based only |
📸 Screenshots
💻 Admin Dashboard (React + Vite)
| Dashboard | Products | Inventory |
|---|
| | |
| Sales analytics, revenue trends & key metrics | Category-based product grid with thumbnail images | Real-time stock with low-stock indicators |
| Supplier Ledger | Collections | POS Quick Sale |
|---|
| | |
| Supplier payables with aging breakdown | Overdue customer follow-ups & payment tracking | Fast counter checkout with barcode lookup |
📱 Mobile App (Flutter) — Coming Soon
Mobile screenshots are being captured. Download the APK from GitHub Releases to see the Flutter POS app in action.
✨ Features
📱 Mobile POS (Flutter)
| Sales Management | Barcode Scanning | Offline Mode |
|---|
| Cash, bKash, Card & Credit payments | Camera-based (Code128, EAN-13, QR) | Drift SQLite with background sync |
| Inventory Tracking | Label Printing | Localization |
|---|
| Real-time stock + low-stock alerts | MHT-P29L Bluetooth, TSPL, 40×30mm labels | English + Bangla (HindSiliguri font) |
| PIN-Based Auth | Manager Dashboard | Store Operations |
|---|
| Staff PIN via Supabase RPC | Close review, risk analytics, session summaries | Open/close shifts, cash reconciliation |
- Drift (SQLite ORM) for full local product catalog, cart, and sale recording
- Background sync via WorkManager + flutter_background_service
- Conflict resolution with idempotency keys and server-authoritative override
- Feature toggle:
ENABLE_OFFLINE_MODE=true
- Cash — default tender with change calculation
- bKash — native mobile banking checkout flow
- SSLCommerz — card payments (Visa, Mastercard) + mobile banking gateways
- Credit — customer ledger posting for deferred payment
- Split payments — multiple tenders per sale
- Bluetooth connection via
flutter_blue_plus
- TSPL command format for MHT-P29L thermal printers
- Code128 barcode generation via
barcode_widget
- 40×30mm labels with MRP strikethrough pricing
- Bulk printing from CSV files
- Print retry queue for reliability
- Camera-based scanning via
mobile_scanner package
- Supports Code128, EAN-13, and QR code formats
- Instant product lookup in POS flow
- Auto-barcode generation (EAN-13) on product import
💻 Admin Web (React + Vite + TypeScript)
| Analytics Dashboard | POS Checkout | Product Management |
|---|
| Sales trends, Recharts charts, low-stock alerts | Cart checkout, barcode lookup, receipt preview | Category thumbnails, grid/list toggle, image upload |
| Inventory Control | Finance Ledgers | Collections |
|---|
| Real-time stock, adjust/history, status badges | Supplier payables + Customer receivables with aging | Overdue follow-ups, payment tracking |
| Purchase Management | Expense Tracking | PWA Support |
|---|
| Purchase entry, receiving, history | Pie/bar charts, 6 categories, 4 payment types | Installable on any device, offline caching |
| Delivery Orders | Social Posting | Staff Dashboard |
|---|
| Order tracking & fulfillment | Facebook Pages API integration | Staff PIN auth & session management |
| Competitor Prices | Import Wizard | Reports |
|---|
| Shwapno/Chaldal price comparison | CSV/Excel product + party import | Sales, finance, inventory reporting |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
