Developers

Chrome extension

Run the counter desk from a Chrome side panel

Call next, serve, miss, and transfer without keeping the full Esperaly tab in front. Same staff login and permissions as the web desk. Not on the Chrome Web Store yet — load it unpacked until we publish an unlisted listing.

What it does

Staff pick an organisation, a desk location, and a counter, then claim it the same way as the web desk. The side panel stays live while you work in other tabs. Locations that run as a tickets board (no counters) are hidden.

Install (until the Chrome Web Store listing)

  1. On a computer that has the Esperaly repo, run bun run build:extension from the repo root (needs VITE_CONVEX_URL and VITE_WORKOS_CLIENT_ID in .env.local).
  2. Open chrome://extensions and turn on Developer mode.
  3. Load unpacked and choose extensions/counter-chrome/dist.
  4. Pin Esperaly Counter. The toolbar button opens the side panel. Reload the extension after rebuilds.

Guests and typical staff should not use load-unpacked. When the unlisted Chrome Web Store listing is live, this page and the Counters screen will show an Install button instead.

Sign in

Use the same WorkOS staff account as the web app. Preferred: Sign in in the side panel (AuthKit popup). Fallback: Sign in with Esperaly in browser, then return to the extension.

All developer docs