Gift finder widget
A storefront theme app extension that asks a few gift questions and returns grounded fragrance recommendations from the merchant catalogue.
Shopify App Readiness
Package the fragrance brain where retailers already buy software.
Sniffopotamus stays the consumer fragrance memory app. The Shopify app is the merchant channel: gift finder, fuzzy search, catalogue cleanup, and later brand intelligence.
The first app
Start with Gift Finder, then widen.
The MVP is not a full retailer operating system. A merchant installs the app, selects eligible fragrance products, enables a theme app extension, and gets a working gift finder on their storefront.
- Next.js, Supabase, Vercel, corpus search, MCP, and admin surfaces are already aligned.
- The Shopify app now has a /shopify merchant route group and storefront extension scaffold.
- The first Shopify product should be Gift Finder, with fuzzy search and catalogue cleanup as adjacent upsells.
- Sidekick is strategically interesting but waits until the core merchant app is stable.
Fuzzy search widget
A retailer-facing search layer for misspellings, variants, concentrations, and note-based discovery.
Catalogue cleanup
A merchant utility for matching messy product titles to structured fragrance records and exporting cleaner product feeds.
Build sequence
What has to happen before App Store submission.
Readiness packagingNow
Public plan, admin checklist, app name, pricing shape, partner assets, and test instructions.
Commercial entitlementsGate
Organisations, API keys, scopes, usage ledger, durable quotas, and local entitlement checks.
Shopify foundationGate
Partner app, OAuth, session-token verification, shop install records, privacy webhooks, and token storage.
Widget MVPBuild
Theme app extension, merchant settings, product matching, recommendation endpoint, and event metrics.
Billing and reviewGate
Shopify app pricing, billing webhooks, app review checklist, screencast, and development-store test path.
Domain architecture
Use `.dev` for Shopify, keep `.com` personal.
What to do where
The practical map for Shopify and `.dev`.
Create the Partner app, add App Home, OAuth callback, webhook URL, scopes, and compliance webhook settings.
Connect www.sniffopotamus.dev to this deployment and set Shopify API key, secret, and app URL environment variables.
Use /dev/shopify for the pitch, setup map, official-doc checklist, and retailer readiness narrative.
Use /shopify for the merchant admin app that will run inside Shopify after OAuth is connected.
Enable the Gift Finder theme app block so the storefront widget can appear without editing merchant theme files.
Track approval gates, schema readiness, billing decisions, catalogue cleanup, and the wider monetisation TODO.
Justin-side actions
These are business/account decisions rather than code changes. Once they are done, Codex can wire the next build chunk end to end.
- Create or confirm the Shopify Partner account and one development store.
- Confirm whether the app listing name is Sniffopotamus Gift Finder or a retailer-neutral variant.
- Connect www.sniffopotamus.dev to Vercel before entering final Shopify app URLs.
- Approve the first gated infrastructure scope before live schema, token storage, or billing work starts.
Approval gates
These are the parts that touch live auth, billing, Shopify tokens, or Supabase schema. They need explicit scope approval before build.
- Supabase schema and RLS migrations.
- Shopify OAuth, session-token verification, and encrypted token storage.
- Commercial Stripe plan mapping or Shopify app billing.
- Public App Store submission.
- Any use of protected customer data scopes.
Primary sources
Current Shopify docs to track.
Next approval scope
The first real infrastructure chunk.
- Commercial organisations, members, API keys, and scopes.
- Usage metering and rate limit events.
- Direct `.dev` Stripe entitlement mapping.
- Shopify shop install records, encrypted token storage, and settings persistence.
- Development-store install, Shopify billing, and App Store review assets.