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:
| Scope | Purpose |
|---|
read_products | Read product catalog for sync |
write_products | Update 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.