Documentation
Getting set up, and what to expect
A shop with a clean product list is usually selling on the same day. Here is the order to do things in, the hardware to buy, and how offline mode behaves once you are running.
Getting started
Six steps from empty to selling
Do them in this order — stock levels and receipts both depend on the stores existing first.
Create your stores
Add each branch with its code, name, address and contact details. Store codes appear on receipts and reports, so pick something your staff will recognise.
Import your catalogue
Upload your existing product list as CSV, XLSX or XLS. Confirm the column mapping we suggest, optionally set a SKU prefix and default cost and selling prices, then review what was created and rejected.
Set stock and reorder points
Record opening stock per branch with a stock-in movement, and set each branch's minimum level per part so low-stock alerts mean something.
Create staff accounts
Add store admins, operators and cashiers from the store screen. Each gets a generated username and a one-time password shown once — copy it before you close the dialog.
Set up receipts
Edit the receipt template for each store, preview it with sample data, and turn on auto-print with the printer name if you want a receipt after every sale without pressing anything.
Install it on the terminal
Open the app in Chrome on the till machine and install it to the desktop or home screen. Sign in once while online so the catalogue downloads to the device — after that it can sell offline.
Hardware
What to buy for the counter
Nothing proprietary and nothing expensive. Standard retail hardware works.
- Computer or tablet — any reasonably current machine running Chrome. A tablet is fine; the POS screen has a dedicated mobile layout.
- Barcode scanner — any USB or Bluetooth scanner that types what it reads, which is nearly all of them. No driver or configuration needed: the scan lands in the search box and Enter adds the item.
- Receipt printer — a standard 80 mm thermal printer. Receipts are sized for it.
- Label printing — shelf labels come out as PDFs, so an ordinary A4 printer works. Sheets are laid out as 50 × 30 mm labels; dedicated 2 × 1 in and 3 × 2 in label sizes are also available.
- No cash drawer integration — worth knowing up front. There is no drawer trigger or shift/Z-report management.
One-touch receipt printing
By default the browser shows a print dialog for each receipt. To skip it entirely on a dedicated till machine, launch Chrome with kiosk printing enabled:
chrome.exe --kiosk-printingSet that on the shortcut the staff use, turn on auto-print for the store, and a receipt comes out on its own after every sale.
Installing on the terminal
Open the app in Chrome and use Install app, or Add to Home Screen on a tablet. It then launches in its own window with no browser chrome. Sign in once while online so the store's catalogue downloads to the device — that first sync is what makes offline selling possible.
Offline mode
What to tell your staff
Three rules cover almost every situation they will meet.
Keep selling
If the connection drops, carry on. Search, scanning, the cart and the receipt all work from the device. The dot next to your name turns grey — that is expected, not an error.
Do not reinstall or clear data
Unsold work lives on the device until it uploads. Signing out is fine and keeps the queue, but clearing browser data or reinstalling before the dot turns green will lose whatever has not synced.
Green dot means done
When the connection returns the queue drains on its own. If the dot turns red, something needs a human: open the sync screen, read the reason, and retry or discard.
A note on stock going negative. If two terminals both sell the last of a part while offline, both sales are kept and the stock figure goes negative. That is deliberate — losing a real sale is worse than a temporarily wrong count. The affected sales are marked for review with the reason attached, so you can correct the count with a stock adjustment once you know what is actually on the shelf.
FAQ
Questions shops ask before they commit
Including the ones with answers you may not want to hear.