About

Imported from jeremylongshore/tons-of-skills-marketplace (plugins/saas-packs/shopify-pack/skills/shopify-multi-env-setup/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill shopify-multi-env-setup. Copyright stays with the author (MIT).

Shopify Multi-Environment Setup

Name: shopify-multi-env-setup
Author: jeremylongshore

Overview

Configure Shopify apps with isolated development, staging, and production environments. Each environment uses a separate Shopify app instance, development store, and credentials.

Prerequisites

Shopify Partner account
Multiple development stores (free to create in Partner Dashboard)
Secret management solution for production (Vault, AWS Secrets Manager, etc.)

Instructions

Step 1: Create Separate App Instances

Create one app per environment in your Partner Dashboard:

Environment	App Name	Store	Purpose
Development	My App (Dev)	dev-store.myshopify.com	Local development
Staging	My App (Staging)	staging-store.myshopify.com	Pre-prod testing
Production	My App	live-store.myshopify.com	Live traffic

Each app gets its own API_KEY, API_SECRET, and ACCESS_TOKEN.

Step 2: Environment Configuration Files

Create .env.* files for each environment and corresponding Shopify CLI TOML configs. Production secrets should never be stored on disk -- use a secret manager.

See Environment Config Files for the complete .env and .toml configuration templates.

Step 3: Environment-Aware Configuration

TypeScript config module that loads environment-specific settings (debug mode, session storage type) with LATEST_API_VERSION from @shopify/shopify-api.

See Environment-Aware Config for the complete implementation.

Step 4: Environment Guards

Safety functions that prevent dangerous operations from running in the wrong environment (e.g., blocking test data seeding in production, requiring production for billing activation).

See Environment Guards for the complete implementation.

Output

Isolated environments with separate app instances
Environment-specific configuration loading
Shopify CLI configured for multi-env workflow
Safety guards preventing cross-environment mistakes

Error Handling

Issue	Cause	Solution
Wrong store in dev	Using prod .env	Verify `SHOPIFY_STORE` in your .env file
OAuth fails on staging	Wrong redirect URL	Update redirect_urls in staging app config
Webhooks not received	URL mismatch	Each environment needs its own webhook URLs
Production guard triggered	Wrong NODE_ENV	Set NODE_ENV correctly in deployment platform

Examples

Development Store Quick Setup

# Create a development store from Partner Dashboard
# Partners > Stores > Add store > Development store

# Install your dev app on the dev store
shopify app dev --store=dev-store.myshopify.com

# Populate test data
shopify populate products --count=25
shopify populate orders --count=10
shopify populate customers --count=20

Resources

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-shopify-multi-5ba895/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-shopify-multi-5ba895.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-shopify-multi-5ba895",
  "kind": "skill",
  "name": "shopify-multi-env-setup",
  "description": "Configure Shopify apps across development, staging, and production environments with separate stores, API credentials, and app instances. Use when setting up isolated dev/staging/prod environments for a Shopify app, managing multiple development stores, or configuring per-environment credentials. Trigger with phrases like \"shopify environments\", \"shopify staging\", \"shopify dev vs prod\", \"shopify multi-store\", \"shopify environment setup\".",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "saas",
      "ecommerce",
      "shopify",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Configure Shopify apps across development, staging, and production environments with separate stores, API credentials, and app instances. Use when setting up isolated dev/staging/prod environments for a Shopify app, managing multiple development stores, or configuring per-environment credentials. Trigger with phrases like \"shopify environments\", \"shopify staging\", \"shopify dev vs prod\", \"shopify multi-store\", \"shopify environment setup\"."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "plugins/saas-packs/shopify-pack/skills/shopify-multi-env-setup/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/saas-packs/shopify-pack/skills/shopify-multi-env-setup/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/plugins/saas-packs/shopify-pack/skills/shopify-multi-env-setup/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Read,",
      "Write,",
      "Edit,",
      "Bash(shopify:*)"
    ],
    "license": "MIT"
  },
  "instructions": "# Shopify Multi-Environment Setup\n\n## Overview\n\nConfigure Shopify apps with isolated development, staging, and production environments. Each environment uses a separate Shopify app instance, development store, and credentials.\n\n## Prerequisites\n\n- Shopify Partner account\n- Multiple development stores (free to create in Partner Dashboard)\n- Secret management solution for production (Vault, AWS Secrets Manager, etc.)\n\n## Instructions\n\n### Step 1: Create Separate App Instances\n\nCreate one app per environment in your Partner Dashboard:\n\n| Environment | App Name | Store | Purpose |\n|-------------|-",
  "cost": {
    "context_tokens": 789
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-shopify-multi-5ba895/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.