Agent skill · software engineering · jeremylongshore
shopify-local-dev-loop
Configure Shopify local development with Shopify CLI, hot reload, and
Why this skill is useful
Adds executable scripts for setting up a Shopify development environment with hot reload and ngrok tunneling that aren't in public docs.
What it needs
Requires node, shopify-cli installed locally. Requires shopify account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Shopify Local Dev Loop Overview Set up a fast, reproducible local development workflow using Shopify CLI, ngrok tunneling for webhooks, and Vitest for testing against the Shopify API. Prerequisites Completed shopify-install-auth setup Node.js 18+ with npm/pnpm Shopify CLI 3.x (npm install -g @shopify/cli) A Shopify Partner account and development store Instructions Step 1: Scaffold with Shopify CLI Step 2: Project Structure Step 3: Configure shopify.app.toml Central app configuration with scopes, auth redirects, and mandatory GDPR webhook subscriptions. See App TOML Config for the complete configuration file. Step 4: Start Dev Server with Tunnel Step 5: Set Up Testing Vitest setup with mocked Shopify API client and recommended package.json scripts for the dev workflow. See Vitest Shopify Mock for the complete test setup. Step 6: GraphQL Explorer for Development Output Shopify CLI dev server running with hot reload Ngrok tunnel forwarding to localhost Test suite with mocked Shopify API calls GraphQL explorer available for API exploration Error Handling Error Cause Solution ------- ------- ---------- Could not find a Shopify partner organization CLI not logged in Run shopify auth login Port 3000 already in use Another process on port Kill process or use --port 3001 Tunnel connection failed ngrok issues Check ngrok status or use --tunnel-url App not installed on store First time setup Open the URL CLI provides, accept install SHOPIFYAPIKEY not set Missing .env Copy from .env.example and fill in values Examples Debug with Request Logging Seed Test Data Resources Shopify CLI Documentation Shopify App Remix Template Vitest Documentation Shopify GraphiQL Explorer
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/shopify-local-dev-loop--438b7a