docs: added troubleshooting guides + improvements (#11927)

* docs: added troubleshooting guides + improvements

* build fixes
This commit is contained in:
Shahed Nasser
2025-03-21 11:47:03 +02:00
committed by GitHub
parent c4f75ecbb2
commit 4c33586946
35 changed files with 17258 additions and 15864 deletions
+13 -4
View File
@@ -102,7 +102,7 @@ export const generatedEditDates = {
"app/create-medusa-app/page.mdx": "2025-01-16T10:00:25.975Z",
"app/deployment/admin/vercel/page.mdx": "2024-10-16T08:10:29.377Z",
"app/deployment/medusa-application/railway/page.mdx": "2025-03-11T08:56:02.100Z",
"app/deployment/storefront/vercel/page.mdx": "2025-01-06T12:19:31.142Z",
"app/deployment/storefront/vercel/page.mdx": "2025-03-21T07:19:24.818Z",
"app/deployment/page.mdx": "2024-11-25T14:31:45.277Z",
"app/integrations/page.mdx": "2025-02-26T11:37:17.771Z",
"app/medusa-cli/page.mdx": "2024-08-28T11:25:32.382Z",
@@ -132,7 +132,7 @@ export const generatedEditDates = {
"app/service-factory-reference/methods/retrieve/page.mdx": "2024-07-31T17:01:33+03:00",
"app/service-factory-reference/methods/soft-delete/page.mdx": "2024-07-31T17:01:33+03:00",
"app/service-factory-reference/methods/update/page.mdx": "2024-07-31T17:01:33+03:00",
"app/service-factory-reference/tips/filtering/page.mdx": "2024-07-31T17:01:33+03:00",
"app/service-factory-reference/tips/filtering/page.mdx": "2025-03-21T08:32:39.125Z",
"app/service-factory-reference/page.mdx": "2024-07-26T14:40:56+00:00",
"app/storefront-development/cart/context/page.mdx": "2025-01-06T16:00:34.296Z",
"app/storefront-development/cart/create/page.mdx": "2025-02-26T11:44:58.922Z",
@@ -5578,7 +5578,6 @@ export const generatedEditDates = {
"references/types/DmlTypes/types/types.DmlTypes.KnownDataTypes/page.mdx": "2024-12-17T16:57:19.922Z",
"references/types/DmlTypes/types/types.DmlTypes.RelationshipTypes/page.mdx": "2024-12-10T14:54:55.435Z",
"app/recipes/commerce-automation/restock-notification/page.mdx": "2025-03-17T07:36:21.511Z",
"app/troubleshooting/workflow-errors/page.mdx": "2024-12-11T08:44:36.598Z",
"app/integrations/guides/shipstation/page.mdx": "2025-02-26T11:21:46.879Z",
"app/nextjs-starter/guides/customize-stripe/page.mdx": "2024-12-25T14:48:55.877Z",
"references/core_flows/Cart/Workflows_Cart/functions/core_flows.Cart.Workflows_Cart.listShippingOptionsForCartWithPricingWorkflow/page.mdx": "2025-03-04T13:33:40.584Z",
@@ -6061,5 +6060,15 @@ export const generatedEditDates = {
"app/nextjs-starter/guides/revalidate-cache/page.mdx": "2025-03-18T08:47:59.628Z",
"app/storefront-development/cart/totals/page.mdx": "2025-03-18T09:20:59.533Z",
"app/storefront-development/checkout/order-confirmation/page.mdx": "2025-03-18T09:44:14.561Z",
"app/how-to-tutorials/tutorials/product-reviews/page.mdx": "2025-03-19T13:00:56.901Z"
"app/how-to-tutorials/tutorials/product-reviews/page.mdx": "2025-03-19T13:00:56.901Z",
"app/troubleshooting/api-routes/page.mdx": "2025-03-21T07:17:56.248Z",
"app/troubleshooting/data-models/default-fields/page.mdx": "2025-03-21T06:59:06.775Z",
"app/troubleshooting/medusa-admin/blocked-request/page.mdx": "2025-03-21T06:53:34.854Z",
"app/troubleshooting/nextjs-starter-rewrites/page.mdx": "2025-03-21T07:09:08.901Z",
"app/troubleshooting/query/filter-linked/page.mdx": "2025-03-21T07:07:51.046Z",
"app/troubleshooting/query/service-list/page.mdx": "2025-03-21T07:08:32.825Z",
"app/troubleshooting/storefront-missing-pak/page.mdx": "2025-03-21T07:08:52.294Z",
"app/troubleshooting/storefront-pak-sc/page.mdx": "2025-03-21T07:08:57.546Z",
"app/troubleshooting/workflow-errors/step-x-defined/page.mdx": "2025-03-21T07:09:02.741Z",
"app/troubleshooting/workflow-errors/when-then/page.mdx": "2025-03-21T08:35:45.145Z"
}
+38 -2
View File
@@ -1247,6 +1247,10 @@ export const filesMap = [
"filePath": "/www/apps/resources/app/tools/page.mdx",
"pathname": "/tools"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/api-routes/page.mdx",
"pathname": "/troubleshooting/api-routes"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/cors-errors/page.mdx",
"pathname": "/troubleshooting/cors-errors"
@@ -1255,6 +1259,10 @@ export const filesMap = [
"filePath": "/www/apps/resources/app/troubleshooting/create-medusa-app-errors/page.mdx",
"pathname": "/troubleshooting/create-medusa-app-errors"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/data-models/default-fields/page.mdx",
"pathname": "/troubleshooting/data-models/default-fields"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/database-errors/page.mdx",
"pathname": "/troubleshooting/database-errors"
@@ -1279,25 +1287,53 @@ export const filesMap = [
"filePath": "/www/apps/resources/app/troubleshooting/general-errors/page.mdx",
"pathname": "/troubleshooting/general-errors"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/medusa-admin/blocked-request/page.mdx",
"pathname": "/troubleshooting/medusa-admin/blocked-request"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/medusa-admin/no-widget-route/page.mdx",
"pathname": "/troubleshooting/medusa-admin/no-widget-route"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/nextjs-starter-rewrites/page.mdx",
"pathname": "/troubleshooting/nextjs-starter-rewrites"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/page.mdx",
"pathname": "/troubleshooting"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/query/filter-linked/page.mdx",
"pathname": "/troubleshooting/query/filter-linked"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/query/service-list/page.mdx",
"pathname": "/troubleshooting/query/service-list"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/s3/page.mdx",
"pathname": "/troubleshooting/s3"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/storefront-missing-pak/page.mdx",
"pathname": "/troubleshooting/storefront-missing-pak"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/storefront-pak-sc/page.mdx",
"pathname": "/troubleshooting/storefront-pak-sc"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/test-errors/page.mdx",
"pathname": "/troubleshooting/test-errors"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/workflow-errors/page.mdx",
"pathname": "/troubleshooting/workflow-errors"
"filePath": "/www/apps/resources/app/troubleshooting/workflow-errors/step-x-defined/page.mdx",
"pathname": "/troubleshooting/workflow-errors/step-x-defined"
},
{
"filePath": "/www/apps/resources/app/troubleshooting/workflow-errors/when-then/page.mdx",
"pathname": "/troubleshooting/workflow-errors/when-then"
},
{
"filePath": "/www/apps/resources/references/api_key/IApiKeyModuleService/methods/api_key.IApiKeyModuleService.authenticate/page.mdx",
@@ -1071,6 +1071,14 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
"sort_sidebar": "alphabetize",
"description": "Learn how to use the Cart Module in your customizations on the Medusa application server.",
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "ref",
"title": "Abandoned Cart Notification",
"path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/abandoned-cart",
"children": []
},
{
"loaded": true,
"isPathHref": true,
@@ -50,7 +50,24 @@ const generatedgeneratedTroubleshootingSidebarSidebar = {
"loaded": true,
"isPathHref": true,
"type": "category",
"title": "Medusa Application",
"title": "Upgrade",
"initialOpen": true,
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/errors-after-upgrading",
"title": "Errors After Upgrading",
"children": []
}
]
},
{
"loaded": true,
"isPathHref": true,
"type": "category",
"title": "Framework",
"initialOpen": true,
"children": [
{
@@ -80,10 +97,42 @@ const generatedgeneratedTroubleshootingSidebarSidebar = {
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/workflow-errors",
"title": "Workflow Errors",
"children": []
"type": "sub-category",
"title": "Query",
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/query/filter-linked",
"title": "Not Exising Property",
"children": []
}
]
},
{
"loaded": true,
"isPathHref": true,
"type": "sub-category",
"title": "Workflows",
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/workflow-errors/when-then",
"title": "Handler Not Found",
"children": []
},
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/workflow-errors/step-x-defined",
"title": "Step Already Defined",
"children": []
}
]
},
{
"loaded": true,
@@ -95,40 +144,6 @@ const generatedgeneratedTroubleshootingSidebarSidebar = {
}
]
},
{
"loaded": true,
"isPathHref": true,
"type": "category",
"title": "Admin Development",
"initialOpen": true,
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/medusa-admin/no-widget-route",
"title": "Widget or Route not Showing",
"children": []
}
]
},
{
"loaded": true,
"isPathHref": true,
"type": "category",
"title": "Upgrade",
"initialOpen": true,
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/errors-after-upgrading",
"title": "Errors After Upgrading",
"children": []
}
]
},
{
"loaded": true,
"isPathHref": true,
@@ -162,6 +177,80 @@ const generatedgeneratedTroubleshootingSidebarSidebar = {
"children": []
}
]
},
{
"loaded": true,
"isPathHref": true,
"type": "category",
"title": "Admin Development",
"initialOpen": true,
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/medusa-admin/no-widget-route",
"title": "Widget or Route not Showing",
"children": []
},
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/medusa-admin/blocked-request",
"title": "Blocked Request",
"children": []
}
]
},
{
"loaded": true,
"isPathHref": true,
"type": "category",
"title": "Storefront",
"initialOpen": true,
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "sub-category",
"title": "Next.js Starter",
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/nextjs-starter-rewrites",
"title": "Cloud Run Error",
"children": []
}
]
},
{
"loaded": true,
"isPathHref": true,
"type": "sub-category",
"title": "Publishable API Key Errors",
"children": [
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/storefront-missing-pak",
"title": "Missing Publishable API Key",
"children": []
},
{
"loaded": true,
"isPathHref": true,
"type": "link",
"path": "/troubleshooting/storefront-pak-sc",
"title": "Sales Channels Error",
"children": []
}
]
}
]
}
]
}