PRODUCT OVERVIEW
cloudOn-Premise / Cloud

Point of Sale,
Simplified.

A modern cloud POS built for local retail shops. FIFO inventory, customer credit tracking, daily cash closing, and thermal receipt printing — all in one clean interface.

qypos.local
QyPOS Dashboard — Product search and cart
99.9%
Uptime
< 1s
Transaction Speed
FIFO
Inventory Accuracy
Docker
One-Command Deploy

Everything a Retail Shop Needs

Purpose-built for local retail. Simple enough to learn in minutes, powerful enough to run your entire business.

point_of_sale

Smart POS Terminal

Fast product search by name or barcode, instant add-to-cart, and flexible payment methods — cash, online, or credit.

  • Keyboard-first workflow (F2/F8)
  • Cash / Online / Credit payments
  • Change calculation
  • Per-item discounts
inventory_2

FIFO Inventory Engine

First-In-First-Out costing that automatically tracks purchase batches and computes accurate cost of goods sold.

  • Multi-batch purchase tracking
  • Automatic cost calculation
  • Low stock alerts
  • Stock adjustment & damage reporting
people

Customer Ledger

Track credit sales and payments for each customer. Know exactly who owes what, with full transaction history.

  • Credit limit enforcement
  • Payment recording
  • Full transaction history
  • Balance alerts at checkout
receipt_long

Order & Invoice Management

Daily order history with invoice-level detail. Cancel orders to automatically restore stock and reverse ledger entries.

  • Invoice number INV-YYYYMMDD-XXXX
  • Order cancellation with stock revert
  • Receipt preview & thermal printing
  • Payment method filtering
account_balance

Day Closing & Reconciliation

Close the day with expected cash vs actual cash reconciliation. Variance detection and full closing history.

  • Opening float tracking
  • Cash sales reconciliation
  • Variance detection
  • Closing history archive
print

Thermal Receipt Printing

Print receipts on ESC/POS thermal printers over USB or network. Receipt preview before printing.

  • USB & network printer support
  • Receipt preview
  • Printable order history
  • Auto-print on checkout
local_shipping

Supplier & Vendor Management

Track vendor payables, record supplier returns, and manage purchase references for every restock.

  • Vendor balance tracking
  • Supplier return processing
  • Purchase reference tracking
  • Vendor transaction history
bar_chart

Reports & Analytics

Real-time reports on sales, top products, customer balances, vendor payables, and stock adjustments.

  • Daily/monthly sales summary
  • Top-selling products
  • Low stock alerts
  • Stock adjustment & damage logs
admin_panel_settings

Admin & Cashier Roles

Granular role-based access. Cashiers can process sales; admins handle inventory, closing, and settings.

  • Admin / Cashier role separation
  • JWT-based authentication
  • Settings management
  • Audit-ready transaction log

Clean. Fast. Purposeful.

Every screen designed for speed — minimize clicks, maximize throughput.

qypos.local
POS Checkout with cart and payment panel

POS — Cart, Customer Attachment & Payment

qypos.local
Inventory management with FIFO batches

Inventory — Product List with Batch Detail

qypos.local
Order history with cancellation support

Orders — Daily History & Invoice Management

Modern Tech Stack

Built with cutting-edge web technologies. One docker-compose command and you're running.

CategoryTechnology
FrontendNext.js 16 + React 19 + Tailwind v4
BackendNode.js / Express (CommonJS)
DatabaseMongoDB 7.0
AuthJWT (Access + Refresh Tokens)
StateZustand with persist middleware
UI Libraryshadcn/ui (Radix + Base UI)
InventoryFIFO Batch Tracking Engine
PrintingESC/POS Thermal (USB / Network)
TestingJest + Supertest + Playwright
DeploymentDocker Compose (MongoDB + Server)

Why QyPOS

verified

One-Command Deploy

docker-compose up -d starts both MongoDB and the API server. The frontend runs with npm run dev. That's it.

verified

FIFO Costing Built In

Every purchase creates a new batch. Sales deduct from the oldest batch first. Accurate COGS without complex accounting software.

verified

Local-First, Cloud-Ready

Run entirely on your local network with no internet dependency. Or deploy to the cloud for multi-location access.

verified

Full Test Coverage

118 unit/integration tests on the server, 16 E2E tests covering the complete happy path with Playwright.

verified

Offline-Ready Architecture

Server and client run locally. No internet dependency for daily operations. Print receipts on local thermal printers.

Ready to Digitize Your
Shop Operations?

Self-hosted POS that respects your privacy. No monthly fees, no cloud dependency, no data leaving your premises.