dev-troubleshootinglisted
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