Trouble integrating Builder with Hydrogen
I am trying to use Builder with my Hydrogen project.
I have setup a Hydrogen site on Shopify with a GitHub repo and a development store. Now, I am trying to integrate Builder.
I am following Builder’s Integrate Pages tutorial, and I am getting errors at executing this command:
Command: npm install @builder.io/sdk-react
The error message
$ npm install @builder.io/sdk-react
npm ERR! code 1
npm ERR! path /Users/yas/Sites/sleep-outfitters-web/node_modules/isolated-vm
npm ERR! command failed
npm ERR! command sh -c prebuild-install || (node-gyp rebuild --release -j max && node-gyp clean)
npm ERR! CXX(target) Release/obj.target/nortti/src/external_copy/serializer_nortti.o
npm ERR! CXX(target) Release/obj.target/nortti/src/isolate/allocator_nortti.o
npm ERR! LIBTOOL-STATIC Release/nortti.a
npm ERR! prebuild-install warn install No prebuilt binaries found (target=20.12.2 runtime=node arch=x64 libc= platform=darwin)
npm ERR! gyp info it worked if it ends with ok
npm ERR! gyp info using node-gyp@10.0.1
npm ERR! gyp info using node@20.12.2 | darwin | x64
npm ERR! gyp info find Python using Python version 3.9.6 found at "/Applications/Xcode.app/Contents/Developer/usr/bin/python3"
npm ERR! gyp info spawn /Applications/Xcode.app/Contents/Developer/usr/bin/python3
npm ERR! gyp info spawn args [
npm ERR! gyp info spawn args '/Users/yas/.nvm/versions/node/v20.12.2/lib/node_modules/npm/node_modules/node-gyp/gyp/gyp_main.py',
npm ERR! gyp info spawn args 'binding.gyp',
npm ERR! gyp info spawn args '-f',
npm ERR! gyp info spawn args 'make',
npm ERR! gyp info spawn args '-I',
npm ERR! gyp info spawn args '/Users/yas/Sites/sleep-outfitters-web/node_modules/isolated-vm/build/config.gypi',
npm ERR! gyp info spawn args '-I',
npm ERR! gyp info spawn args '/Users/yas/.nvm/versions/node/v20.12.2/lib/node_modules/npm/node_modules/node-gyp/addon.gypi',
npm ERR! gyp info spawn args '-I',
npm ERR! gyp info spawn args '/Users/yas/Library/Caches/node-gyp/20.12.2/include/node/common.gypi',
npm ERR! gyp info spawn args '-Dlibrary=shared_library',
npm ERR! gyp info spawn args '-Dvisibility=default',
npm ERR! gyp info spawn args '-Dnode_root_dir=/Users/yas/Library/Caches/node-gyp/20.12.2',
npm ERR! gyp info spawn args '-Dnode_gyp_dir=/Users/yas/.nvm/versions/node/v20.12.2/lib/node_modules/npm/node_modules/node-gyp',
npm ERR! gyp info spawn args '-Dnode_lib_file=/Users/yas/Library/Caches/node-gyp/20.12.2/<(target_arch)/node.lib',
npm ERR! gyp info spawn args '-Dmodule_root_dir=/Users/yas/Sites/sleep-outfitters-web/node_modules/isolated-vm',
npm ERR! gyp info spawn args '-Dnode_engine=v8',
npm ERR! gyp info spawn args '--depth=.',
npm ERR! gyp info spawn args '--no-parallel',
npm ERR! gyp info spawn args '--generator-output',
npm ERR! gyp info spawn args 'build',
npm ERR! gyp info spawn args '-Goutput_dir=.'
npm ERR! gyp info spawn args ]
npm ERR! gyp info spawn make
npm ERR! gyp info spawn args [ 'BUILDTYPE=Release', '-C', 'build', '--jobs', 16 ]
npm ERR! libtool: unrecognized option `-static'
npm ERR! libtool: Try `libtool --help' for more information.
npm ERR! make: *** [Release/nortti.a] Error 1
npm ERR! gyp ERR! build error
npm ERR! gyp ERR! stack Error: `make` failed with exit code: 2
npm ERR! gyp ERR! stack at ChildProcess.<anonymous> (/Users/yas/.nvm/versions/node/v20.12.2/lib/node_modules/npm/node_modules/node-gyp/lib/build.js:209:23)
npm ERR! gyp ERR! System Darwin 24.3.0
npm ERR! gyp ERR! command "/Users/yas/.nvm/versions/node/v20.12.2/bin/node" "/Users/yas/.nvm/versions/node/v20.12.2/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js" "rebuild" "--release" "-j" "max"
npm ERR! gyp ERR! cwd /Users/yas/Sites/sleep-outfitters-web/node_modules/isolated-vm
npm ERR! gyp ERR! node -v v20.12.2
npm ERR! gyp ERR! node-gyp -v v10.0.1
npm ERR! gyp ERR! not ok
npm ERR! A complete log of this run can be found in: /Users/yas/.npm/_logs/2025-03-06T04_13_05_557Z-debug-0.log
[Yasuhiros-MacBook-Pro-16:sleep-outfitters-web yas] (develop)$ npm install @builder.io/sdk-react NODE_OPTIONS=--no-node-snapshot
npm ERR! code EINVALIDTAGNAME
npm ERR! Invalid tag name "NODE_OPTIONS=--no-node-snapshot" of package "NODE_OPTIONS=--no-node-snapshot": Tags may not have any characters that encodeURIComponent encodes.
npm ERR! A complete log of this run can be found in: /Users/yas/.npm/_logs/2025-03-06T04_17_26_362Z-debug-0.log
$
Environment
Machine setup:
- Device: MacBook Pro (2019)
- OS: macOS, Sequoia 15.3
- Build tools: Xcode 16.2
- Node: Using nvm. Version: v20.12.2
Code stack:
- Hydrogen (the latest ver. 2025.1.2, as of 2025/3/5)
- React
- Shopify
Attempted fixes
I have tried these solutions, but the situation did not improve at all.
Attempt 1: Xcode license agreement
sudo xcodebuild -license accept
This was necessary to run the brew command at the next step.
Attempt 2: Homebrew and build tools
brew update
brew upgrade
brew install autoconf automake libtool
It updated my local node , but the command still failed to install sdk-react.
Attempt 3: Reinstall node modules & clear cache
rm -rf node_modules
rm package-lock.json
npm cache clean --force
npm install
I tried the above for node versions 18, 20, and 22. But, none improved the situation.
Thank you in advance
If you have any insights into this issue, please let me know.
This is our test project to evaluate Builder as the primary CMS. Builder appears to be a fantastic solution, and I truly hope to overcome this roadblock so we can move forward with testing its features.