Use React in app block theme extension

Retired Boards Appdev Store Design
,

Topic summary

Developers are exploring how to use React within Shopify theme app extensions, which traditionally rely on Liquid templates and vanilla JavaScript. The core challenge is that app blocks don’t natively support React frameworks.

Established Solution:

  • Bundle React apps into a single JavaScript file using tools like Webpack or Vite
  • Reference the bundled file (e.g., bundle.js) in the app-block’s Liquid schema under the javascript property
  • Create React source code in a separate folder outside the extension directory
  • Configure the build tool to output the compiled bundle into the extension’s /assets folder

Common Implementation Issues:

  • React requires a DOM element to mount to, which must be defined in the .liquid file
  • Asset management (images, CSS) becomes complicated when transitioning from Liquid to React
  • Developers struggle with proper folder structure and build configuration
  • Size limits and Shopify’s restrictions on extension folder contents create constraints

Resources & Alternatives:

  • A community member shared a template repository demonstrating React + Tailwind CSS setup
  • Settings can be passed from Liquid schema to React via data attributes on the root div
  • At least one developer abandoned this approach entirely, opting to embed their React app as an externally-hosted iframe

Status: The discussion remains open with ongoing questions about asset handling and build configuration. Multiple participants note that Shopify’s documentation lacks comprehensive guidance on React integration.

Summarized with AI on October 25. AI used: claude-sonnet-4-5-20250929.
18

You should be able to accomplish it the way you described; your app code should not need to be in the extensions folder alongside the block. (in fact it probably shouldn’t as there is something like a 10MB size limit for these and Shopify is very strict about the extensions folder’s architecture).

All you should need in your assets folder is your app’s static js and css files. Just be sure to reference it correctly in your liquid file schema. It should look something like:


{% schema %}
{
"name": "ReactApp",
"javascript": "index.js",
"stylesheet": "index.css",
"target": "section",
"settings": []
}
{% endschema %}

That should work assuming it’s packaged correctly.

1 Like