Skip to content

Commit 313d801

Browse files
adevinwildAdil
andauthored
docs: add troubleshooting guide for white screen issue on admin… (medusajs#12307)
* feat(docs): add troubleshooting guide for white screen issue on admin dashboard * feat(docs): added white-screen to sidebar --------- Co-authored-by: Adil <abasri@webexpr.dev>
1 parent 4befb8f commit 313d801

2 files changed

Lines changed: 31 additions & 0 deletions

File tree

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: 'White Screen on Admin Dashboard'
3+
---
4+
5+
## White Screen in Production Mode
6+
7+
If you're experiencing a white screen in the Admin Dashboard when running in production mode, it may be related to dependency resolution issues, particularly with the `@swc/core` package.
8+
9+
The issue is specifically related to version 1.11.22 of `@swc/core` released on April 23, 2025, so any version prior to 1.11.22 should resolve the problem.
10+
11+
To resolve this issue, add a specific version of `@swc/core` to the `resolutions` or `overrides` fields in your `package.json` file:
12+
13+
```json
14+
{
15+
"overrides": {
16+
"@swc/core": "1.11.21"
17+
},
18+
"resolutions": {
19+
"@swc/core": "1.11.21"
20+
}
21+
}
22+
```
23+
24+
After adding this package override, reinstall your dependencies and try running in production mode again.
25+
26+
This ensures that all dependencies across your dependency graph use a compatible version of `@swc/core` that doesn't cause rendering issues in the admin dashboard.

www/apps/docs/sidebars.js

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2259,6 +2259,11 @@ module.exports = {
22592259
id: "troubleshooting/admin-webpack-build-types",
22602260
label: "Webpack Build Error",
22612261
},
2262+
{
2263+
type: "doc",
2264+
id: "troubleshooting/white-screen-on-admin",
2265+
label: "White Screen on Admin Dashboard",
2266+
},
22622267
],
22632268
},
22642269
{

0 commit comments

Comments
 (0)