Every feature, step by step.
ہر فیچر، قدم بہ قدم۔

English

1. Download the APK from the homepage on the Android phone that will be Main (the shop server).
2. Allow installs from this site when Android asks.
3. Open Order Flow → tap the WhatsApp button or paste your 16-character license key.
4. The first phone that activates the key becomes Main — the key binds to it.
5. Main runs the shop server on Wi-Fi port 8787. Keep the app open; do not swipe it away.
6. Main works up to 48 hours offline after a valid check. If the key is revoked, Main locks and shows WhatsApp support.

English

Other phones on the same Wi-Fi join free — they do not need a key.

1. On the new phone: License screen → Connect to Main.
2. Type the IP shown on Main's Home screen, or scan the QR code.
3. Pick a role: Manager, Order taker, Kitchen, Cashier, Stock clerk, Front desk, Specialist, Driver.
4. Each station has its own queue and syncs live with Main. If the connection drops, the station queues its work and flushes when Main is reachable.
5. Switch roles anytime from a station with the logout button, or cover any role from Main's account-switch menu.

English

More → Business model (Main only). The app reshapes itself for each business:

• Restaurant — table map, kitchen tickets, courses (starter / main / dessert), reservations.
• Retail — register queue, SKU barcode scanning, stock cards, quick retail sale.
• Fast food — queue numbers, takeaway, kitchen fire.
• Services — appointments, specialists, service menu with duration.

Changing the model keeps your menu, stock and customers.

English

1. v1.1.91 — Phone app ↔ Web app cloud rooms now fully talk: a station can join a Cloud room from the Android/Windows app while the Main runs in the browser at jathol.org (or the other way round). Staff names + PINs, the Manager PIN, tables, menu, prices and live orders now translate both directions — before, mixed phone/web rooms silently dropped each other's messages. On the web: More → Staff now also holds a Manager PIN (same format as the APK), stations can verify it over the room, and manager actions on a station always ask for it.
2. New in 1.1.91 — Menu Scan: Menu tab → scanner icon → take a photo of the menu (or upload a menu PDF). Names, prices and categories are read on the phone itself — no internet, nothing uploaded anywhere.
3. v1.1.91 — imports no longer dead-end: a price in the middle of a row (size or unit after it) no longer loses the item, and when a page's price style can't be matched at all the review sheet still lists every readable dish line with a blank price — tick what you want, type prices, import. Rows read without a price arrive unticked on purpose, so only what you confirm enters the menu.
4. v1.1.91 — PDF reading fixed: PDF pages were being scanned on a transparent canvas, which the text recognizer reads as a blank image — now every page is painted on white paper first, so typed and scanned PDF menus produce items again. Pressing Import with nothing ticked now tells you, instead of doing nothing.
5. In the review sheet that opens: un-tick any wrong line, tap a name or price to fix it, choose the category, add anything missed — then Import creates all of it in one tap. Items already on the menu are skipped automatically.
6. Works best with English / Malay (Latin script) menus — lay them flat, fill the frame, good light. A PDF export of the menu is the most reliable scan. Urdu-script menus cannot be read by any on-device scanner, so type those manually.
7. Menu tab → add categories (e.g. Drinks, Mains) and products with photo, price and SKU.
8. Add modifiers per product: Size (small / large), Spice level, and priced Add-ons.
9. Link a product to a stock item so sales deduct inventory automatically.
10. Deleting a category asks for confirmation and moves its dishes to Uncategorized — it never wipes the products. Deleting a dish also asks first.
11. Long-press a product on the order screen to 86 it (mark unavailable) — it greys out everywhere instantly.
12. Currency symbol is configurable in Bill profile; every price uses it.

English

• Stock tab: cards with quantity; low-stock and out-of-stock show automatically.
• Paid orders deduct stock once per order (never double-deducted). Refunding returns it.
• Scan a stock barcode to add quantity quickly.
• More → 86 board lists every unavailable item with a one-tap restore.

English

• Tables / Queue tab: tap a table to open its ticket; live colors = free / ordered / ready.
• v1.1.91 — Plan refresh now truly syncs: extras granted on the Jathol dashboard can stick as locks on Main no more. More → License → Refresh plan & features applies the saved plan within seconds and shows Plan synced · n/15; a Full key always means every extra on (§24, §27).
• v1.1.91 — Main on a Windows laptop: the shop server now runs on Windows 10/11 — unzip and open order_flow.exe, and stations on phones join it over Wi-Fi exactly like a phone Main (§27). Prints through any Windows printer (USB thermal "Generic / Text Only") or a LAN printer.
• v1.1.91 — Architectural Table Map & Filters: visual restaurant table layouts with seat capacity indicators, live busy clocks, and interactive filters (All, Free, Busy, Ready) to isolate open tables in seconds during busy dinner rushes.
• v1.1.91 — Main POS Push Broadcasts: Main shop device receives instant alerts from the SaaS admin dashboard (new feature releases, restaurant flow tips, and plan promos) and saves them in the Notification Bell inbox.
• v1.1.91 — busy clock: every occupied table shows how long it has been busy (mm:ss, then hours). A QR order on that table marks it busy the same way as a waiter ticket.
• v1.1.91 — search live tickets: Home, kitchen, cashier and the tablet floor rail have a search box. Type a ticket number (with or without #), table, or guest name.
• Send to kitchen prints the kitchen slip and alerts the pass with sound + vibration. The slip prints the table number in large type — a QR dine-in ticket never prints as TAKEAWAY.
• Hold pauses a ticket; un-hold resumes. Fire course sends only one course to kitchen.
• Move / merge tables, split bill or split evenly from the ticket's More menu.
• Discounts and complimentary tickets need the manager PIN.
• Takeaway and delivery tickets carry customer name, phone and address.

English

1. Tap Pay on the ticket → pick the method: Cash, Card, Wallet, Other or Complimentary.
2. Cash: use the keypad, Exact fills the due, change is shown. Card/wallet: tap and close.
3. Tip can be added (none / 5% / 10% / 15%) before closing.
4. Split payment: switch it on, choose a second method and its amount — e.g. cash 300 + card 500.
5. Both methods print on the receipt and appear in the payment breakdown reports.
6. The cash drawer opens only if any part of the sale is cash.

English

1. Plug the drawer's cable into the receipt printer's RJ11 (kick) port. No extra app or driver is needed.
2. Main → More → Hardware → Cash drawer → switch on Open on cash payments.
3. Tap Open drawer now to test.
4. From now on: cash sale → drawer pops before the receipt prints. Card / wallet / other → drawer stays shut.
5. If a station uses its own printer (section 9), the drawer kick goes through that printer.

English

• Shop printers (Main): More → Hardware → Printers. Add LAN (IP + port 9100) or Bluetooth ESC/POS printers and assign each to a role (kitchen, cashier…).
• Every station's own printer: tap the printer icon in the station's top bar. Pick a Bluetooth printer or type a LAN IP. The station then prints everything itself, independent of Main.
• Bluetooth printing (v1.1.91) now works with any Bluetooth printer — old Classic (SPP) models like the common 58mm portables, and modern Low-Energy ones. Pair the printer once in Android settings (PIN 0000 usually), pick it in the printer sheet, and print. The Auto / Classic / LE chips let you force a link type if a picky printer needs the nudge; error toasts now quote the printer's real complaint.
• These printers serve one connection at a time: while your station has a Bluetooth printer selected, Order Flow holds that link open like a real POS — so back-to-back prints (and the Test button) always reach the printer. Use Use shop printer to let it go.
• Paper size (v1.1.91): each printer screen has Auto / 58 / 76 / 80 / 100 mm. Auto keeps the safe 58 mm layout; wider choices only lengthen lines — letters keep their native shape. Transparent PNG logos print correctly now (alpha is composited on white, mostly-dark artwork auto-inverts).
• Receipt layout (v1.1.91): the shop name prints on one line — double-size only when it actually fits, so long names no longer wrap mid-word. The logo keeps a margin (≈80% width, centered), Ticket and time share one line (time right-aligned), the item table gained its Amount header, and the stray double-hash on ticket numbers is fixed.
• Footer per slip type (v1.1.91): every slip editor in the bill profile has its own Slip footer field — delivery can end with a delivery note, takeaway with its own thanks, the cash receipt with another. Leave it empty and that slip just uses the shop footer.
• Pay & Print — the payment sheet's button settles and prints the customer receipt on your station's printer; Pre-bill next to it prints the running total marked “NOT PAID YET” without settling anything. Kitchen tickets print the ticket number and table in double height; takeaway/delivery slips still say TAKEAWAY/DELIVERY. v1.1.91: a QR table ticket prints QR TABLE T4, never TAKEAWAY.
• Bill profile: shop name, address, phone, tax ID, footer, logo image, pay QR — all print on the receipt.
• Separate slip templates for kitchen / counter / takeaway / delivery — choose what each shows.
• Test button on every printer screen sends a test page. Reprint any ticket from More → Reprint.

English

Tap the TV icon in any ticket's top bar. The screen becomes a customer-facing display: shop name, giant animated total that jumps on every item, and the latest item added. Great on a tablet facing the customer or cast to a TV. Tap back to return.

English

• After payment the celebration screen offers Share receipt — or use the share icon on any paid ticket. Send it on WhatsApp, SMS or email.
• Tap the chat icon on a ticket with a customer phone number to open WhatsApp with a ready "your order is ready" message.
• Delivery customers can be told the order is out for delivery the same way.

English

• More → Customers: keep a book with name, phone, address, loyalty points and store credit.
• When a ticket's customer phone matches a saved customer, paying awards 1 point per whole currency unit automatically (e.g. Rs 450 → 450 points).
• Points never double-award: each paid order earns once. Refunds do not remove points.
• Attach a customer to takeaway/delivery tickets with the edit button on the ticket.

English

• X report (More → X): today's sales, payment breakdown per method (split-aware), hourly sales, voids, refunds — without closing anything.
• Z report: today's totals without locking the shop.
• v1.1.91 — Shift close (Home or More → Reports, was “Day close”): a manager or Main closes the shop shift. Open tickets stay open. New orders are blocked until someone opens the next shift — the till shows a popup; guests on the QR page see the same. Open shift asks for the manager PIN only.
• Cashier float: cashier opens with a float, ends with counted cash; reports show who worked. The cashier screen now shows a tap-to-open / tap-to-close banner so a closed drawer is never silent. That float is separate from Shift close.
• Home shows sales, open orders and charts live.

English

• Void an open order from its More menu: manager PIN, a confirm, then a reason — it moves to the void report.
• Refund a paid order: tap the exchange icon on the paid ticket, confirm the manager PIN. Stock returns to inventory automatically and the refund shows in reports.
• Every void and refund keeps a written reason on the ticket.

English

1. More → Drivers: add drivers with name and phone.
2. The driver pairs once from his own phone (Connect to Main → Driver role, then the name match).
3. On a delivery ticket choose Assign driver. The driver sets free / busy / offline — even away from the shop Wi-Fi.
4. Out for delivery marks the ticket served; the cashier closes the payment.

English

More → Reservations (restaurant and services models): book a customer with phone and time. Appointments show on the floor map and in the specialist's queue. Book a walk-in from the front desk with one tap.

English

• Language: English / اردو per device, from More — a sheet lists both instead of toggling blindly.
• Theme: light / dark / system.
• Backup: More → Export backup shares a JSON file; import restores everything on Main. A failed import now shows a clear message instead of a raw error.
• Staff & PIN: staff list with duty (on shift / meal break / tea break / offline) and manager PIN for discounts, refunds and role changes.
• License: view key, device ID and expiry; WhatsApp button for support.

English

• Printers: any ESC/POS 58/80mm thermal printer — LAN (TCP 9100) or Bluetooth. Keep the printer on the same Wi-Fi as Main.
• Cash drawer: any RJ11 kick drawer — plugs into the receipt printer, never directly into the phone.
• Barcode guns: USB/Bluetooth guns work as keyboards — just focus the search or scan box. The built-in camera scanner does the same without hardware.
• Kitchen sound: station notifications + vibration announce ready orders; keep the kitchen device's volume up. The wait clock ticks live — tickets turn amber at 10 minutes and red at 20, and the kitchen beeps on new and late tickets.

English

• Station won't connect: same Wi-Fi as Main? Is Main's server on (Home → Server ON)? Re-type the IP.
• Print fails: run the printer's Test page. LAN: check IP/port 9100 and same network. Bluetooth: pair in Android settings first, allow Nearby devices permission.
• Drawer won't open: is it plugged into the receipt printer's kick port? Try Open drawer now. Some printers need the drawer enabters need the drawer enabled in their own settings.
• Offline queue: the station chip shows queued work; it flushes automatically when Main is back.
• License locked: the key was reset or revoked — email contact@jathol.org from the lock screen and we reset it.
• Anything else: email contact@jathol.org — answered within 24 hours, Monday to Saturday.

English

• Switch it on: More → Plan extras → QR ordering → enable. Main must be on Wi-Fi; the address looks like http://192.168.x.x:8787/order.
• For a single table open the Tables tab → QR icon → show, print or share that table's code. Guests scan it and the menu opens with the table already attached.
• v1.1.91 — no table on the link? The cart asks the guest to pick a table from your floor map. Sending without a table is refused (need table). A code for a deleted table shows table gone. If the shop shift is closed, the page says so and will not take new orders.
• The guest page works in English and Urdu (toggle at the top), shows photos, prices, modifiers and notes — no app to install.
• v1.1.91 page fixes: prices and totals now use your own currency symbol with thousands separators (previously some shops saw “true1,200” style totals), product photos (JPEG or PNG) render on the menu cards, and the success screen now shows the order total next to the ticket number. v1.1.91: on narrow phones the floating Your order bar could hang off the right edge so Review & send was unreachable — orders never left the guest's phone. The bar is now always fully on screen and tappable. v1.1.91: after send, the ticket card keeps polling the kitchen — received, cooking, ready, paid or cancelled — so guests are not left guessing.
• Submitting a web order creates a normal dine-in ticket with the QR badge and that table number. The kitchen slip prints QR TABLE T4 (never TAKEAWAY). The table turns busy and the floor clock starts. By default it fires to the kitchen (printers included) the moment the counter marks it paid. Prefer cooking at submit? Switch to At submit in the same QR sheet.
• On custom plans the page shows your shop's name, tagline, hours, contact and colour — set it all under Your brand page (§26).
• Switch ordering off any time — the page closes instantly for new scans. Orders are accepted only on the shop Wi-Fi, never from the internet.

English

• First give every stock item its cost (Stock tab). Then open More → Plan extras → Recipes & margins.
• Tap an item and add ingredients with the quantity used per sale (e.g. 0.5 kg flour + 2 eggs). The list shows cost, profit and margin percent per item.
• Margins under 25% are flagged in red so you can fix the price or the plate before it costs you.
• Recipe costing is separate from auto-deduction — your existing inventory link keeps working exactly as before.

English

• More → Plan extras → Wastage log → Log waste: pick the stock item, the quantity lost and an optional reason (spoiled, burnt…).
• Wasted quantity leaves inventory immediately, and its cost is counted in the Wasted this week total and in Insights.
• Logged it wrong? The undo arrow puts the stock back and erases the entry.

English

• More → Plan extras → Purchasing: keep your suppliers (name, phone) on the Suppliers tab.
• Create a purchase order: supplier, one line per stock item with quantity and unit cost. The PO gets a number like PO-501 automatically.
• When the delivery arrives, tap Receive stock — quantities are added to inventory and the item cost is updated to the latest price you paid.
• Open orders can still be cancelled; received and cancelled POs stay in the list for reference.

English

• Every license key now carries a plan (Starter / Growth / Custom / Full), the business models it may run and the features it may use. Starter RM 79 / month, Growth RM 149 / month — see the Plans page.
• What is switched on for your key is exactly what the app shows. Locked extras appear with a lock icon in More → Plan extras — tap it to message Jathol on WhatsApp and upgrade.
• Keys issued before plans existed keep every feature on — nothing changes for existing shops unless Jathol sets a plan on your key.
• The app re-checks your key online every 15 minutes and keeps working 48 hours offline; plan changes apply on the next check. The QR ordering page and station connections are enforced by Main itself, so the plan is respected on every device.
• Plan summary is visible in More → License (plan name, enabled models and feature count).
• Owner changed features on the Jathol dashboard? On Main open More → License → Refresh plan & features — the new access lands in seconds (no need to wait 15 minutes) and the sheet confirms with Plan synced · n/15. Full plan means every one of the 15 extras is unlocked; a row that still shows a lock is simply off on this key.

English

• 1 · Open a room (Main only). More → Plan extras → Cloud networking → Open cloud room (custom plan). The sheet shows a QR, a big JOIN CODE, and the full pairing text underneath.
• 2 · Pair each device with the long pairing text, not the short code. On the other phone: same menu → Join box → paste the OF1:… text (on Main, tap it → Select all → Copy). Any phone's camera can also read that QR into text to copy. The six-character JOIN CODE is only to spot your own room; typed alone it will not join — room addresses are deliberately unguessable and listed nowhere.
• 3 · Then forget it is on. While the shop Wi‑Fi is healthy everything runs over the LAN and the cloud sleeps. The moment a phone loses its LAN link — router died, or someone walked to the back on 4G — it talks through the room instead: orders reach Main in seconds, a blip just queues the work on the phone (the pending count shows it) and flushes by itself when the link returns. Nothing is ever re-typed.
• The cloud is a corridor, never a store. Every message is encrypted by your devices before it leaves them, deleted once all your devices have read it, and expires on its own in about 30 minutes even if nobody reads it. Shop data lives only on Main's device — backups stay entirely in your hands (§17).
• Honest errors. If a room will not open, the message now names the true reason: license (the key is not on a cloud-enabled plan — message Jathol), relay (server hiccup — try again in a minute), or network (that phone has no internet). Mid-shift, an amber line "Relay unreachable — retrying automatically" (1.1.91) means only the corridor is jammed — your work stays safely queued on the device.
• Keep the pairing sheet private. That QR and OF1 text are the key to your open room — anyone holding them can join while it stays open. Do not photograph it into public chats. When service ends, Close cloud room: closing wipes the room, and re-opening issues fresh credentials, so any old pairing stops working instantly.
• Two-minute field test (do it once, calm): pair a station, put it on mobile data with Wi‑Fi switched off, send a test order — it lands on Main in seconds. Now you trust the fallback before the night you actually need it.
• Guest table QR (§20) stays local on purpose — this section is for your own devices only, never for public traffic.

English

• Make the guest ordering page your own: More → Plan extras → QR ordering → Your brand page (custom plan). Then hit each table's QR and it opens under your name.
• Set the shop name, tagline, address, opening hours, a welcome note, phone and WhatsApp, and pick an accent colour — the whole page (buttons, prices, cart) repaints instantly.
• Leave a field blank and the page falls back to your bill-profile details (§9) — so it already looks branded before you touch anything.
• Guests get the full experience: animated menu cards, photos, modifier chips, notes, a cart drawer with totals, and a success ticket with their table and ticket number — with English/Urdu built in and working on any phone on the network, no install.
• Changes save with one tap and every later scan sees them immediately. Printing table QR stands is unchanged (§20).

English

1. Download the ZIP from the homepage (Download Windows ZIP) on any Windows 10/11 (64-bit) laptop or PC that will be Main.
2. Extract the ZIP anywhere (Desktop is fine), then open order_flow.exe. The first time Windows asks “Allow through firewall?” — tick private/public networks and allow. The shop server listens on Wi-Fi port 8787, exactly like a phone Main.
3. Enter the same 16-character license key. A key binds to one Main; to move Main from a phone to the laptop, ask Jathol for a binding reset first (§1).
4. Stations pair the usual way: kitchen, cashier, takers and drivers on their phones tap Connect to Main, same Wi-Fi — nothing changes for them. The laptop just has to stay awake while the shop runs (lid open, plugged in).
5. Printing from a laptop Main: More → Printers offers Windows printers (any printer installed in Windows — USB thermal printers work with the built-in “Generic / Text Only” driver) and LAN / Wi-Fi (network ESC/POS on port 9100). Test print from the same sheet.
6. QR guest ordering, backup/restore, reports, broadcasts all work identically — the guest ordering page is still served by Main, now from `http://LAPTOP-IP:8787/order`.
7. First run — the blue SmartScreen popup (“Windows protected your PC / publisher unknown”): this appears because the app is not signed with a paid certificate yet. Click More info → Run anyway once — it is safe, and Windows stops showing it after the file builds trust (a paid certificate will remove it entirely later).
8. Closing & reopening: the shop server lives inside the app, so it stops when you close the window (nothing keeps running in the background — the program fully exits) — and it restarts itself automatically a few seconds after you open the app again. If the top bar ever still says Server stopped, tap that chip once to start it. Phones and tablets reconnect on their own.
9. Am I really on the new version? The window title shows it — Order Flow 1.1.91 and so on — and the exe agrees (order_flow.exe → right-click → Properties → Details → File version). If the number is older than the ZIP you downloaded, you extracted or launched the previous folder: delete it (and any order-flow-windows*.zip in Downloads), download again from the homepage, extract fresh and open it.
10. Updating to a newer Windows release later: the newest ZIP is always on the download page. Close the app, download the new ZIP and extract it over the existing folder (or anywhere new) — everything you created (menu, sales, settings, printers) is stored in your Windows user folder (Documents + AppData), not inside the ZIP, so nothing is ever lost. No uninstalling needed. If Windows refuses with “folder in use” while extracting, the app is still running: close the order_flow.exe window first (no window? → Task Manager → order_flow.exe → End task), wait 3 seconds, then extract again — an open File Explorer window inside the same folder can also trigger it, so close that too.
11. Locked extras look off on the laptop Main? On More → Plan extras a lock icon means the extra is off for this license key — the fix is not a reinstall, it is on the key itself: Jathol enables the features on the dashboard, then on Main tap More → License → Refresh plan & features and the locks lift in seconds (v1.1.91).