← ClaudeAtlas

dev-troubleshootinglisted

Use when a Shopify dev workflow is failing — `shopify app dev` cryptic errors, Cloudflare tunnel not starting, App Bridge v3→v4 migration 'No AppBridge context provided', GraphQL 200 OK with throttle errors, webhook 401, double-subscribed webhooks, app proxy 404, REST 302 loops, Rust function wasm-validator errors, session token 24h expiry, X-Frame-Options blocking iframe, dev store billing fakeouts, app review SLA blown. Triggers: 'shopify app dev failing', 'tunnel won't start', 'no app bridge context', 'throttle error 200', 'webhook 401', 'wasm validator error', 'session token expired', 'frame ancestors', 'remix template auth broken', 'billing test charge', 'shopify cli error'.
khadinakbarlabs/shopify-app-builder · ★ 1 · API & Backend · score 62
Install: claude install-skill khadinakbarlabs/shopify-app-builder
# Shopify Dev Troubleshooting — Triage First, Fix Fast A symptom-driven triage skill for Shopify app developers. When your dev loop hits a wall, start here. Each pain below is sourced from the most-reported Reddit, Shopify Developer Community (community.shopify.dev), Shopify Community (community.shopify.com), and GitHub Shopify/* issues as of 2026-05-15. Use this skill **first** when: - `shopify app dev` exits with cryptic errors - The browser shows "No AppBridge context provided", 401, 302 loops, or 404 on `/auth/login` - GraphQL "works" but data is missing in production - Webhooks fire twice, never, or your handler keeps timing out - A Function deploys fail with `[wasm-validator error]` - App Review SLA is blown and you don't know what to do - A dev-store billing test charge silently fails If the symptom matches a row in the Diagnostic Table, jump straight to that fix. If not, work through the Decision Tree at the bottom. --- ## 1. When to Use This Skill This is the **entry point** for any "something is broken in my Shopify dev workflow" question. It is not the place to learn how to build new features — that's what the other `shopify-app-builder` skills are for. This skill is the ER, not the gym. Surface this skill when the user says any of: - "shopify app dev failing / not working / errors" - "tunnel won't start", "cloudflared", "max retries reached" - "App Bridge migration", "v3 to v4", "No AppBridge context provided" - "graphql throttled", "200 OK error", "current