@shopify/ui-extensions not compatible with @shopify/ui-extensions-react

Shopify CLI and Libraries
1

I have reproduced the issue on the latest CLI version.

Yes, I am on the latest version

I have searched existing posts and this report is not a duplicate.

Yes, this isn’t a duplicate

In which of these areas are you experiencing a problem?

Extension

Expected behavior

I want to create a check-ui extension, I already have an admin and customer extension (JSX). I use the CLI to create a new extension, but only typescript is available. Next I use shopify app dev which will fail.

Actual behavior

Type reference for purchase.checkout.block.render could not be found. You   ││  might be using the wrong /ui-extensions version.                    ││                                                                              ││  Fix the error by ensuring you have the correct version of                   ││  /ui-extensions, for example ~2025.10.0, in your dependencies.

Reproduction steps

Install "@shopify/ui-extensions": "2025.7.1" and "@shopify/ui-extensions-react": "2025.7.1".

shopify run dev will fail.

Next, update the dependency:

"@shopify/ui-extensions": "2025.10.0",

Errors:

npm update
npm error code ERESOLVE
npm error ERESOLVE unable to resolve dependency tree
npm error
npm error While resolving: undefined@undefined
npm error Found: @shopify/ui-extensions@2025.10.0
npm error node_modules/@shopify/ui-extensions
npm error   @shopify/ui-extensions@"2025.10.0" from the root project
npm error
npm error Could not resolve dependency:
npm error peer @shopify/ui-extensions@"2025.7.1" from @shopify/ui-extensions-react@2025.7.1
npm error node_modules/@shopify/ui-extensions-react
npm error   @shopify/ui-extensions-react@"2025.7.1" from the root project
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.
npm error

Adding legacy-peer-deps=true will work but it will still break shopify app dev with errors like:

No matching export in 
"node_modules/@shopify/ui-extensions/build/esm/surfaces/checkout.mjs" for import "View"

Verbose output

Operating system

MacOS

CLI version

3.87.4

Shell

zsh

Nodejs version

v22.20.0

2

I believe you need to migrate to Polaris Web Components. Please see this upgrade guide Upgrading to 2025-10

Update your React or JavaScript components to custom elements.

I think @shopify/ui-extensions-react is unlikely to be updated going forward.

3

Thanks Anton. That’s a bit of work :sweat_smile:

For now, I managed to get it working by manually downloading the extension template and get the React version.