Zana POS - Point of Sale System

Zana POS is a complete, fully offline point-of-sale system built with Electron, React, and SQLite (via sql.js). Every sale, product, and report is stored locally on the customer's own computer — no internet connection, backend server, or monthly subscription is ever required. It's built for small to medium retail shops that need a fast, reliable checkout with inventory, debt, and expense tracking built in, and it's easy to re-skin for your own branding or client work.

• 100% offline — all data stored locally, no server or internet dependency
• Fast, keyboard-driven checkout designed for handheld barcode scanners
• Cash and credit (on-account) sales with a full shopping cart
• Item-level and cart-level discounts (percentage or fixed amount)
• Returns/refunds with reason codes and automatic stock restoration
• Instant thermal receipt printing (58mm or 80mm, selectable)
• Automatic, valid EAN-13 barcode generation for new products
• Visual sales reports with PDF and multi-sheet Excel export
• Configurable currency symbol, dark/light theme, automatic backups
• Three-tier role system: Super Admin, Admin, and Cashier

Features

Real-time inventory management with product images and low-stock/expiry alertsPer-cashier performance breakdown (sales, cost, profit) for adminsDebt tracking with partial payments and full payment historyExpense tracking with running totalsFull activity/audit log of every user actionKeyboard shortcuts: Space to checkout, Ctrl+F to search, Ctrl+N for a new itemManual database backup and restore, plus autosave every 30 secondsAutomatic full-screen mode with F11 toggleClean, modern dark-gold UI theme built with Tailwind CSS

Requirements

Node.js 18 or newer (for building/running the app, not required by end users)Windows, macOS, or Linux desktop computerA thermal receipt printer (58mm or 80mm) — optional, for printing receiptsA barcode scanner — optional, a keyboard works fine too

Instructions

Extract the zip and run npm install in the project folderRun npm run dev to launch the app in development mode with hot reloadRun npm run dist to build a distributable installer (.exe for Windows, .dmg for macOS, AppImage for Linux)Log in with the default account: username admin, password admin1234Change the default password immediately from the Users pageSee the included README.md for full customization instructions (branding, colors, currency, text)