node version 20.10.0 required for polaris
We need clarification on how we can upgrade Node.js to 20.10.0 from 20.9.0 for Polaris. We were not expecting to hit this type of issue with default Shopify dependencies.
17 Replies
Hello,
Could you please share where you're having this issue and the error that you're seeing? Please also share the name of the application that you're working on
app: sitepulse-laurel-denise ---- error: 9/19/2025, 9:33:15 AM
error sitepulse-ai@0.1.0: The engine "node" is incompatible with this module. Expected version ">=20.10.0". Got "20.9.0"
9/19/2025, 9:33:15 AM
error sitepulse-ai@0.1.0: The engine "node" is incompatible with this module. Expected version ">=20.10.0". Got "20.9.0"
9/19/2025, 9:33:15 AM
error sitepulse-ai@0.1.0: The engine "node" is incompatible with this module. Expected version ">=20.10.0". Got "20.9.0"
9/19/2025, 9:33:15 AM
error sitepulse-ai@0.1.0: The engine "node" is incompatible with this module. Expected version ">=20.10.0". Got "20.9.0"
yarn install error
error: {"message":"Remote pr...
{"message":"Remote procedure call failed: Command failed with exit code 1: yarn install --check-files\nerror sitepulse-ai@0.1.0: The engine "node" is incompatible with this module. Expected version ">=20.10.0". Got "20.9.0"\nerror Found incompatible module.\nyarn install v1.22.22\ninfo No lockfile found.\n[1/5] Validating package.json...\ninfo Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command."}
{
"message": "Remote procedure call failed: Command failed with exit code 1: yarn install --check-files\nerror sitepulse-ai@0.1.0: The engine "node" is incompatible with this module. Expected version ">=20.10.0". Got "20.9.0"\nerror Found incompatible module.\nyarn install v1.22.22\ninfo No lockfile found.\n[1/5] Validating package.json...\ninfo Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command."
}
We've been juggling 20.10.0 vs 20.9.0 trying to figure out a way forward, and also looked for older Polaris, but ideally we'd like to just make sure that Gadget runs on the best Node version for Shopify
Could you please share the URL of your application?
Sure, but I don't think this is an app specific problem ,I believe it's a gadget node version vs Polaris required version, but could be wrong. I'll grab URL
https://sitepulse-laurel-denise.gadget.app/api/shopify/install-or-render
I'm on the latest version of Gadget's framework and the latest version of Polaris and don't have any issues. I believe that this is an app related issue
You're on framework version 1.0.0. The latest Gadget framework is 1.4.0 and works with the latest Polaris 13.9.5
Got it, had a feeling it could be related to Gadget framework version
Any idea how big the lift is from 1.0 to 1.4?
i inherited this project, I appreciate your help, trying to get this thing up to date
& yes agreed, app-specific
Its not a super big lift but we can guide you through it if you have questions. There are some breaking changes to be aware of but they will be outlined in the upgrade
Do you know roughly how much time we should dedicate to 1.0 to 1.4? Assuming we will need to rework some actions, routes, etc, but just curious if you can ballpark it?
Won't hold you to it, just trying to understand if we're looking at 5 hours, 10 hours, 50, or 100 kind of thing in general
It depends on the size of the application. This is especially hard for me to tell you because I have less context into your application that you
Note that there are also some functionality improvements to be considered. We added a ton of features like Gelly computed views and background actions (to name a couple) that can help you reduce app runtime.
Thanks, are those features required? Truthfully, my goal here is to get it compatible and running and we're going to be doing some real market testing with current clients before further dev
We have another gadget project on the newest versions that we're focused on, so really just trying to bring this legacy project up and leave it for 1-2 months
They aren't required but are super powerful tools
Yeah background actions soudn good and just checked out some of the Gelly docs, that does seem useful
I'm going to mark this as closed since it's been resolved
Do you like this answer?