| 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".
|
| allowed-tools | Read, Write, Edit, Bash(shopify:*) |
| version | 2.7.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","ecommerce","shopify"] |
| compatibility | Designed for Claude Code |
Shopify Multi-Environment Setup
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
