HandyCafe Docs
owner

Menu Management

The Menu tab under Cafeteria is where you build the catalog that customers see at handy.cafe/{slug}. The page is titled Cafeteria Menu. Menus consist of categories and products. Categories can be nested one level: a root category can hold sub-categories.

Structure

Level Purpose
Root category A top-level section of the menu, for example "Drinks". Root categories carry a Root badge.
Sub-category A category with a parent, for example "Hot Drinks" under "Drinks".
Product A single orderable item inside a category. It carries name, description, ingredients, photo, price, VAT rate, preparation time, nutrition values and allergens.

Categories

Each category has the following fields:

Field Meaning
Category name Displayed as a section header on the customer menu.
Parent category Leave it on (Root) No parent to create a root category. Pick a root to create a sub-category.
Icon (mdi:...) A Material Design icon chosen from the icon picker.
Background color The tone of the category card: Default, Teal, Emerald, Lime, Amber, Orange, Rose, Pink, Purple, Indigo, Sky or Zinc. By default root categories use teal and sub-categories a neutral tone.

Adding a Category

  1. Open Cafeteria > Menu.
  2. Click Add category.
  3. Enter the Category name.
  4. Pick a Parent category or leave it as a root.
  5. Pick an icon. The picker has searchable food and drink groups.
  6. Optionally pick a Background color.
  7. Click Save.

To change a category later, click Edit category on its card.

Reordering Categories

Use the up and down arrows at the left of a category card (Move up, Move down). The new order is saved immediately.

Deleting a Category

Click Delete category and confirm. When you delete a root category its sub-categories become root categories themselves. A category that is still referenced by order history is hidden instead of being removed. Old orders keep their product references.

Products

Click Add product on a category card to open the New product drawer. Click Edit on a product row to open the Edit product drawer. The drawer has three columns.

Visual

Field Meaning
Photo Drag and drop, paste or click to upload. Square WebP up to 2 MB is recommended. Remove photo clears it.
Regenerate photo Creates a new AI photo for the product. It asks for confirmation and shows the approximate cost first.

Basics

Field Meaning
Product name Visible to the customer. Required.
Category The parent category. You can move the product to another category here or from the category picker on the product row.
Price The net price in whole currency units. The drawer shows a Net and Gross preview that includes VAT.
VAT % VAT rate applied on top of the net price.
Prep time (min) Static preparation time estimate in minutes. See Dynamic Preparation Time below.
Description Free text shown on the product detail sheet. AI write drafts it from the product name.
Ingredients Short ingredient line, for example "Milk, sugar, coffee beans". AI suggest proposes one.

Nutrition and allergens

Field Meaning
Calories (kcal), Protein (g), Carbs (g), Fat (g) Nutrition values shown on the customer menu.
Allergens The 14 EU allergens, for example Gluten, Milk, Peanut and Sulphites.
Warnings Pork and Alcohol.
Dietary tags Vegetarian, Vegan, Halal and Kosher.
Lock values (block AI overwrites) Keeps your nutrition values when AI fill runs.

Fill with AI estimates nutrition and allergens from the product name and ingredients. The customer menu marks these values as approximate.

AI Assist

The AI Assist box in the Basics column fills several sections at once. Switch on the sections you want (Photo, Description, Ingredients, Nutrition & allergens), then click Fill selected or Fill all. The button shows the approximate cost. A confirmation lists the sections that will be overwritten. AI actions need at least 2 characters in the product name and a positive AI balance. Use Add AI credit when the balance is empty. See AI Assistant for how AI credits work.

Saving

  • Save saves the product and closes the drawer.
  • Save and add another saves and clears the drawer for the next product in the same category.
  • Keyboard shortcuts: Cmd+S to save, Cmd+Enter to save and continue, Esc to close.

Reordering and Deleting Products

Use the up and down arrows on a product row to change its position within the category. Click Delete product and confirm to remove it.

Dynamic Preparation Time

HandyCafe computes a real-time preparation time estimate for every product based on actual kitchen performance.

Setting Effect
Static time The Prep time (min) value on the product. Used when there is not enough history to compute a dynamic value.
Dynamic estimate Calculated from the last 30 days of served items. The typical per-product preparation time is multiplied by a busy factor derived from the current queue length. The multiplier is clamped between 1.0 and 2.0. The final value is clamped between 1 and 120 minutes.

The Show prep time on customer menu setting in the business profile under Cloud > Cafeteria controls whether the estimate chip is visible to customers.

Tips

  • Start with 6 to 10 root categories. Too many categories make the customer menu slow to browse.
  • Use high-contrast, well-lit photos. Dim or noisy photos reduce order conversion.
  • Keep descriptions under 120 characters when possible. Long descriptions push the Add to cart button off the first screen on phones.
  • Set realistic static preparation times. The dynamic system needs order history to learn. Until then the static number is what customers see.
  • Check AI-filled nutrition and allergen values before you publish them. Turn on Lock values (block AI overwrites) once they are correct.