How to build: digital menu and QR

implemented User App /menu, /menu/new, /menu/:menuUuid/edit.

Owner builds a digital menu / price list, items, sold-out style updates, and a QR / share URL to the guest storefront.

Pick business → Create menu → Add items → Share /app/{businessMetaKey}/menu/{menuMetaKey}

Public URL helper: VITE_FRONT_FACING_URL + /app/{business.meta_key}/menu/{menu.meta_key}.

---

1. Create menu

Core Backend · winnerimplemented

Call this API

POST https://backend-test.nellalink.com/public/api/v1/nellalink/smart-meta-manager/entity/nellalink_business_menu

Request (shape used by User App)

{
  "request_id": "1710000000001",
  "slug": "lunch-menu",
  "meta_key": "Lunch menu",
  "meta_value": "untitled",
  "title_name": "Lunch menu",
  "description": "",
  "status": "enabled",
  "entity_featured_url": "",
  "owned_by": "{userUuid}",
  "parent_entity_type": "nellalink_business",
  "parent_entity_uuid": "{businessUuid}",
  "extra_data": {
    "menu_base_wallet_ticker": "NGN",
    "menu_base_wallet_ticker_symbol": "₦",
    "menu_primary_color": "rgb(19, 161, 85)",
    "enable_dark_mode": true,
    "menu_featured_categories": ["Mains", "Drinks"],
    "menu_checkout_payments_providers": [],
    "support_tab": {
      "title": "Help",
      "content": "",
      "nav_button_text": "Help",
      "show_ring_feature_on_support_page": true
    },
    "contact_info": {
      "email_address": "hello@example.com",
      "mobile_number": "",
      "address": "",
      "show_contact_info_on_support_page": true
    }
  }
}

---

2. Create item

Core Backend · winnerimplemented

Call this API

POST https://backend-test.nellalink.com/public/api/v1/nellalink/smart-meta-manager/entity/nellalink_business_menu_item

Parent: parent_entity_type=nellalink_business_menu, parent_entity_uuid={menuUuid}.

Item extra_data (required for the guest app)

{
  "tag": "",
  "category": "Mains",
  "unit_price_amount": "2500",
  "minimum_quantity_per_order": 1,
  "maximum_quantity_per_order": 20,
  "sort_position": 1
}

Category Delivery is treated as a delivery option, not a food item, on Front-facing.

List items:

GET .../entity/nellalink_business_menu_item?parent_entity_type=nellalink_business_menu&parent_entity_uuid={menuUuid}&per_page=1000&sort_by=extra_data.sort_position&sort_order=asc

Trash: POST .../entity/nellalink_business_menu_item/trash/{uuid} (User App currently DELETE/POST-style trash URL).

---

3. Share / QR

No extra API. Build https://business-dev.nellalink.com/app/{businessMetaKey}/menu/{menuMetaKey} (swap host per env). Guest flow: Front-facing browse menu.

Metadata: menu branding, payments, support tab, item prices — ENV / Metadata Catalog.