Docs / Getting started

Overview

How halopos is organised, what you install where, and what the surfaces are called.

halopos runs in three places. Everything else is detail.

The cloud app

The cloud is where your menu, orders, staff, and reports live. Open it in any modern browser. The owner signs in with email and password; staff sign in via Clerk. All of these URLs are under your tenant:

  • /admin — dashboard and reports; menu, staff, store, billing live under /admin/*; tenant overview at /admin/overview.
  • /cashier — the till. Touch-first, works on a tablet.
  • /kds — the kitchen display. Runs on a second screen.
  • /mobile — waiter pocket. Same data as the till, on a phone.
  • /cdu/[orderId] — the customer-facing display on a second screen.

The hardware bridge

A tiny process that runs on a Mac mini in your venue. It talks to your printers, cash drawer, and EFTPOS terminal, and receives jobs from the cloud. You install it once per venue, not per device.

If your internet goes down, the bridge keeps printing queued jobs when it comes back up. Nothing is lost.

The printers and EFTPOS

halopos ships drivers for Epson TM-series (ESC/POS), Star TSP/mPOP (Line Mode), Bixolon SRP-series (ESC/POS dialect), and for Tyro / Smartpay EFTPOS. The Adapter SDK is open if yours isn't on the list — see "Hardware → Bring your own printer".