Skip to main content

Shopify Partner App (shopify-protocols)

The Shopify Partner App enables supplement brands to sync their product catalog as longevity protocols on The Shrine marketplace (The Lounge).

Features

  • Product Sync — Automatic sync of Shopify products as ProtocolProducts
  • Protocol Management — Partners define protocols (usage plans) for their products
  • Analytics Dashboard — Aggregate adherence analytics (no individual user data)
  • Webhook Integration — Real-time updates on product changes

Shopify Scopes

The partner app requires minimal Shopify permissions:
ScopePurpose
read_productsRead product catalog for sync
write_productsUpdate metafields with protocol metadata
The app intentionally does NOT request read_orders. Partners see aggregate analytics only — never individual user purchase or health data.

Architecture

shopify-protocols/
  app/              # Shopify app (Remix)
  extensions/       # Shopify app extensions
  prisma/           # Database schema

Development

cd apps/shopify-protocols
npm install
npm run dev         # Shopify CLI dev server
npm run test        # Vitest
See Shopify Integration for the data flow and sync protocol details.