Skip to content
White-label Point of Sale

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.
Tools
GitGitHub ActionsCloudflare R2VercelNeonPlaywright
Skills
Next.jsTypeScriptPayload CMSPostgreSQLTailwind CSSZod
All projects