Documentation

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

QR Code Labels

Every plant listing generates a unique QR code. These codes link to the LeafCast botanical reveal page where visitors see plant information and contact the vendor.

How QR Codes Work

When you create a plant listing, a QR code is automatically generated. The code encodes a permanent URL with the plant listing UUID pointing to the vendor-scan-qr Supabase Edge Function (Economy/Budget labels use a short /q/ URL that resolves to the same listing):

{SUPABASE_URL}/functions/v1/vendor-scan-qr?id={UUID}

The UUID identifies the listing in the database. Only QR codes generated through the LeafCast platform resolve to a plant listing.

Downloading Labels

Single label: Click the ⬇ button on any listing row to download a PDF label. Labels are customisable — see Label Settings below.

  • pages.docs.qr_download_single_qr
  • pages.docs.qr_download_single_name
  • pages.docs.qr_download_single_price
  • pages.docs.qr_download_single_vendor

Bulk download: Select multiple listings using the checkboxes, adjust the label settings, then click the Bulk Print Selected button. The resulting PDF uses your chosen size and layout.

Label Tracking

Once a label is downloaded, it is marked as label printed with a timestamp. This helps you track which physical labels have been deployed at your nursery or exhibition booth.

Permanent QR Identity

QR codes are never regenerated. If you edit a listing's price or custom text, the QR code remains the same. This is intentional — physical labels may be engraved on plaques or permanently affixed to planters. A changed QR code would break existing labels.

The visitor always sees the latest data from your listing, so updating your listing (price, text, location) immediately updates what appears when the existing QR code is scanned.

Printing Recommendations

  • Print on waterproof or laminated paper for outdoor use
  • For permanent installations, consider acrylic or aluminium plaques
  • Recommended label size: 60mm × 60mm (the default PDF size). Use 58×40mm only with thermal roll printers.
  • QR code uses High error correction — remains scannable even if partially damaged