How can I fix deploy errors in my Nextjs, React app integration?

Shopify Apps

Topic summary

Main issue: Deploying a Next.js/React Shopify app via Shopify CLI (v3.49.3) fails with a Bundler error when installing the gem ‘racc’ (1.7.1), pulled in via ‘nokogiri’ and ‘theme-check’. Error observed on Ruby 3.2.x; local attempts to fix did not succeed.

Recent updates/workarounds:

  • Works on another machine running Ruby 3.0.
  • Downgrading Ruby to 3.1 resolved the deployment error for others.

Secondary issue: App embed not appearing in the theme editor. To make a theme app extension show under App embeds, define a Liquid schema in the extension’s block file, including at least:

  • name (e.g., “Body Assets”)
  • target (e.g., “body”)
  • settings (can be empty)

Outcomes:

  • Practical workaround identified: use Ruby 3.1 (or 3.0) for deployment.
  • Configuration guidance provided for making the extension visible in App embeds.

Status: Partially resolved. Deployment root cause not established; Ruby downgrade is an effective workaround. App embed visibility addressed via schema configuration.

Summarized with AI on January 17. AI used: gpt-5.
1

Hi, I want to integrate into the Shopify store my app (Nextjs, React) through an Iframe, but the main problems are based on deploy errors and my app doesn’t appear in-app embeds, maybe somebody can help me?

I’m using Shopify CLI version: 3.49.3, when I’m trying to do:

shopify app deploy

I received such error like this one:

/snap/ruby/317/lib/ruby/3.2.0/bundler/installer/parallel_installer.rb:147:in
`block in worker_pool'
  /snap/ruby/317/lib/ruby/3.2.0/bundler/worker.rb:62:in `apply_func'
  /snap/ruby/317/lib/ruby/3.2.0/bundler/worker.rb:57:in `block in process_queue'
  /snap/ruby/317/lib/ruby/3.2.0/bundler/worker.rb:54:in `loop'
  /snap/ruby/317/lib/ruby/3.2.0/bundler/worker.rb:54:in `process_queue'
/snap/ruby/317/lib/ruby/3.2.0/bundler/worker.rb:90:in `block (2 levels) in
create_threads'

An error occurred while installing racc (1.7.1), and Bundler cannot continue.

In Gemfile:
  theme-check was resolved to 1.15.0, which depends on
    nokogiri was resolved to 1.15.4, which depends on
      racc
Fetching gem metadata from https://rubygems.org/........
Resolving dependencies...
Using ast 2.4.2
Using bundler 2.4.10
Using liquid 5.4.0
Installing racc 1.7.1 with native extensions

I tried locally to fix this issue, but I didn’t have any results.

What could I do to fix this issue, I’ll be very grateful if somebody has a solution for this issue.

2

Having the same issue on Ruby 3.2.2. Seems to work fine on another machine with Ruby 3.0 but still trying to figure out exactly what the root cause is.

3

Downgrading Ruby to 3.1 did fix it for us.

4

Thank you for suggestion, but how make my extensions appear in the App embed and integrate into the website, do you know?

5

To make extensions appear in the App Embeddeds you need to configure schema inside block file like this.

{% schema %}
{
“name”: “Body Assets”,
“target”: “body”,
“settings”:[

]
}
{% endschema %}