Rupo
A point-of-sale system for Sri Lankan shops in Sinhala or English: each client is set up in a private builder app and receives their own compiled, licensed POS with its own database.
Small shops in Sri Lanka need a till that speaks their language, prints receipts with Sinhala item names on a cheap thermal printer, and keeps the money right. Rupo is a white-label POS: I configure each shop in a private builder app, and it produces a ready-to-run build for that shop alone, with its branding, tax rules, payment methods and a signed licence. The source and setup logic never leave the builder; each shop runs its own instance on its own PostgreSQL database, on a PC in the shop or on hosting.
Key features
- Fast checkout: barcode scanning, search, categories and parked sales, usable with a keyboard and scanner alone or on a touch screen. Cash, card and LankaQR payments, split payments and change.
- Sinhala or English: every screen, server message, report, CSV and receipt comes from one language catalogue, fixed for the life of each install.
- Receipts on thermal printers: 58 and 80 mm ESC/POS receipts with tax breakdown and barcode. Printers can't print Sinhala text, so it is laid out and drawn as an image.
- Manager approval: refunds, discounts above a limit, voids after payment and selling stock that isn't on record need a manager's PIN.
- Stock: deliveries by barcode scan with unit costs, optional suppliers and purchase orders, stock counts with reasons, and a list of items below zero.
- Shifts and cash-up: opening float, cash in and out, and the counted cash against the expected amount at close.
- Reports and dashboard: sales by day, payment method, category and product with CSV export, and a configurable dashboard of sales widgets.
- Licensing: signed 6-month, 12-month or lifetime licences tied to the shop's address, with a daily check-in and register limits.
The till with a cart, categories and keyboard shortcuts
The same till in Sinhala
Cash payment with change
A refund waiting for a manager's PIN
A receipt with Sinhala item names, tax breakdown and barcode
Receiving a delivery by scan, with unit costs and new selling prices
Shift close with the cash variance
Admin dashboard of sales widgets
Sales report with CSV export
Engineering highlights
- A pnpm and Turborepo monorepo: the POS and the builder are Next.js and Payload CMS apps, and the business logic lives in pure, tested packages for pricing, licences, client configuration, receipt layout and ESC/POS rendering.
- Money is integer cents throughout. The server is the pricing authority: the till's totals are ignored and every sale is recalculated, then written with its stock movements in one database transaction. Sales and stock movements are append-only, so corrections go through refunds and adjustments.
- A one-click build pipeline: the builder starts a GitHub Actions workflow that validates the shop's configuration, embeds it with the branding, builds a standalone Next.js server, obfuscates it, signs the licence, and uploads a checksummed zip to Cloudflare R2 for a short-lived download link.
- Ed25519-signed licences checked on startup and every day, bound to the shop's address, with a grace period for internet outages.
- Shop installs on Windows are one script: it installs Node.js and PostgreSQL, sets up the database, services, firewall rule and nightly backups.
- Tested with Vitest and Playwright, including a full end-to-end pass in each language; the pricing package keeps 100% coverage.