OpenPOS

Overview

OpenPOS is a lightweight offline POS. This manual covers setup, day-to-day operations, backups, recovery, and troubleshooting.

Setup

1. Open index.html in a modern browser (Chrome, Edge, Firefox). For installable app, host the folder on GitHub Pages so the PWA prompt appears.
2. Click "Get Started" and create the first Admin account. Provide answers to three security questions — these are used for password reset.
3. Open Settings to choose Theme, Language, and Currency. These settings persist across sessions.

Users & Roles

Create users from the Users page (admins can create managers and cashiers). Roles control access; only admins can manage users and settings.

Products & Categories

1. Go to Products, fill name, SKU, category and price, then Add.
2. Use the search box in Checkout to find items by name or SKU.
3. Products export and import with Backups.

Customers

Add customers to the Customers page. When checking out, click Select/Add to choose or create a customer for the sale.

Checkout

1. Search or tap a product to add to cart.
2. Update quantities using the cart controls, then Complete Sale to record the transaction.
3. Sales are stored locally in IndexedDB and included in backups.

Backups & Recovery

Use Settings → Export Backup to download a JSON backup. Export can be encrypted with a password. To restore, use Import Backup and provide the password if encrypted.

For password recovery, export the Recovery File from Settings and keep it secure. The in-app reset requires answering at least two of the three security questions set at account creation.

PWA & Install

When run from GitHub Pages the browser will offer to install the app. Installing gives a standalone window and better offline caching.

Troubleshooting

• If data disappears after clearing browser storage, restore from your exported backup or recovery file. For stronger persistence, use Settings → Save backup to file (persistent) which writes the database JSON to a file on your disk. That file remains even if the browser clears site data.
• If the service worker blocks updates, open DevTools → Application → Service Workers and unregister, then reload.
• If camera scanning fails, ensure the page is served over HTTPS (or localhost) and the browser has camera permission.