Agent skill · software engineering · jeremylongshore
shopify-reference-architecture
Implement Shopify app reference architecture with Remix, Prisma session
Why this skill is useful
Adds a complete executable reference architecture for building Shopify apps with Remix and Prisma, including specific project structures and configurations not commonly found in public documentation.
What it needs
Requires shopify-cli installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Shopify Reference Architecture Overview Production-ready architecture based on Shopify's official Remix app template. Covers project structure, session storage with Prisma, extension architecture, and the recommended app patterns. Prerequisites Understanding of Remix framework basics Shopify CLI 3.x installed Familiarity with Prisma ORM Instructions Step 1: Official Project Structure (Remix Template) Step 2: Core App Configuration The shopify.server.ts singleton configures the API client, session storage, webhooks, and auth hooks. It uses LATESTAPIVERSION from @shopify/shopify-api and exports all auth/session helpers. See Core App Configuration for the complete implementation. Step 3: Session Storage with Prisma The Prisma schema defines the required Session model (matching Shopify's session fields) plus your app's custom models. Use SQLite for dev and PostgreSQL for production. See Prisma Session Storage for the complete schema. Step 4: Route Pattern — Authenticated Admin Page Each app route calls authenticate.admin(request) to get a pre-authenticated GraphQL client, then renders with Polaris components. Data flows through Remix loaders. See Authenticated Admin Route for the complete implementation. Step 5: Theme App Extension Theme app extensions add customizable blocks to the Online Store. Each block defines a Liquid template with a {% schema %} JSON block for merchant-facing settings. See Theme App Extension for the complete implementation. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/shopify-reference-architecture--0614b7