Reorbit — Shopify App Review Demo

Step-by-step walkthrough (English)

Written walkthrough of exactly what the app does after install. Follows the same order as the video.

1. Install from Shopify Admin. Merchant clicks "Add app" → approves the requested scopes (read_orders, read_customers, read_products). OAuth completes and Shopify redirects back to /api/auth/callback.
2. Automatic store bootstrap. Immediately after the OAuth token is stored, Reorbit fetches the shop profile (shop.json), backfills the 50 most recent orders, and registers the orders/create webhook. This is why the embedded dashboard shows real store data on first load — shop name, currency, order count, and revenue are populated before the page renders.
3. Embedded dashboard. Merchant lands inside Shopify Admin at /app. The dashboard displays: shop identity (name, plan, currency), revenue KPIs from real orders, a 14-day timeline, engine status, and any AI-generated upsell drafts.
4. New order arrives. Shopify POSTs to /api/public/webhooks/shopify/orders-create. HMAC is verified, the order is stored as pending, and the AI worker generates a personalized upsell recommendation (subject, preheader, body, and 1–3 recommended products from the store catalog).
5. Follow-up email sent. The generated upsell email is queued and delivered to the customer. Delivery state (sent / suppressed / failed) is written back to upsell_offers and appears in the "Recent upsell emails" table with the subject line and timestamp.
6. Attribution. If that customer places another order after receiving the email, Reorbit attributes the revenue to the send and surfaces it as "Revenue recovered" on the dashboard.
7. Demo Mode (recommended for reviewers). On the embedded dashboard (/app) there is a Demo Mode panel at the top. Enter any email address you control (e.g. your personal @shopify.com or Gmail inbox) and click ▶ Run demo now. Reorbit runs the full pipeline live — verify session → load shop → read catalog → simulate order → AI generation → send email — and delivers the exact same AI-generated upsell email that a real customer would receive to the address you entered. Arrival typically takes 10–60 seconds; check Spam / Promotions if not in the inbox. Sender: noreply@notify.reorbit.dev. If the test store's product catalog is empty, Reorbit falls back to 3 sample products so the demo always completes end-to-end.
8. GDPR / uninstall. On app uninstall, the app/uninstalled webhook clears the access token and marks the shop uninstalled_at. Customer data / redact webhooks are handled at /api/public/webhooks/shopify/compliance.