App Home foundation

Fragrance intelligence for Shopify merchants.

This is the embedded merchant surface for Sniffopotamus.dev: Gift Finder first, fuzzy search second, catalogue cleanup as the practical wedge.

Configure app Preview widget

App URLhttps://www.sniffopotamus.dev/shopify

OAuth callbackhttps://www.sniffopotamus.dev/api/shopify/auth/callback

Webhook endpointhttps://www.sniffopotamus.dev/api/shopify/webhooks

Widget APIhttps://www.sniffopotamus.dev/api/widgets/gift-finder

Merchant product

One app, four sellable surfaces.

Gift Finder

Three-question storefront advisor powered by the Sniffopotamus corpus and the merchant catalogue.

Fuzzy Search

Misspellings, flankers, concentrations, and messy product titles resolved into fragrance intent.

Catalogue Cleanup

SKU matching, product-feed enrichment, and confidence review for boutiques and agencies.

Merchant Signals

Recommendation counts, top intents, unresolved queries, and upgrade-ready usage metrics.

Setup path

Built around Shopify's official App Home flow.

App Bridge and Polaris load in this route group. OAuth, session verification, and webhooks are scaffolded, but live token storage and billing wait for the Partner app and Supabase migration gate.

Create Partner appNeeds Partner account access

Create the public app in the Shopify Dev Dashboard and set the app URL to the .dev commercial surface.

Connect app URLsNeeds Shopify API key and secret

Use /shopify for App Home, /api/shopify/auth/callback for OAuth, and /api/shopify/webhooks for webhooks.

Install on dev storeNeeds development store

Test the embedded admin app, OAuth redirect, App Bridge, and storefront theme extension before review.

Enable widgetNeeds Shopify CLI deploy/preview

Add the Gift Finder app block in the theme editor and verify it returns recommendations without layout overlap.

Turn on billingExplicit billing approval

Choose Shopify App Pricing or Billing API flow, then sync entitlements into Supabase.

Pricing shape

Merchant billing maps into the master monetisation plan.

Small fragrance stores

Starter

AU$29/mo

Gift finder block, 1,000 recommendations, basic fuzzy search.

Active boutiques

Growth

AU$99/mo

Gift finder, fuzzy search, catalogue matching, 10,000 recommendations, export reports.

Multi-brand retailers

Retail

AU$299/mo

Higher limits, feed enrichment, API access, analytics, and onboarding support.

Chains, distributors, agencies

Custom

AU$1k+/mo

SLA, white-label options, data licensing, and custom catalogue workflows.

Product boundary

Two domains, one backend.

Consumer app: https://www.sniffopotamus.com
Commercial platform: https://www.sniffopotamus.dev