HomeSetupWidgetBillingReviewHelp

Storefront extension

The widget is a theme app extension, not theme-code surgery.

The block lives under extensions/sniffopotamus-gift-finderand calls the hosted `.dev` widget endpoint.

Find a fragrance gift

BirthdayFresh or tea-likeUnder AU$150
POST https://www.sniffopotamus.dev/api/widgets/gift-finder
{
  "shop": "example.myshopify.com",
  "occasion": "birthday",
  "style": "fresh tea",
  "budget": "150",
  "country_code": "AU"
}

Add app block

The theme app extension exposes a Gift Finder block that merchants place in any Online Store 2.0 JSON template.

Ask the right questions

Occasion, recipient style, budget, and note preference become a recommendation intent.

Return three answers

The widget endpoint returns grounded fragrance rows now, then merchant catalogue SKUs once settings tables are live.

Meter usage

Each recommendation request becomes a billable event after the commercial usage ledger is approved.

Deployment rule

Use the commercial domain.

Theme blocks should default to https://www.sniffopotamus.dev. That keeps merchant traffic, usage events, and app review assets on the commercial surface.

Next: billing map