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.