Documentation

Everything you need to get started with the LeafCast LeafCast platform.

Visitor Experience

This is what visitors see when they scan one of your QR codes — whether using the Melur mobile app or their phone's built-in camera.

Botanical Reveal Page

Scanning a QR code opens a full-page botanical reveal at leafcast.melur.com/plants/{id}. The page is optimised for mobile and supports both dark mode and light mode with a toggle button.

Hero Image

The top portion of the page displays a full-width hero photo of the plant (if available).

If no photo has been uploaded for the species, a botanical-green placeholder with a leaf icon is shown instead.

Plant Name & Classification

The plant's common name is displayed in large EB Garamond serif font, with the scientific name in italic below it.

Language Pills (4 Languages)

Four language tabs are shown: BM (Malay), ENG (English), 中文 (Chinese), தமிழ் (Tamil). Tapping a language pill instantly switches the entire page — plant name, description, and audio narration — to that language.

Audio Narration

A sticky audio player appears at the bottom of the screen when narration is available for the selected language. The player includes:

  • Play/Pause button
  • Seek slider with current time and total duration
  • 5-bar waveform visualiser that animates when playing
  • Status labels in Malay (e.g. "Sedang Dimainkan" for playing)

Audio is automatically fetched from Supabase Storage via signed URLs (24-hour expiry). If auto-play is enabled on your account, narration begins automatically when the page loads.

Vendor Section (Paid Plans Only)

Visitors with paid-plan QR codes see a vendor card containing:

  • Business logo — your uploaded logo (if provided)
  • Business name — your nursery or business name
  • Custom sales text — the message you wrote for this listing (displayed in quotes, italic)
  • Call button — links to tel:{your phone}
  • WhatsApp button — opens WhatsApp with a pre-composed message in Malay or English
  • Price badge — your listing price with currency
  • Location button — opens Google Maps with your GPS coordinates
  • IUCN Conservation button — fetches and displays IUCN Red List assessment data for the species (opens a modal with taxonomy, common names, and assessment history)

The vendor section is hidden on Free tier scans — visitors see the plant information and audio only.

Description & Information

Each plant has a botanical description in the selected language. The page also loads medicinal uses data (visible behind the scenes, available for future UI enhancements).

Campaign Banner

If you have an active campaign, a promotional strip appears above or below the audio player with your campaign message and an optional banner image.

External Shopping Link

If your listing has an external link configured, visitors see a shopping cart button that opens your online store in their browser.

Expired Listings

When a listing's valid_until date has passed, the visitor sees an amber warning banner on the page indicating the listing is no longer active.