Documentation

Doi Xiu is a workspace-based platform for restaurants, cafés, and shops. You maintain a product catalog with optional photos and categories, create one QR link per table, and guests open a public page to browse the menu and place orders. Your team signs in with Google or email OTP; guests never need an account — they just use the table link.

Beyond QR ordering, Doi Xiu includes a built-in POS (counter sales), promotions and discount codes, inventory tracking, a manual ledger, customer management, invoices, activity logs, and custom roles with granular permissions. This marketing site covers pricing and contact; the signed-in app lives under /app with its own sidebar, workspace selector, and feature screens.

The left sidebar is your main navigation inside /app. Dashboard, Orders, Products, QR & ordering, Reports, and Settings are top-level items. The “Manage” group expands: Categories, Customers, Members, Inventory, Ledger, Activity logs. The “Team” group has Members and Roles. On mobile, use the bottom tab bar (Dashboard, Orders, Products, More).

Pick the active workspace from the selector at the top. Most screens load data for that workspace only, so always check the selector before working. The bell icon opens notifications (workspace invites, announcements). Your avatar opens Profile (email, display name, phone, avatar upload).

A workspace represents a single shop, restaurant, or brand. Products, QR links, orders, promotions, customers, and members all belong to one workspace. Need to manage two locations? Create two workspaces and switch between them in the header selector.

Create additional workspaces from the sidebar (“New workspace”) or the onboarding flow. Only owners can delete a workspace — it is a destructive action with a countdown timer and name confirmation to prevent accidents.

Each member has a role (see Roles & permissions). Roles control who can create products, manage orders, view reports, change settings, and more. You can create custom roles with fine-grained permissions.

The dashboard gives you an at-a-glance summary of your workspace: product count, order count by status, 14-day revenue trend chart, and quick-access tiles for Products, Categories, Orders, Customers, and Members. Use it as your landing screen after sign-in; click “Reload stats” if numbers look stale.

Manage your sellable catalog on the Products page: name, description, price, active/hidden status, optional stock on hand, currency, and category tags. Product images are uploaded as WebP (the browser auto-resizes) and displayed on the guest-facing menu.

Creating, editing, and deleting products requires owner or admin role (or a custom role with product permissions). Images must be WebP format, max 2MB, and are automatically resized in the browser before upload.

Deleting a product may be blocked if it already appears on historical orders; deactivate instead to hide it from new orders.

Categories organize products for both staff and guests. On the public ordering page, categories appear as filter chips at the top of the menu — guests tap a chip to filter by category. Set a sort order (lower number = appears first) so chips display in a logical sequence. Owner/admin can add, edit, and remove categories.

Under QR & ordering you create table links: each link has a secret token and an optional label (e.g. “Table 5” or “Patio 3”). Download the QR code as a PNG to print and place on the table, or share the URL directly. When a guest opens the link (/q?token=…), they see the full menu for your workspace.

Guests browse active products with photos, filter by category, add items to their cart, and optionally apply a promo code. Submitting the order sends it to your workspace — no guest account required. The order appears instantly on your Orders page and dashboard.

Orders lists all orders for the selected workspace — from both QR guests and POS counter sales — with table label, channel (QR/counter), status, and item count. Open an order to see line items with prices at time of order, the assigned customer (if any), and a printable receipt.

Owner and admin can update order status (pending → confirmed → completed, or cancelled). The built-in POS (Quick Sale) lets you create orders at the counter: search products, assign a customer, and confirm. Order receipts can be printed from the detail view.

The Customers page lets you manage a workspace customer list: add customers with name, email, phone, address, and notes. When creating a POS order, you can search and assign a customer. Customer details are visible in the order detail view for future reference.

Members lists people in the workspace with email, display name, and role. Owners and admins can invite new members by email — if the person already has a Doi Xiu account, they receive a notification to accept or decline. You can also change a member role (e.g. Member → Admin) or remove them from the workspace.

Reports aggregates revenue and order metrics for a date range you choose. KPIs include: order count (non-cancelled), order revenue, ledger income, and ledger expenses. A daily revenue chart and top-products-by-revenue table help you spot trends. Export data as CSV (daily, products, or orders) for further analysis in spreadsheets.

Inventory tracks on-hand quantities per product. Guest orders automatically deduct stock when sufficient quantity is available. You can manually adjust stock (add, remove, or correct amounts) and view transaction history. Use it to keep stock accurate and avoid overselling.

Ledger is a manual income/expense journal for the workspace. Record cash flow entries with amount, currency, category, memo, and date. Filter by date range to review totals. Use it alongside Reports to get a complete picture — order revenue plus manual cash transactions.

The bell icon shows in-app notifications for the signed-in user: workspace invites, order alerts, and system announcements. Accept or decline workspace invites directly from the notification. Mark items as read to keep the list manageable.

Profile shows your account email (from your sign-in provider) and lets you set a display name, phone number, address, and gender. Upload a square-friendly avatar (WebP, browser-resized). Your profile syncs across workspaces — change it once and all teams see the update.

Settings is organized into tabs: Workspace (name & slug), Membership (your role, leave workspace), Roles (custom role management), Preferences (language), and Danger (delete workspace). Language applies to both the marketing site and the app. Changes apply to the currently selected workspace.

Doi Xiu supports a flexible role system with built-in and custom roles: