docs: improve troubleshooting guide for pnpm (#13673)

* docs: improve troubleshooting guide for pnpm

* added pnpm link to installation guide

www/apps/book/app/learn/fundamentals/admin/tips/page.mdx

@@ -161,6 +161,20 @@ You can also send requests to custom routes, as explained in the [JS SDK referen
 
 You may need to retrieve data before your component is rendered, or you may need to pass some initial data to your component to be used while data is being fetched. In those cases, you can use a [route loader](../routing/page.mdx).
 
+### Troubleshooting
+
+#### No QueryClient set
+
+If you're using `pnpm` as a package manager in your Medusa application, you might face the following error when you try to access the admin dashboard:
+
+```bash
+No QueryClient set, use QueryClientProvider to set one
+```
+
+This is a known issue when using `pnpm`. To fix it, you need to install the `@tanstack/react-query` package manually. Make sure to install the same version installed in [@medusajs/dashboard](https://github.com/medusajs/medusa/blob/d58462c9c91a3e335d03f758438e109caad1f839/packages/admin/dashboard/package.json#L54).
+
+Learn more in the [Errors with pnpm](!resources!/troubleshooting/pnpm) troubleshooting guide.
+
 ---
 
 ## Global Variables in Admin Customizations

www/apps/book/app/learn/installation/page.mdx

@@ -71,7 +71,8 @@ If you ran into an error during your installation, refer to the following troubl
 
 1. [create-medusa-app troubleshooting guides](!resources!/troubleshooting/create-medusa-app-errors).
 2. [CORS errors](!resources!/troubleshooting/cors-errors).
-3. [All troubleshooting guides](!resources!/troubleshooting).
+3. [Errors with pnpm](!resources!/troubleshooting/pnpm).
+4. [All troubleshooting guides](!resources!/troubleshooting).
 
 If you can't find your error reported anywhere, please open a [GitHub issue](https://github.com/medusajs/medusa/issues/new/choose).
 

www/apps/book/generated/edit-dates.mjs

@@ -43,7 +43,7 @@ export const generatedEditDates = {
   "app/learn/fundamentals/scheduled-jobs/execution-number/page.mdx": "2025-07-25T15:54:56.135Z",
   "app/learn/fundamentals/api-routes/parameters/page.mdx": "2025-09-15T15:47:08.409Z",
   "app/learn/fundamentals/api-routes/http-methods/page.mdx": "2025-07-25T15:12:29.347Z",
-  "app/learn/fundamentals/admin/tips/page.mdx": "2025-08-20T11:37:12.855Z",
+  "app/learn/fundamentals/admin/tips/page.mdx": "2025-10-03T08:35:15.022Z",
   "app/learn/fundamentals/api-routes/cors/page.mdx": "2025-03-11T08:54:26.281Z",
   "app/learn/fundamentals/admin/ui-routes/page.mdx": "2025-07-25T06:58:26.149Z",
   "app/learn/fundamentals/api-routes/middlewares/page.mdx": "2025-07-18T15:20:25.735Z",

www/apps/book/public/llms-full.txt

@@ -6992,6 +6992,20 @@ You can also send requests to custom routes, as explained in the [JS SDK referen
 
 You may need to retrieve data before your component is rendered, or you may need to pass some initial data to your component to be used while data is being fetched. In those cases, you can use a [route loader](https://docs.medusajs.com/learn/fundamentals/admin/routing/index.html.md).
 
+### Troubleshooting
+
+#### No QueryClient set
+
+If you're using `pnpm` as a package manager in your Medusa application, you might face the following error when you try to access the admin dashboard:
+
+```bash
+No QueryClient set, use QueryClientProvider to set one
+```
+
+This is a known issue when using `pnpm`. To fix it, you need to install the `@tanstack/react-query` package manually. Make sure to install the same version installed in [@medusajs/dashboard](https://github.com/medusajs/medusa/blob/d58462c9c91a3e335d03f758438e109caad1f839/packages/admin/dashboard/package.json#L54).
+
+Learn more in the [Errors with pnpm](https://docs.medusajs.com/resources/troubleshooting/pnpm/index.html.md) troubleshooting guide.
+
 ***
 
 ## Global Variables in Admin Customizations