docs: create returns from storefront tutorial (medusajs#13522)

shahednasser · web-flow · commit c4c2231a31d7 · 2025-09-24T12:06:26.000+03:00
* docs: create returns from storefront tutorial

* small change

* generate llms

* add location ID
diff --git a/www/apps/book/public/llms-full.txt b/www/apps/book/public/llms-full.txt
diff --git a/www/apps/resources/app/nextjs-starter/guides/storefront-returns/page.mdx b/www/apps/resources/app/nextjs-starter/guides/storefront-returns/page.mdx
diff --git a/www/apps/resources/generated/edit-dates.mjs b/www/apps/resources/generated/edit-dates.mjs
@@ -6609,5 +6609,6 @@ export const generatedEditDates = {
   "references/core_flows/Locking/Steps_Locking/variables/core_flows.Locking.Steps_Locking.acquireLockStepId/page.mdx": "2025-09-15T09:52:14.218Z",
   "references/core_flows/Locking/Steps_Locking/variables/core_flows.Locking.Steps_Locking.releaseLockStepId/page.mdx": "2025-09-15T09:52:14.219Z",
   "references/core_flows/Locking/core_flows.Locking.Steps_Locking/page.mdx": "2025-09-15T09:52:14.217Z",
+  "app/nextjs-starter/guides/storefront-returns/page.mdx": "2025-09-22T06:02:00.580Z",
   "references/js_sdk/admin/Admin/properties/js_sdk.admin.Admin.views/page.mdx": "2025-09-18T17:04:59.240Z"
 }
diff --git a/www/apps/resources/generated/files-map.mjs b/www/apps/resources/generated/files-map.mjs
@@ -1019,6 +1019,10 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/nextjs-starter/guides/revalidate-cache/page.mdx",
     "pathname": "/nextjs-starter/guides/revalidate-cache"
   },
+  {
+    "filePath": "/www/apps/resources/app/nextjs-starter/guides/storefront-returns/page.mdx",
+    "pathname": "/nextjs-starter/guides/storefront-returns"
+  },
   {
     "filePath": "/www/apps/resources/app/nextjs-starter/page.mdx",
     "pathname": "/nextjs-starter"
diff --git a/www/apps/resources/generated/generated-commerce-modules-sidebar.mjs b/www/apps/resources/generated/generated-commerce-modules-sidebar.mjs
@@ -6310,6 +6310,14 @@ const generatedgeneratedCommerceModulesSidebarSidebar = {
               "title": "Order Confirmation in Storefront",
               "path": "https://docs.medusajs.com/resources/storefront-development/checkout/order-confirmation",
               "children": []
+            },
+            {
+              "loaded": true,
+              "isPathHref": true,
+              "type": "ref",
+              "title": "Return Request - Order #",
+              "path": "https://docs.medusajs.com/resources/nextjs-starter/guides/storefront-returns",
+              "children": []
             }
           ]
         },
diff --git a/www/apps/resources/generated/generated-storefront-development-sidebar.mjs b/www/apps/resources/generated/generated-storefront-development-sidebar.mjs
@@ -51,6 +51,14 @@ const generatedgeneratedStorefrontDevelopmentSidebarSidebar = {
           "path": "/storefront-development/guides/express-checkout",
           "title": "Express Checkout Storefront",
           "children": []
+        },
+        {
+          "loaded": true,
+          "isPathHref": true,
+          "type": "ref",
+          "path": "/nextjs-starter/guides/storefront-returns",
+          "title": "Create Returns from Storefront",
+          "children": []
         }
       ]
     },
diff --git a/www/apps/resources/generated/generated-tools-sidebar.mjs b/www/apps/resources/generated/generated-tools-sidebar.mjs
@@ -794,14 +794,6 @@ const generatedgeneratedToolsSidebarSidebar = {
               "title": "How-to Guides",
               "initialOpen": true,
               "children": [
-                {
-                  "loaded": true,
-                  "isPathHref": true,
-                  "type": "link",
-                  "path": "/nextjs-starter/guides/customize-stripe",
-                  "title": "Use Stripe's Payment Element",
-                  "children": []
-                },
                 {
                   "loaded": true,
                   "isPathHref": true,
@@ -829,6 +821,14 @@ const generatedgeneratedToolsSidebarSidebar = {
                   "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/gift-message",
                   "children": []
                 },
+                {
+                  "loaded": true,
+                  "isPathHref": true,
+                  "type": "link",
+                  "path": "/nextjs-starter/guides/storefront-returns",
+                  "title": "Create Order Returns",
+                  "children": []
+                },
                 {
                   "loaded": true,
                   "isPathHref": true,
@@ -876,6 +876,14 @@ const generatedgeneratedToolsSidebarSidebar = {
                   "title": "Ticket Booking Storefront",
                   "path": "https://docs.medusajs.com/resources/recipes/ticket-booking/example/storefront",
                   "children": []
+                },
+                {
+                  "loaded": true,
+                  "isPathHref": true,
+                  "type": "link",
+                  "path": "/nextjs-starter/guides/customize-stripe",
+                  "title": "Use Stripe's Payment Element",
+                  "children": []
                 }
               ]
             }
diff --git a/www/apps/resources/sidebars/storefront.mjs b/www/apps/resources/sidebars/storefront.mjs
@@ -35,6 +35,11 @@ export const storefrontDevelopmentSidebar = [
         path: "/storefront-development/guides/express-checkout",
         title: "Express Checkout Storefront",
       },
+      {
+        type: "ref",
+        path: "/nextjs-starter/guides/storefront-returns",
+        title: "Create Returns from Storefront",
+      },
     ],
   },
   {
diff --git a/www/apps/resources/sidebars/tools.mjs b/www/apps/resources/sidebars/tools.mjs
@@ -108,11 +108,6 @@ export const toolsSidebar = [
             title: "How-to Guides",
             initialOpen: true,
             children: [
-              {
-                type: "link",
-                path: "/nextjs-starter/guides/customize-stripe",
-                title: "Use Stripe's Payment Element",
-              },
               {
                 type: "link",
                 path: "/nextjs-starter/guides/revalidate-cache",
@@ -126,6 +121,18 @@ export const toolsSidebar = [
             autogenerate_tags: "nextjs+tutorial",
             autogenerate_as_ref: true,
             sort_sidebar: "alphabetize",
+            children: [
+              {
+                type: "link",
+                path: "/nextjs-starter/guides/customize-stripe",
+                title: "Use Stripe's Payment Element",
+              },
+              {
+                type: "link",
+                path: "/nextjs-starter/guides/storefront-returns",
+                title: "Create Order Returns",
+              },
+            ],
           },
         ],
       },
diff --git a/www/packages/tags/src/tags/example.ts b/www/packages/tags/src/tags/example.ts
@@ -1,4 +1,8 @@
 export const example = [
+  {
+    "title": "Return Request - Order #",
+    "path": "https://docs.medusajs.com/resources/nextjs-starter/guides/storefront-returns"
+  },
   {
     "title": "Implement Express Checkout with Medusa",
     "path": "https://docs.medusajs.com/resources/storefront-development/guides/express-checkout"
diff --git a/www/packages/tags/src/tags/order.ts b/www/packages/tags/src/tags/order.ts
@@ -75,6 +75,10 @@ export const order = [
     "title": "Implement Re-Order",
     "path": "https://docs.medusajs.com/resources/how-to-tutorials/tutorials/re-order"
   },
+  {
+    "title": "Return Request - Order #",
+    "path": "https://docs.medusajs.com/resources/nextjs-starter/guides/storefront-returns"
+  },
   {
     "title": "Checkout Step 5: Complete Cart",
     "path": "https://docs.medusajs.com/resources/storefront-development/checkout/complete-cart"
diff --git a/www/packages/tags/src/tags/storefront.ts b/www/packages/tags/src/tags/storefront.ts
@@ -3,6 +3,10 @@ export const storefront = [
     "title": "Use Stripe's Payment Element in the Next.js Starter Storefront",
     "path": "https://docs.medusajs.com/resources/nextjs-starter/guides/customize-stripe"
   },
+  {
+    "title": "Return Request - Order #",
+    "path": "https://docs.medusajs.com/resources/nextjs-starter/guides/storefront-returns"
+  },
   {
     "title": "Create Cart Context in Storefront",
     "path": "https://docs.medusajs.com/resources/storefront-development/cart/context"

Original file line number	Diff line number	Diff line change
`@@ -6609,5 +6609,6 @@ export const generatedEditDates = {`
`6609`	`6609`	`"references/core_flows/Locking/Steps_Locking/variables/core_flows.Locking.Steps_Locking.acquireLockStepId/page.mdx": "2025-09-15T09:52:14.218Z",`
`6610`	`6610`	`"references/core_flows/Locking/Steps_Locking/variables/core_flows.Locking.Steps_Locking.releaseLockStepId/page.mdx": "2025-09-15T09:52:14.219Z",`
`6611`	`6611`	`"references/core_flows/Locking/core_flows.Locking.Steps_Locking/page.mdx": "2025-09-15T09:52:14.217Z",`
	`6612`	`+ "app/nextjs-starter/guides/storefront-returns/page.mdx": "2025-09-22T06:02:00.580Z",`
`6612`	`6613`	`"references/js_sdk/admin/Admin/properties/js_sdk.admin.Admin.views/page.mdx": "2025-09-18T17:04:59.240Z"`
`6613`	`6614`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,8 @@`
`1`	`1`	`export const example = [`
	`2`	`+ {`
	`3`	`+ "title": "Return Request - Order #",`
	`4`	`+ "path": "https://docs.medusajs.com/resources/nextjs-starter/guides/storefront-returns"`
	`5`	`+ },`
`2`	`6`	`{`
`3`	`7`	`"title": "Implement Express Checkout with Medusa",`
`4`	`8`	`"path": "https://docs.medusajs.com/resources/storefront-development/guides/express-checkout"`