docs: add guide on storefront production optimization tips (#13682)

* docs: add guide on storefront production optimization tips

* add vale exception

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

@@ -6610,5 +6610,6 @@ export const generatedEditDates = {
   "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",
-  "app/how-to-tutorials/tutorials/agentic-commerce/page.mdx": "2025-10-02T07:14:50.956Z"
+  "app/how-to-tutorials/tutorials/agentic-commerce/page.mdx": "2025-10-02T07:14:50.956Z",
+  "app/storefront-development/production-optimizations/page.mdx": "2025-10-03T13:28:37.909Z"
 }

www/apps/resources/generated/files-map.mjs

@@ -1279,6 +1279,10 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/storefront-development/page.mdx",
     "pathname": "/storefront-development"
   },
+  {
+    "filePath": "/www/apps/resources/app/storefront-development/production-optimizations/page.mdx",
+    "pathname": "/storefront-development/production-optimizations"
+  },
   {
     "filePath": "/www/apps/resources/app/storefront-development/products/categories/list/page.mdx",
     "pathname": "/storefront-development/products/categories/list"

www/apps/resources/generated/generated-storefront-development-sidebar.mjs

@@ -34,6 +34,14 @@ const generatedgeneratedStorefrontDevelopmentSidebarSidebar = {
           "path": "/storefront-development/publishable-api-keys",
           "title": "Publishable API Key",
           "children": []
+        },
+        {
+          "loaded": true,
+          "isPathHref": true,
+          "type": "link",
+          "path": "/storefront-development/production-optimizations",
+          "title": "Production Optimizations",
+          "children": []
         }
       ]
     },

www/apps/resources/sidebars/storefront.mjs

@@ -22,6 +22,11 @@ export const storefrontDevelopmentSidebar = [
         path: "/storefront-development/publishable-api-keys",
         title: "Publishable API Key",
       },
+      {
+        type: "link",
+        path: "/storefront-development/production-optimizations",
+        title: "Production Optimizations",
+      },
     ],
   },
   {

www/packages/tags/src/tags/storefront.ts

@@ -103,6 +103,10 @@ export const storefront = [
     "title": "Implement Express Checkout with Medusa",
     "path": "https://docs.medusajs.com/resources/storefront-development/guides/express-checkout"
   },
+  {
+    "title": "Storefront Production Optimization Tips",
+    "path": "https://docs.medusajs.com/resources/storefront-development/production-optimizations"
+  },
   {
     "title": "Show Product Categories in Storefront",
     "path": "https://docs.medusajs.com/resources/storefront-development/products/categories/list"

www/vale/styles/docs/Tooling.yml

@@ -36,4 +36,5 @@ exceptions:
   - 'Frontend framework'
   - 'frontend''s framework'
   - 'Frontend''s Framework'
-  - 'Frontend''s framework'
+  - 'Frontend''s framework'
+  - 'your framework'