Skip to main content
AI/MLjeremylongshore

shopify-deploy-integration

'Deploy Shopify apps to Vercel, Fly.io, Railway, and Cloud Run with proper

Stars
2,267
Source
jeremylongshore/claude-code-plugins-plus-skills
Updated
2026-05-31
Slug
jeremylongshore--claude-code-plugins-plus-skills--shopify-deploy-integration
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jeremylongshore/claude-code-plugins-plus-skills/HEAD/plugins/saas-packs/shopify-pack/skills/shopify-deploy-integration/SKILL.md -o .claude/skills/shopify-deploy-integration.md

Drops the SKILL.md into .claude/skills/shopify-deploy-integration.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Shopify Deploy Integration

Overview

Deploy Shopify apps to popular hosting platforms. Covers environment configuration, webhook URL setup, and Shopify CLI deployment for extensions.

Prerequisites

  • Shopify app tested locally with shopify app dev
  • Platform CLI installed (vercel, fly, or gcloud)
  • Production API credentials ready
  • shopify.app.toml configured

Instructions

Step 1: Deploy App with Shopify CLI

# Shopify CLI handles extension deployment and app config sync
shopify app deploy

# This uploads:
# - Theme app extensions
# - Function extensions
# - App configuration (URLs, scopes, webhooks)
# But NOT your web app — you host that separately

Step 2: Vercel Deployment

Set environment variables, configure vercel.json for webhooks and function timeouts, and update shopify.app.toml with the Vercel URL.

See Vercel Deployment for the complete configuration.

Step 3: Fly.io Deployment

Configure fly.toml with health checks and min-machines, set secrets via fly secrets set, and deploy.

See Fly.io Deployment for the complete configuration.

Step 4: Google Cloud Run Deployment

Use a multi-stage Dockerfile for minimal image size, deploy with gcloud run deploy, and configure secrets via Secret Manager.

See Cloud Run Deployment for Dockerfile and deploy commands.

Step 5: Post-Deploy Verification

Run health checks, verify webhook endpoints return 401 (no HMAC), test OAuth start, and sync app config.

See Post-Deploy Verification for the complete verification script.

Output

  • App deployed to production hosting
  • Environment variables securely configured
  • Webhook endpoints accessible via HTTPS
  • Health check passing
  • App URLs synced to Shopify Partner Dashboard

Error Handling

Issue Cause Solution
OAuth redirect mismatch App URL not updated Update redirect_urls in shopify.app.toml and deploy
Webhooks not received URL not HTTPS or unreachable Verify public URL, check DNS
Cold start timeout Serverless function slow Set min instances to 1
CSP frame-ancestors error Missing header Add CSP header for *.myshopify.com
shopify app deploy fails CLI token invalid Regenerate at partners.shopify.com

Examples

Environment Variable Checklist

# Required for all deployments:
SHOPIFY_API_KEY=           # From Partner Dashboard
SHOPIFY_API_SECRET=        # From Partner Dashboard
SHOPIFY_SCOPES=            # e.g., "read_products,write_products"
SHOPIFY_APP_URL=           # Your deployed app URL

# For custom/private apps:
SHOPIFY_ACCESS_TOKEN=      # shpat_xxx

# Optional:
SHOPIFY_API_VERSION=       # Default: latest stable. Update quarterly — see shopify.dev/docs/api/usage/versioning
SESSION_SECRET=            # For cookie signing
DATABASE_URL=              # Session storage

Resources