Overview

SaveLayer is designed around one shared service layer with multiple ingress channels.

Online Store themes

Online Store traffic uses Shopify app proxy requests. The recommended storefront integration is the SaveLayer theme app embed, which loads the SDK and exposes window.SaveLayer.

Headless storefronts

Headless storefronts use direct APIs with signed authorization headers. They do not go through the Shopify app proxy path.

Customer account extensions

Customer account extensions use direct APIs and bearer-token authorization with CORS support.

Current repository shape

• apps/pages: Shopify React Router app, app proxy routes, direct API routes, admin UI
• apps/worker: Cloudflare Worker for shared background and gatekeeping logic
• packages/contracts: shared Zod schemas
• packages/sdk: browser-safe SaveLayer SDK
• extensions/savelayer-theme: Shopify theme app extension