[{"data":1,"prerenderedAt":231},["ShallowReactive",2],{"i-mdi:github":3,"i-mdi:linkedin":8,"i-mdi:instagram":10,"project-shopify-app-tanstack":12,"i-lineicons:react":219,"i-solar:arrow-left-linear":221,"i-solar:pen-2-linear":223,"i-lineicons:shopify":225,"i-lineicons:javascript":227,"i-lineicons:typescript":229},{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":7},0,24,false,"\u003Cpath fill=\"currentColor\" d=\"M12 2A10 10 0 0 0 2 12c0 4.42 2.87 8.17 6.84 9.5c.5.08.66-.23.66-.5v-1.69c-2.77.6-3.36-1.34-3.36-1.34c-.46-1.16-1.11-1.47-1.11-1.47c-.91-.62.07-.6.07-.6c1 .07 1.53 1.03 1.53 1.03c.87 1.52 2.34 1.07 2.91.83c.09-.65.35-1.09.63-1.34c-2.22-.25-4.55-1.11-4.55-4.92c0-1.11.38-2 1.03-2.71c-.1-.25-.45-1.29.1-2.64c0 0 .84-.27 2.75 1.02c.79-.22 1.65-.33 2.5-.33s1.71.11 2.5.33c1.91-1.29 2.75-1.02 2.75-1.02c.55 1.35.2 2.39.1 2.64c.65.71 1.03 1.6 1.03 2.71c0 3.82-2.34 4.66-4.57 4.91c.36.31.69.92.69 1.85V21c0 .27.16.59.67.5C19.14 20.16 22 16.42 22 12A10 10 0 0 0 12 2\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":9},"\u003Cpath fill=\"currentColor\" d=\"M19 3a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2zm-.5 15.5v-5.3a3.26 3.26 0 0 0-3.26-3.26c-.85 0-1.84.52-2.32 1.3v-1.11h-2.79v8.37h2.79v-4.93c0-.77.62-1.4 1.39-1.4a1.4 1.4 0 0 1 1.4 1.4v4.93zM6.88 8.56a1.68 1.68 0 0 0 1.68-1.68c0-.93-.75-1.69-1.68-1.69a1.69 1.69 0 0 0-1.69 1.69c0 .93.76 1.68 1.69 1.68m1.39 9.94v-8.37H5.5v8.37z\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":11},"\u003Cpath fill=\"currentColor\" d=\"M7.8 2h8.4C19.4 2 22 4.6 22 7.8v8.4a5.8 5.8 0 0 1-5.8 5.8H7.8C4.6 22 2 19.4 2 16.2V7.8A5.8 5.8 0 0 1 7.8 2m-.2 2A3.6 3.6 0 0 0 4 7.6v8.8C4 18.39 5.61 20 7.6 20h8.8a3.6 3.6 0 0 0 3.6-3.6V7.6C20 5.61 18.39 4 16.4 4zm9.65 1.5a1.25 1.25 0 0 1 1.25 1.25A1.25 1.25 0 0 1 17.25 8A1.25 1.25 0 0 1 16 6.75a1.25 1.25 0 0 1 1.25-1.25M12 7a5 5 0 0 1 5 5a5 5 0 0 1-5 5a5 5 0 0 1-5-5a5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3a3 3 0 0 0 3 3a3 3 0 0 0 3-3a3 3 0 0 0-3-3\"\u002F>",{"id":13,"title":14,"active":15,"body":16,"collaborators":199,"color":201,"date":202,"description":203,"extension":204,"github_url":99,"icon":205,"image":206,"meta":207,"month":208,"navigation":15,"path":209,"seo":210,"sitemap":211,"stacks":212,"status":202,"stem":217,"url":202,"__hash__":218},"project\u002Fproject\u002F11.shopify-app-tanstack.md","Shopify App TanStack React",true,{"type":17,"value":18,"toc":188},"minimark",[19,24,28,32,35,39,86,90,121,124,128,142,146,149,153,185],[20,21,23],"h2",{"id":22},"problem-summary","Problem Summary",[25,26,27],"p",{},"Shopify provides APIs, CLI, and templates, but the app development experience is often fragmented. Most official starters are built for Remix or Next.js, and the React ecosystem lacks a truly modern, flexible starter that leverages TanStack's best-in-class libraries. Developers end up re-implementing authentication, embedded context, and API patterns from scratch.",[20,29,31],{"id":30},"solution","Solution",[25,33,34],{},"Shopify App TanStack React offers a ready-to-use foundation for building Shopify Apps with React and the TanStack suite. It's not just a boilerplate, but a real-world, production-tested foundation that is easy to adapt and extend.",[20,36,38],{"id":37},"key-features","Key Features",[40,41,42,50,56,62,68,74,80],"ul",{},[43,44,45,49],"li",{},[46,47,48],"strong",{},"Modern React + TanStack",": Uses TanStack Router, Query, Table, and more for best-in-class DX and scalability.",[43,51,52,55],{},[46,53,54],{},"Production-ready authentication",": Shopify OAuth flow fully integrated.",[43,57,58,61],{},[46,59,60],{},"Embedded App support",": Works seamlessly inside Shopify Admin with App Bridge.",[43,63,64,67],{},[46,65,66],{},"Polaris UI",": Native Shopify UI components out of the box.",[43,69,70,73],{},[46,71,72],{},"API integration layer",": Clean separation of API logic using TanStack Query.",[43,75,76,79],{},[46,77,78],{},"TypeScript-first",": Fully typed for safety and maintainability.",[43,81,82,85],{},[46,83,84],{},"Deployment-ready",": Works on Vercel, Render, and other modern platforms.",[20,87,89],{"id":88},"quick-start","Quick Start",[91,92,93,103,106,118],"ol",{},[43,94,95,96],{},"Clone the repo: ",[97,98,102],"a",{"href":99,"rel":100},"https:\u002F\u002Fgithub.com\u002Fyan-ad\u002Fshopify-app-tanstack",[101],"nofollow","github.com\u002Fyan-ad\u002Fshopify-app-tanstack",[43,104,105],{},"Follow the README to set up your Shopify API key & secret.",[43,107,108,109,113,114,117],{},"Run the development server (",[110,111,112],"code",{},"pnpm dev"," or ",[110,115,116],{},"yarn dev",") and start building your app.",[43,119,120],{},"Deploy to Vercel, Render, or your preferred platform.",[25,122,123],{},"Demo: (coming soon)",[20,125,127],{"id":126},"benefits-for-developers","Benefits for Developers",[40,129,130,133,136,139],{},[43,131,132],{},"No need to reinvent authentication, embedded context, or API patterns.",[43,134,135],{},"Modern, scalable codebase with TanStack best practices.",[43,137,138],{},"Focus on business features, not boilerplate.",[43,140,141],{},"Transparent, easy to debug, and production-ready.",[20,143,145],{"id":144},"why-not-just-another-boilerplate","Why Not Just Another Boilerplate?",[25,147,148],{},"This project was born from real-world needs of building Shopify Apps with React and TanStack. Every new project faces the same issues: authentication, API, embedded context, deployment. With this starter, everything is ready—just focus on your main features.",[20,150,152],{"id":151},"useful-links","Useful Links",[40,154,155,161,169,177],{},[43,156,157,158],{},"Repo: ",[97,159,102],{"href":99,"rel":160},[101],[43,162,163,164],{},"Shopify Docs: ",[97,165,168],{"href":166,"rel":167},"https:\u002F\u002Fshopify.dev\u002Fdocs\u002Fapps\u002Fgetting-started\u002Fcreate",[101],"shopify.dev",[43,170,171,172],{},"TanStack: ",[97,173,176],{"href":174,"rel":175},"https:\u002F\u002Ftanstack.com\u002F",[101],"tanstack.com",[43,178,179,180],{},"Polaris: ",[97,181,184],{"href":182,"rel":183},"https:\u002F\u002Fpolaris.shopify.com\u002F",[101],"Shopify Polaris",[25,186,187],{},"Shopify App TanStack React helps developers build modern Shopify Apps with React and TanStack faster, safer, and with a clear structure. No more repeating the same setup—just focus on business value and core features.",{"title":189,"searchDepth":190,"depth":190,"links":191},"",2,[192,193,194,195,196,197,198],{"id":22,"depth":190,"text":23},{"id":30,"depth":190,"text":31},{"id":37,"depth":190,"text":38},{"id":88,"depth":190,"text":89},{"id":126,"depth":190,"text":127},{"id":144,"depth":190,"text":145},{"id":151,"depth":190,"text":152},[200],"yan-ad","rgb(34, 197, 94)",null,"A modern Shopify App starter built with React and TanStack, featuring authentication, webhooks, Polaris, App Bridge, and a production-ready structure. Inspired by @shopify\u002Fshopify-app-react, but with TanStack best practices and DX.","md","simple-icons:shopify","\u002Fimages\u002Fproject\u002Fshopify.webp",{},"2026-03","\u002Fproject\u002Fshopify-app-tanstack",{"title":14,"description":203},{"loc":209},[213,214,215,216],"react","shopify","typescript","javascript","project\u002F11.shopify-app-tanstack","JetX3d8xA88pet2GXsyg0-SgpdTIsPXyTEiT2evHgDE",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":220},"\u003Cpath fill=\"currentColor\" d=\"M18.323 9.007c-.226-.033-.42-.13-.646-.194c.033-.129.033-.258.097-.452c.452-2.322.13-4.16-.903-4.806c-1.032-.58-2.71.032-4.387 1.484c-.13.129-.355.258-.484.451c-.097-.096-.226-.193-.323-.322c-1.774-1.58-3.516-2.226-4.612-1.613c-1.033.58-1.355 2.355-.904 4.516c.033.226.097.452.13.645c-.226.033-.485.13-.71.226C3.484 9.684 2 10.878 2 12.007c0 1.225 1.58 2.451 3.742 3.16c.193.033.355.13.548.13c-.032.226-.129.451-.129.71c-.42 2.129-.096 3.838.936 4.419c1.032.645 2.838 0 4.516-1.548c.129-.13.258-.226.42-.355a4 4 0 0 0 .548.451c1.613 1.452 3.29 2.033 4.355 1.452c1.032-.645 1.387-2.452.935-4.71c-.032-.129-.032-.354-.13-.548c.13-.032.227-.032.356-.13C20.355 14.362 22 13.137 22 11.91c-.032-1-1.58-2.161-3.677-2.903m-5.29-3.29c1.45-1.259 2.806-1.71 3.45-1.388c.646.355.904 1.903.485 3.936c-.032.129-.032.225-.097.419c-.871-.194-1.71-.355-2.613-.42c-.484-.709-1.032-1.45-1.613-2.032a1.8 1.8 0 0 1 .387-.516M8.547 14.07c.194.355.42.678.646 1a10.6 10.6 0 0 1-1.807-.258a8 8 0 0 1 .645-1.71c.13.29.355.678.516.968m-1.16-4.645a22 22 0 0 1 1.773-.323c-.226.323-.42.646-.58 1c-.162.355-.355.646-.549 1.033c-.29-.613-.451-1.162-.645-1.71m1.031 2.677c.226-.548.549-1.032.871-1.58c.323-.549.645-1.033.936-1.549c.58-.032 1.161-.032 1.774-.032c.58 0 1.226.032 1.774.032c.355.484.645 1 .936 1.484c.322.484.58 1.033.87 1.58c-.225.55-.548 1.033-.87 1.582c-.323.548-.646 1.032-.936 1.548c-.58.032-1.161.032-1.806.032s-1.226-.032-1.774-.032c-.355-.484-.646-1-.936-1.548c-.29-.549-.548-.968-.839-1.517m7.033 1.968c.193-.355.354-.677.548-1.032c.226.548.452 1.129.645 1.71c-.58.129-1.226.225-1.87.322c.257-.322.483-.677.677-1m.58-2.968c-.193-.354-.355-.677-.548-1.032s-.42-.645-.58-.935a22 22 0 0 1 1.773.322c-.193.549-.419 1.097-.645 1.645M12 6.75c.42.451.774.903 1.129 1.387a28 28 0 0 0-2.322 0c.419-.516.838-.968 1.193-1.387M7.484 4.36c.645-.354 2.129.13 3.613 1.549c.097.097.193.193.322.258c-.58.645-1.129 1.355-1.677 2.032a23 23 0 0 0-2.613.42c-.032-.194-.097-.42-.129-.581c-.355-1.903-.129-3.323.484-3.678M6.58 14.62c-.13-.033-.323-.097-.484-.13a7.2 7.2 0 0 1-2.484-1.225c-.452-.323-.678-.71-.774-1.162c0-.71 1.258-1.612 3.032-2.258c.226-.096.452-.129.677-.225c.258.87.581 1.677.936 2.483c-.323.807-.678 1.613-.903 2.517m4.484 3.774a7.1 7.1 0 0 1-2.226 1.355a1.54 1.54 0 0 1-1.355.032c-.645-.355-.871-1.71-.549-3.58c.033-.227.097-.452.13-.646c.87.194 1.774.323 2.612.355c.484.71 1.097 1.451 1.678 2.097c-.032.193-.162.29-.29.387m.967-.903c-.42-.452-.774-.904-1.161-1.388c.355 0 .71.033 1.129.033s.806 0 1.161-.033c-.354.42-.71.871-1.129 1.387m5.097 1.128c-.032.452-.258.936-.645 1.226c-.645.355-1.936-.096-3.355-1.354c-.129-.13-.322-.259-.484-.452a17 17 0 0 0 1.613-2.097c.903-.032 1.774-.226 2.613-.42c.032.13.032.323.097.452c.226.904.226 1.807.161 2.645m.71-4.16c-.097.032-.226.032-.355.096c-.258-.871-.645-1.677-1-2.484c.355-.774.677-1.613.935-2.451c.226.032.42.129.581.193c1.806.645 3.064 1.548 3.064 2.258c.033.742-1.29 1.742-3.225 2.387M12 13.844c1 0 1.774-.806 1.774-1.774A1.79 1.79 0 0 0 12 10.297c-.935 0-1.774.806-1.774 1.774S11 13.845 12 13.845\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":222},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"1.5\" d=\"M20 12H4m0 0l6-6m-6 6l6 6\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":224},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\">\u003Cpath stroke-linecap=\"round\" d=\"M4 22h16\"\u002F>\u003Cpath d=\"m13.888 3.663l.742-.742a3.146 3.146 0 1 1 4.449 4.45l-.742.74m-4.449-4.448s.093 1.576 1.483 2.966s2.966 1.483 2.966 1.483m-4.449-4.45L7.071 10.48c-.462.462-.693.692-.891.947a5.2 5.2 0 0 0-.599.969c-.139.291-.242.601-.449 1.22l-.875 2.626m14.08-8.13l-6.817 6.817c-.462.462-.692.692-.947.891q-.451.352-.969.599c-.291.139-.601.242-1.22.448l-2.626.876m0 0l-.641.213a.848.848 0 0 1-1.073-1.073l.213-.641m1.501 1.5l-1.5-1.5\"\u002F>\u003C\u002Fg>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":226},"\u003Cpath fill=\"currentColor\" fill-rule=\"evenodd\" d=\"M14.625 4.499c.374-.126.624-.126.624-.126L14.503 22L3.252 19.875S4.75 8.5 4.75 8.125c0-.498 0-.498.624-.749c.054 0 .203-.047.435-.121a21 21 0 0 1 1.314-.38C7.5 5.25 8.75 2 11.374 2c.377 0 .75.123 1 .624h.126c1.125 0 1.75.875 2.125 1.875m-3.542 1.137c.438-.134.891-.272 1.292-.513c0-.75-.126-1.251-.251-1.752c-.624.25-1.373 1-1.75 2.501a9 9 0 0 1 .709-.236m.542-2.761c-.125-.126-.25-.126-.376-.126c-1.752 0-2.874 2.374-3.25 3.878c.25-.063.5-.157.75-.251s.5-.188.751-.25c.376-2 1.376-2.875 2.125-3.251m-1.376 8.122c.75 0 1.499.376 1.499.376l.499-2.248s-.499-.25-1.499-.25c-2.75 0-4 1.749-4 3.624c0 1.26.708 1.814 1.33 2.3c.487.38.92.72.92 1.324c0 .248-.125.749-.749.749c-.874 0-1.874-.875-1.874-.875l-.502 1.75s1 1.25 3 1.25c1.624 0 2.875-1.25 2.875-3.125c0-1.53-1.031-2.265-1.83-2.833c-.507-.36-.92-.654-.92-1.042c0-.25 0-1 1.251-1m2.499-7.626c.125.376.25.877.25 1.501v.125c.189 0 .345-.031.5-.062c.157-.032.313-.063.5-.063c-.25-.752-.626-1.501-1.25-1.501m5.624 2.376c.125 0 .25 0 .25.125c0 .063.538 3.79 1.072 7.498c.528 3.668 1.054 7.316 1.054 7.377l-6 1.25l.75-17.498h.125l1.125 1.122s1.499.126 1.624.126\" clip-rule=\"evenodd\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":228},"\u003Cpath fill=\"currentColor\" d=\"M3 3v18h18V3zm9.813 14.023c0 1.77-1.045 2.584-2.555 2.584c-1.335 0-2.12-.697-2.526-1.568l1.394-.871c.232.493.493.87 1.103.87c.58 0 .9-.203.9-1.073v-5.69h1.684zm4.006 2.584c-1.567 0-2.583-.784-3.106-1.713l1.394-.813c.377.58.87 1.016 1.683 1.016c.697 0 1.133-.32 1.133-.871c0-.58-.436-.784-1.22-1.133l-.406-.174c-1.22-.493-2.033-1.19-2.033-2.584c0-1.277.93-2.206 2.468-2.206c1.075 0 1.83.378 2.38 1.364l-1.305.871c-.29-.493-.581-.725-1.104-.725c-.493 0-.813.32-.813.726c0 .493.32.696 1.017 1.016l.406.174c1.422.61 2.264 1.22 2.264 2.67c.03 1.54-1.16 2.381-2.758 2.381\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":230},"\u003Cpath fill=\"currentColor\" d=\"M19.131 3H4.869c-.955 0-1.73.787-1.73 1.758v14.484c0 .97.775 1.758 1.73 1.758h14.262c.956 0 1.73-.787 1.73-1.758V4.758c0-.97-.774-1.758-1.73-1.758m-5.712 9.984h-2.215v6.434H9.439v-6.434H7.223v-1.441h6.196zm5.712 5.277c-.139.317-.377.552-.658.739a3 3 0 0 1-.969.386a5.6 5.6 0 0 1-1.177.12a6.5 6.5 0 0 1-1.211-.11a3.7 3.7 0 0 1-1.004-.33v-1.689l-.066-.053l.066-.015v.068q.441.357.972.545c.347.133.727.2 1.108.2c.242 0 .426-.021.589-.06a1.4 1.4 0 0 0 .415-.168a.7.7 0 0 0 .246-.253a.7.7 0 0 0-.052-.738a1.3 1.3 0 0 0-.346-.335a3 3 0 0 0-.52-.295c-.207-.095-.418-.194-.657-.292c-.589-.281-1.053-.562-1.35-.95c-.301-.35-.45-.808-.45-1.335c0-.422.08-.76.242-1.055c.173-.316.377-.548.658-.738c.277-.193.588-.334.969-.422c.38-.088.762-.133 1.177-.133s.762.024 1.073.073c.311.05.602.127.865.229v1.652a2.3 2.3 0 0 0-.415-.242a3.8 3.8 0 0 0-.97-.275a3 3 0 0 0-.45-.033a2.4 2.4 0 0 0-.553.057a1.3 1.3 0 0 0-.416.161a.8.8 0 0 0-.26.25a.6.6 0 0 0-.093.327q0 .194.104.351q.103.152.295.296c.114.091.27.183.45.274c.207.091.394.183.623.278c.311.133.588.281.83.422c.243.14.447.305.623.492c.187.175.322.387.416.633s.142.523.142.843c0 .457-.108.809-.246 1.125\"\u002F>",1779378197369]