asyavee/medusa-store
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

docs: document incompatibility for Next.js storefront + Node v25 (#14538)

Browse Source
This commit is contained in:
Shahed Nasser
2026-01-14 15:26:26 +02:00
committed by GitHub
parent d60ea7268a
commit 73631604cc
21 changed files with 2042 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
www/apps/resources/app/troubleshooting/_sections/create-medusa-app-errors/nextjs-node-25.mdx
+17
View File
@@ -0,0 +1,17 @@
If you install the Next.js Starter Storefront with Node v25+, you may encounter the following error when starting the storefront:
```bash
[TypeError: localStorage.getItem is not a function]
```
### Why this Error Occurred
This error occurs because the Next.js Starter Storefront uses Next.js v15.3.8, which doesn't yet support Node v25+.
The error is related to changes in Node v25+ that affect how certain web APIs, like `localStorage`, are handled in server-side environments.
---
### How to Fix it
Our team is actively working on updating the Next.js Starter Storefront to support Node v25+. In the meantime, you can resolve this error by downgrading your Node.js version to v24 LTS or lower.