​

Developer quickstart

​

What the app is

• Runtime: Node.js with React Router and PostgreSQL through Prisma, deployed as a web service plus a scheduled job.
• Admin API version: 2026-01.
• Admin UI: native Polaris web components (s-*) with App Bridge; embedded (embedded = true).

​

Shopify access scopes

read_orders,write_orders,read_draft_orders,write_draft_orders,read_checkouts,
read_customers,write_customers,read_customer_events,write_pixels,
read_metaobjects,write_metaobjects

​

Extensions

• Web pixel extension — tracks storefront cart and checkout events and posts them to the app’s pixel endpoint. It is configured with an endpoint, shop domain, token, and app ID.
• Customer segment action extension — adds an admin action on a Shopify customer segment that applies recovery email and SMS/WhatsApp consent metafields to the segment’s members.

​

Interfaces

• API overview — the externally reachable endpoints, including the public read-only API.
• Webhooks reference — outbound recovery events and Shopify subscriptions.
• Architecture overview — runtime and data flow.

​

Health check

curl --fail-with-body "${APP_ORIGIN:?Set APP_ORIGIN}/healthz"