docs: add troubleshooting guide for pnpm installations (#13351)

2025-08-29 18:03:03 +03:00
1 parent f39ba53fd3
commit c603540562
@@ -0,0 +1,23 @@
+If you use `pnpm` as a package manager in your Medusa application, you might face errors about missing packages. For example:
+
+```bash
+can't resolve @medusajs/dashboard
+```
+
+## Why This Error Occurred
+
+Medusa doesn't officially support `pnpm` as a package manager, which may lead to unexpected errors, including issues with package resolution.
+
+---
+
+## How to Fix it
+
+To resolve this error and other potential errors, consider switching to `yarn` as your package manager.
+
+If you still want to use `pnpm`, you must manually install the following packages in your project:
+
+```bash
+pnpm add @medusajs/dashboard @medusajs/icons @meduasjs/types @medusajs/draft-order @medusajs/ui
+```
+
+Make sure to also update these packages whenever you update your Medusa application.
@@ -0,0 +1,9 @@
+import PnpmSection from "../_sections/common-installation-errors/pnpm.mdx"
+
+export const metadata = {
+  title: `Errors with pnpm`,
+}
+
+# {metadata.title}
+
+<PnpmSection />
@@ -6570,5 +6570,6 @@ export const generatedEditDates = {
  "app/integrations/guides/payload/page.mdx": "2025-08-21T05:24:11.537Z",
  "references/js_sdk/admin/Client/methods/js_sdk.admin.Client.getToken/page.mdx": "2025-08-14T12:59:55.678Z",
  "app/commerce-modules/order/draft-orders/page.mdx": "2025-08-26T09:21:49.780Z",
-  "app/troubleshooting/scheduled-job-not-running/page.mdx": "2025-08-29T11:32:54.117Z"
+  "app/troubleshooting/scheduled-job-not-running/page.mdx": "2025-08-29T11:32:54.117Z",
+  "app/troubleshooting/pnpm/page.mdx": "2025-08-29T12:21:24.692Z"
 }
@@ -1423,6 +1423,10 @@ export const filesMap = [
    "filePath": "/www/apps/resources/app/troubleshooting/payment/page.mdx",
    "pathname": "/troubleshooting/payment"
  },
+  {
+    "filePath": "/www/apps/resources/app/troubleshooting/pnpm/page.mdx",
+    "pathname": "/troubleshooting/pnpm"
+  },
  {
    "filePath": "/www/apps/resources/app/troubleshooting/query/expression-type-error/page.mdx",
    "pathname": "/troubleshooting/query/expression-type-error"
@@ -43,6 +43,14 @@ const generatedgeneratedTroubleshootingSidebarSidebar = {
          "path": "/troubleshooting/general-errors",
          "title": "General Errors",
          "children": []
+        },
+        {
+          "loaded": true,
+          "isPathHref": true,
+          "type": "link",
+          "path": "/troubleshooting/pnpm",
+          "title": "pnpm Errors",
+          "children": []
        }
      ]
    },
@@ -28,6 +28,11 @@ export const troubleshootingSidebar = [
        path: "/troubleshooting/general-errors",
        title: "General Errors",
      },
+      {
+        type: "link",
+        path: "/troubleshooting/pnpm",
+        title: "pnpm Errors",
+      },
    ],
  },
  {