Getting started

Access in Hawkers comes from being on a venue's team. A new Google account isn't on any team yet, so /admin only shows “Create a venue”. Pick one of the two ways in below.

1. Create your own venue (recommended)

Creating a venue makes you its owner straight away.

  1. Go to /admin and sign in with Google.
  2. Type the venue name. The web address fills in by itself.
  3. Choose Restaurant (one kitchen, shared table tab, pay at the end) or Food court (many stalls, pay up front).
  4. Press Create venue, then follow the Set up checklist on the Overview page: stalls (food court), menu, tables and QR tags, team, payments, then turn Published on.
  5. Print the QR tags from Tables & QR, and scan one with your phone to try it as a guest.
Open admin

2. Get into the demo venues

Duke's Pizza and Hawkers Food Court already have menus, tables and games, but an owner has to add you. In Supabase, open SQL Editor and run this, using the email shown under “Signed in as” on /admin:

insert into public.venue_members (venue_id, user_id, role)
select v.id, u.id, 'owner'
from public.venues v, auth.users u
where v.slug in ('dukes-pizza', 'hawkers-food-court')
  and u.email = 'you@gmail.com'
on conflict (venue_id, user_id) do update set role = 'owner';

Reload /admin and both venues appear.

3. Add your staff

  1. Venue admin → Team → enter their email and role → Create invite.
  2. Under Pending invites, tap Link and send it to them.
  3. They open it, sign in with Google using that same email, and tap Accept. They land on the staff screens.

Roles

OwnerEverything, including removing people · You
ManagerAdmin, all staff screens, payments · Shift manager
Floor staffOrders inbox, calls, floor plan, live quiz · Waiters
KitchenKitchen display only · Cooks
StallOne stall's tickets and menu · Food court stall owner

Where everything is

Guest/t/<tag>Menu, order, tab, pay, games. Opened from the table's QR / NFC tag
Member/meLevel, coins, quests, vouchers, league
Staff/staffOrders, kitchen, floor plan, live quiz
Owner / manager/adminSet up and edit your venue
Owner / manager/staff/<venue>/paymentsHitPay and Stripe settings
TV on the wall/screen/<venue>Ready board and live quiz, no sign-in

If something's wrong

“No access to this venue”You aren't on that venue's team. Create your own venue, or ask its owner for an invite.
Signed in with the wrong Google accountStaff screens → Sign out, then sign in again with the right one.
Invite says the email doesn't matchSign out and sign in with the exact email the invite was sent to.
Google sign-in failsAdd <your site>/auth/callback to Supabase → Authentication → URL Configuration.