achiri/barcodepos

BarcodePOS - Sales management for African micro-retailers. Barcode scanning, POS checkout, Google Sheets sync. # BarcodePOS BarcodePOS is a Progressive Web App (PWA) that turns any smartphone into a barcode-scanning point of sale for micro-retailers in Cameroon and across Africa. It combines point-of-sale checkout, inventory management, receipts, and multi-store stock control in a single app — with Google Sheets as a zero-cost, user-owned database backend. All amounts are in FCFA (XAF) by default. The app is fully client-side and offline-first: data is stored in the browser's IndexedDB and synced to your own Google Sheet through a small Google Apps Script web API (`gas/Code.gs`). There is no server backend, no per-user fees, and no data leaves your control — every store connects to its own spreadsheet. ## Key features - **Barcode scanning** — camera-based scanning (html5-qrcode) plus manual barcode entry and product search. - **Checkout (POS)** — scan-to-sell, live invoice with quantity adjustment and a per-item unit price plus Subtotal row, cash / mobile money / bank transfer payments, and automatic change calculation. An optional manager-only setting allows selling out-of-stock items (with a warning). - **Receipts** — printable, shareable (e.g. WhatsApp), and downloadable receipts after every sale, a "🧾 Last Receipt" shortcut to reopen the most recent receipt, and Download / Share / Print for any past receipt. - **Sales history** — filterable history (with a Completed/Voided filter for cancelled sales) and per-sale detail, including re-downloading a receipt and exporting the current view to CSV. - **Voided sales** — cancelling a sale with items records it as voided with a VOIDED badge in Sales History; voided sales never affect stock, dashboard totals, shift summaries, or top-product lists. - **Inventory** — product catalog with categories, cost/selling price, units, and stock levels; managers can archive a product to hide it from lists and checkout, then restore it later. - **Stock alerts** — out-of-stock and low-stock warnings surfaced on the dashboard, plus an opt-i …