You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
It may help future users if the starter template:
• pins the compatible versions in package.json
• or adds a note in the README about Next 14 + React 18 compatibility
Thanks — hope this saves someone else a debugging rabbit hole!
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
Uh oh!
There was an error while loading. Please reload this page.
-
If you clone the starter today using Yarn 4 / pnpm, the dependencies auto-upgrade to:
• Next 15.x
• React 19 RC
• React-DOM 19 RC
These versions are not compatible with the Medusa Next storefront starter, which is based on the Next 14 + React 18 “pages” router pattern.
This results in a build-time error:
Error: <Html> should not be imported outside of pages/_document. Read more: https://nextjs.org/docs/messages/no-document-import-in-pageEven if your project never imports next/document anywhere except pages/_document.tsx.
✅ FIX
Pin versions manually:
After downgrading, the error disappears.
💡 Suggestion
It may help future users if the starter template:
• pins the compatible versions in package.json
• or adds a note in the README about Next 14 + React 18 compatibility
Thanks — hope this saves someone else a debugging rabbit hole!
Beta Was this translation helpful? Give feedback.
All reactions