gabrielmoreira 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.tomlconfigured
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
- Shopify App Deployment
- Vercel Remix Deployment
- Fly.io Node.js
- Cloud Run Quickstart