docs: prepare configuration (#7877)

* update configuration

* resolve todos + remove events guides

* disable v2 docs in v1 navbar

* remove v2 from v1 mobile sidebar

* resolve build errors

* fix build errors

* fix lint errors

* fix lint

www/apps/api-reference/components/Navbar/index.tsx

@@ -41,6 +41,7 @@ const Navbar = () => {
       }}
       additionalActionsBefore={<VersionSwitcher />}
       additionalActionsAfter={<FeedbackModal />}
+      showSearchOpener
       isLoading={isLoading}
     />
   )

www/apps/api-reference/next.config.mjs

@@ -12,6 +12,7 @@ const nextConfig = {
           destination: `${
             process.env.NEXT_PUBLIC_DOCS_URL || "https://localhost:3001"
           }/:path*`,
+          basePath: false,
         },
       ],
     }

www/apps/book/app/advanced-development/data-models/index/page.mdx

@@ -53,7 +53,7 @@ import { model } from "@medusajs/utils"
 const MyCustom = model.define("my_custom", {
   id: model.id().primaryKey(),
   name: model.text(),
-  age: model.number()
+  age: model.number(),
 }).indexes([
   {
     on: ["name", "age"],
@@ -82,13 +82,13 @@ import { model } from "@medusajs/utils"
 const MyCustom = model.define("my_custom", {
   id: model.id().primaryKey(),
   name: model.text(),
-  age: model.number()
+  age: model.number(),
 }).indexes([
   {
     on: ["name", "age"],
     where: {
-      age: 30
-    }
+      age: 30,
+    },
   },
 ])
 
@@ -111,15 +111,15 @@ import { model } from "@medusajs/utils"
 const MyCustom = model.define("my_custom", {
   id: model.id().primaryKey(),
   name: model.text(),
-  age: model.number().nullable()
+  age: model.number().nullable(),
 }).indexes([
   {
     on: ["name", "age"],
     where: {
       age: {
-        $ne: null
-      }
-    }
+        $ne: null,
+      },
+    },
   },
 ])
 
@@ -146,11 +146,11 @@ import { model } from "@medusajs/utils"
 const MyCustom = model.define("my_custom", {
   id: model.id().primaryKey(),
   name: model.text(),
-  age: model.number()
+  age: model.number(),
 }).indexes([
   {
     on: ["name", "age"],
-    unique: true
+    unique: true,
   },
 ])
 

www/apps/book/app/basics/events-and-subscribers/page.mdx

@@ -41,25 +41,6 @@ A subscriber file must export:
 
 The above subscriber listens to the `product.created` event. Whenever the event is emitted, it logs in the terminal `A product is created`.
 
-{/* TODO add when we have the admin dashboard to use with V2 for easy testing. */}
-
-{/\* ### Test Subscriber
-
-To test the subscriber, start the Medusa application:
-
-```bash npm2yarn
-npm run dev
-```
-
-Then, create a product using the Medusa Admin dashboard. Afterward, you’ll see the following messages logged in the terminal:
-
-```bash
-info:    Processing product.created which has 1 subscribers
-A product is created
-```
-
-The first message indicates that the `product.created` event was emitted, and the second one is the message logged from the subscriber. \*/}
-
 ---
 
 ## When to Use Subscribers

www/apps/book/components/Navbar/index.tsx

@@ -31,6 +31,7 @@ const Navbar = () => {
         mobileSidebarOpen,
       }}
       isLoading={false}
+      showSearchOpener
     />
   )
 }

www/apps/book/next.config.mjs

@@ -108,6 +108,13 @@ const nextConfig = {
           }/v2/resources/:path*`,
           basePath: false,
         },
+        {
+          source: "/v2/api/:path*",
+          destination: `${
+            process.env.NEXT_PUBLIC_API_URL || "https://localhost:3001"
+          }/v2/api/:path*`,
+          basePath: false,
+        },
         // TODO comment out once we have the user guide published
         // {
         //   source: "/user-guide",
@@ -122,7 +129,7 @@ const nextConfig = {
         {
           source: "/:path*",
           destination: `${
-            process.env.NEXT_PUBLIC_DOCS_V1_URL || "https://localhost:3000"
+            process.env.NEXT_PUBLIC_API_V1_URL || "https://localhost:3001"
           }/:path*`,
           basePath: false,
         },

www/apps/resources/app/architectural-modules/notification/send-notification/page.mdx

@@ -91,6 +91,4 @@ The `create` method accepts an object or an array of objects having the followin
   sectionTitle="Use the Create Method"
 />
 
-{/* TODO add once reference for type once generated */}
-
-{/* For a full list of properties accepted, refer to [this guide](/references/notification-provider-module#create). */}
+For a full list of properties accepted, refer to [this guide](/references/notification-provider-module#create).

www/apps/resources/app/recipes/integrate-ecommerce-stack/page.mdx

@@ -37,11 +37,11 @@ Then, resolve the module's main service in other resources, such as API routes o
 
 <Details summaryContent="Example: Create a module integrating an ERP system">
 
-This example showcases how to create a module that integrates to a dummy ERP system.
+  This example showcases how to create a module that integrates to a dummy ERP system.
 
-Start by creating the directory `src/modules/erp` for your module.
+  Start by creating the directory `src/modules/erp` for your module.
 
-Then, create the file `src/modules/erp/service.ts` with the following content:
+  Then, create the file `src/modules/erp/service.ts` with the following content:
 
 export const serviceHighlights = [
   ["4", "ErpModuleOptions", "The module's expected options."],
@@ -56,12 +56,12 @@ export const serviceHighlights = [
   import axios, { AxiosInstance } from "axios"
   import { ProductDTO } from "@medusajs/types"
 
-type ErpModuleOptions = {
-apiKey: string
-}
+  type ErpModuleOptions = {
+    apiKey: string
+  }
 
-class ErpModuleService {
-private client\_: AxiosInstance
+  class ErpModuleService {
+    private client_: AxiosInstance
 
     constructor({}, { apiKey }: ErpModuleOptions) {
       this.client_ = axios.create({
@@ -87,52 +87,51 @@ private client\_: AxiosInstance
     async deleteProduct(id: string) {
       await this.client_.delete(`/product/${id}`)
     }
+  }
 
-}
+  export default ErpModuleService
 
-export default ErpModuleService
+  ```
 
-````
+  This creates the module's main service. Few things to note:
 
-This creates the module's main service. Few things to note:
+  - The module accepts an `apiKey` option, used to authenticate to the dummy ERP system. The module's main service accesses this option in the second parameter of the constructor.
+  - The module uses axios to create a client in the constructor. The client is used in the service's methods when connecting to the ERP system. If the system you're integrating has an SDK, you can initialize it in the constructor, instead.
+  - The `getProductData` method retrieves a product's details from the ERP system by sending a `GET` request using the client.
+  - The `createProduct` method creates a product in the ERP system by sending a `POST` request using the client.
+  - The `deleteProduct` method deletes a product in the ERP system by sending a `DELETE` request using the client.
 
-- The module accepts an `apiKey` option, used to authenticate to the dummy ERP system. The module's main service accesses this option in the second parameter of the constructor.
-- The module uses axios to create a client in the constructor. The client is used in the service's methods when connecting to the ERP system. If the system you're integrating has an SDK, you can initialize it in the constructor, instead.
-- The `getProductData` method retrieves a product's details from the ERP system by sending a `GET` request using the client.
-- The `createProduct` method creates a product in the ERP system by sending a `POST` request using the client.
-- The `deleteProduct` method deletes a product in the ERP system by sending a `DELETE` request using the client.
+  <Note title="Tip">
 
-<Note title="Tip">
+  You can store the product's ID in the external system using the `metadata` property of the `Product` data model in the Product Module. Alternatively, you can create a [data model](!docs!/basics/data-models) in your module to store data related to the external system.
 
-You can store the product's ID in the external system using the `metadata` property of the `Product` data model in the Product Module. Alternatively, you can create a [data model](!docs!/basics/data-models) in your module to store data related to the external system.
+  </Note>
 
-</Note>
+  Then, create the module's definition file at `src/modules/erp/index.ts` with the following content:
 
-Then, create the module's definition file at `src/modules/erp/index.ts` with the following content:
+  ```ts title="src/modules/erp/index.ts"
+  import ErpModuleService from "./service"
 
-```ts title="src/modules/erp/index.ts"
-import ErpModuleService from "./service"
+  export default {
+    service: ErpModuleService,
+  }
+  ````
 
-export default {
-  service: ErpModuleService,
-}
-````
+  Finally, add the module to the `modules` object in `medusa-config.js`:
 
-Finally, add the module to the `modules` object in `medusa-config.js`:
-
-```js title="medusa-config.js" highlights={[["7", "ERP_API_KEY", "The environment variable holding the API key of the ERP system."]]}
-module.exports = defineConfig({
-  // ...
-  modules: {
-    erpModuleService: {
-      resolve: "./modules/erp",
-      options: {
-        apiKey: process.env.ERP_API_KEY,
+  ```js title="medusa-config.js" highlights={[["7", "ERP_API_KEY", "The environment variable holding the API key of the ERP system."]]}
+  module.exports = defineConfig({
+    // ...
+    modules: {
+      erpModuleService: {
+        resolve: "./modules/erp",
+        options: {
+          apiKey: process.env.ERP_API_KEY,
+        },
       },
     },
-  },
-})
-```
+  })
+  ```
 
 </Details>
 

www/apps/resources/app/recipes/marketplace/page.mdx

@@ -40,119 +40,113 @@ Module Relationships is coming soon.
 
 </Note>
 
-<CardList
-  items={[
-    {
-      href: "!docs!/basics/modules-and-services",
-      title: "Create a Module",
-      text: "Learn how to create a module",
-      startIcon: <AcademicCapSolid />,
-      showLinkIcon: false,
-    },
-    {
-      href: "!docs!/advanced-development/modules/module-relationships",
-      title: "Module Relationships",
-      text: "Create relationships between modules.",
-      startIcon: <AcademicCapSolid />,
-      showLinkIcon: false,
-    },
-  ]}
-/>
+<CardList items={[
+  {
+    href: "!docs!/basics/modules-and-services",
+    title: "Create a Module",
+    text: "Learn how to create a module",
+    startIcon: <AcademicCapSolid />,
+    showLinkIcon: false
+  },
+  {
+    href: "!docs!/advanced-development/modules/module-relationships",
+    title: "Module Relationships",
+    text: "Create relationships between modules.",
+    startIcon: <AcademicCapSolid />,
+    showLinkIcon: false
+  },
+]} />
 
 <Details summaryContent="Example">
 
-In this section, you’ll create a Marketplace Module with the necessary relationships and functionalities in the main service.
+  In this section, you’ll create a Marketplace Module with the necessary relationships and functionalities in the main service.
   
-Start by creating the directory `src/modules/marketplace`.
+  Start by creating the directory `src/modules/marketplace`.
   
-Then, create the file `src/modules/marketplace/models/store-user.ts` with the following content:
+  Then, create the file `src/modules/marketplace/models/store-user.ts` with the following content:
   
-```ts title="src/modules/marketplace/models/store-user.ts"
-import { model } from "@medusajs/utils"
+  ```ts title="src/modules/marketplace/models/store-user.ts"
+  import { model } from "@medusajs/utils"
 
-const StoreUser = model.define("store_user", {
-  id: model.id().primaryKey(),
-  store_id: model.text(),
-  user_id: model.text(),
-})
+  const StoreUser = model.define("store_user", {
+    id: model.id().primaryKey(),
+    store_id: model.text(),
+    user_id: model.text(),
+  })
 
-export default StoreUser
-```
+  export default StoreUser
+  ```
   
-This creates a `StoreUser` data model with the `store_id` and `user_id` properties.
+  This creates a `StoreUser` data model with the `store_id` and `user_id` properties.
   
-{/* These properties will be used later to establish relationships to the Store and User modules. */}
+  {/* These properties will be used later to establish relationships to the Store and User modules. */}
   
-Next, create the file `src/modules/marketplace/models/store-product.ts` with the following content:
+  Next, create the file `src/modules/marketplace/models/store-product.ts` with the following content:
   
-```ts title="src/modules/marketplace/models/store-product.ts"
-import { model } from "@medusajs/utils"
+  ```ts title="src/modules/marketplace/models/store-product.ts"
+  import { model } from "@medusajs/utils"
 
-const StoreProduct = model.define("store_user", {
-  id: model.id().primaryKey(),
-  store_id: model.text(),
-  product_id: model.text(),
-})
+  const StoreProduct = model.define("store_user", {
+    id: model.id().primaryKey(),
+    store_id: model.text(),
+    product_id: model.text(),
+  })
 
-export default StoreProduct
-```
+  export default StoreProduct
+  ```
   
-This creates a `StoreProduct` data model with the `store_id` and `product_id` properties.
+  This creates a `StoreProduct` data model with the `store_id` and `product_id` properties. 
   
-{/* These properties will be used later to establish relationships to the Store and Product modules. */}
+  {/* These properties will be used later to establish relationships to the Store and Product modules. */}
   
-Finally, create the file `src/modules/marketplace/models/store-order.ts` with the following content:
+  Finally, create the file `src/modules/marketplace/models/store-order.ts` with the following content:
   
-```ts title="src/modules/marketplace/models/store-order.ts"
-import { model } from "@medusajs/utils"
+  ```ts title="src/modules/marketplace/models/store-order.ts"
+  import { model } from "@medusajs/utils"
 
-const StoreOrder = model.define("store_user", {
-  id: model.id().primaryKey(),
-  store_id: model.text(),
-  order_id: model.text(),
-  parent_order_id: model.text(),
-})
+  const StoreOrder = model.define("store_user", {
+    id: model.id().primaryKey(),
+    store_id: model.text(),
+    order_id: model.text(),
+    parent_order_id: model.text(),
+  })
 
-export default StoreOrder
-```
+  export default StoreOrder
+  ```
   
-This creates a `StoreOrder` data model with the `store_id`, `order_id`, and `parent_order_id` properties.
+  This creates a `StoreOrder` data model with the `store_id`, `order_id`, and `parent_order_id` properties.
   
-{/* The `store_id` and `order_id` properties will be used to establish relationships to the Store and Order modules. You’ll learn about the use of `parent_order_id` in a later section. */}
+  {/* The `store_id` and `order_id` properties will be used to establish relationships to the Store and Order modules. You’ll learn about the use of `parent_order_id` in a later section. */}
   
-To reflect these changes on the database, create the migration `src/modules/marketplace/migrations/Migration20240514143248.ts` with the following content:
+  To reflect these changes on the database, create the migration `src/modules/marketplace/migrations/Migration20240514143248.ts` with the following content:
   
-```ts title="src/modules/marketplace/migrations/Migration20240514143248.ts"
-import { Migration } from "@mikro-orm/migrations"
+  ```ts title="src/modules/marketplace/migrations/Migration20240514143248.ts"
+  import { Migration } from "@mikro-orm/migrations"
   
-export class Migration20240514143248 extends Migration {
-  async up(): Promise<void> {
-    this.addSql(
-      'create table if not exists "store_order" ("id" varchar(255) not null, "store_id" text not null, "order_id" text not null, "parent_order_id" text not null, constraint "store_order_pkey" primary key ("id"));'
-    )
+  export class Migration20240514143248 extends Migration {
   
-    this.addSql(
-      'create table if not exists "store_product" ("id" varchar(255) not null, "store_id" text not null, "product_id" text not null, constraint "store_product_pkey" primary key ("id"));'
-    )
+    async up(): Promise<void> {
+      this.addSql("create table if not exists \"store_order\" (\"id\" varchar(255) not null, \"store_id\" text not null, \"order_id\" text not null, \"parent_order_id\" text not null, constraint \"store_order_pkey\" primary key (\"id\"));")
+  
+      this.addSql("create table if not exists \"store_product\" (\"id\" varchar(255) not null, \"store_id\" text not null, \"product_id\" text not null, constraint \"store_product_pkey\" primary key (\"id\"));")
+  
+      this.addSql("create table if not exists \"store_user\" (\"id\" varchar(255) not null, \"store_id\" text not null, \"user_id\" text not null, constraint \"store_user_pkey\" primary key (\"id\"));")
+    }
+  
+    async down(): Promise<void> {
+      this.addSql("drop table if exists \"store_order\" cascade;")
+  
+      this.addSql("drop table if exists \"store_product\" cascade;")
+  
+      this.addSql("drop table if exists \"store_user\" cascade;")
+    }
   
-    this.addSql(
-      'create table if not exists "store_user" ("id" varchar(255) not null, "store_id" text not null, "user_id" text not null, constraint "store_user_pkey" primary key ("id"));'
-    )
   }
+  ```
   
-  async down(): Promise<void> {
-    this.addSql('drop table if exists "store_order" cascade;')
+  You’ll run the migration after registering the module in the Medusa configurations.
     
-    this.addSql('drop table if exists "store_product" cascade;')
-
-    this.addSql('drop table if exists "store_user" cascade;')
-  }
-}
-```
-
-You’ll run the migration after registering the module in the Medusa configurations.
-
-Then, create the module’s main service at `src/modules/marketplace/service.ts` with the following content:
+  Then, create the module’s main service at `src/modules/marketplace/service.ts` with the following content:
 
 export const mainServiceHighlights = [
   ["6", "MedusaService", "Extends the service factory to generate data management features."]
@@ -164,51 +158,51 @@ export const mainServiceHighlights = [
   import StoreProduct from "./models/store-product"
   import StoreOrder from "./models/store-order"
 
-class MarketplaceModuleService extends MedusaService({
-StoreUser,
-StoreProduct,
-StoreOrder,
-}){
-// TODO add custom methods
-}
+  class MarketplaceModuleService extends MedusaService({
+    StoreUser,
+    StoreProduct,
+    StoreOrder,
+  }){
+    // TODO add custom methods
+  }
 
-export default MarketplaceModuleService
+  export default MarketplaceModuleService
+  ```
   
-````
+  The module’s main service extends the service factory to generate data management features for the `StoreUser`, `StoreProduct`, and `StoreOrder` data models.
   
-The module’s main service extends the service factory to generate data management features for the `StoreUser`, `StoreProduct`, and `StoreOrder` data models.
+  Finally, create the module definition at `src/modules/marketplace/index.ts` with the following content:
   
-Finally, create the module definition at `src/modules/marketplace/index.ts` with the following content:
+  ```ts title="src/modules/marketplace/index.ts"
+  import MarketplaceModuleService from "./service"
+  import { Module } from "@medusajs/utils"
 
-```ts title="src/modules/marketplace/index.ts"
-import MarketplaceModuleService from "./service"
+  export default Module("marketplace", {
+    service: MarketplaceModuleService,
+  })
+  ```
   
-export default {
-  service: MarketplaceModuleService,
-}
-````
+  To use the module, add it to the `modules` object in `medusa-config.js`:
   
-To use the module, add it to the `modules` object in `medusa-config.js`:
-
-```js title="medusa-config.js"
-module.exports = defineConfig({
-  // ...
-  modules: {
-    marketplaceModuleService: {
-      resolve: "./modules/marketplace",
-      definition: {
-        isQueryable: true,
+  ```js title="medusa-config.js"
+  module.exports = defineConfig({
+    // ...
+    modules: {
+      marketplaceModuleService: {
+        resolve: "./modules/marketplace",
+        definition: {
+          isQueryable: true,
+        },
       },
     },
-  },
-})
-```
+  })
+  ```
   
-Then, run the migrations of the module:
+  Then, run the migrations of the module:
   
-```bash npm2yarn
-npx medusa migrations run
-```
+  ```bash npm2yarn
+  npx medusa migrations run
+  ```
 
 </Details>
     
@@ -234,9 +228,9 @@ To attach admin users to their own stores, create a subscriber that listens to t
   showLinkIcon={false}
 />
 
-{/\* <Details summaryContent="Example">
+{/* <Details summaryContent="Example">
 
-Create the file `src/subscribers/user-created.ts` with the following content:
+  Create the file `src/subscribers/user-created.ts` with the following content:
   
 export const userSubscriberHighlights = [
   ["13", "data", "The event data payload with the created user's ID."],
@@ -257,20 +251,20 @@ export const userSubscriberHighlights = [
   } from "@medusajs/types"
   import MarketplaceModuleService from "../modules/marketplace/service"
 
-export default async function userCreatedHandler({
-data,
-container,
-}: SubscriberArgs<{ id: string }>) {
-const { id } = "data" in data ? data.data : data
-const userModuleService: IUserModuleService = container.resolve(
-ModuleRegistrationName.USER
-)
-const storeModuleService: IStoreModuleService = container.resolve(
-ModuleRegistrationName.STORE
-)
-const marketplaceModuleService: MarketplaceModuleService = container.resolve(
-"marketplaceModuleService"
-)
+  export default async function userCreatedHandler({
+    data,
+    container,
+  }: SubscriberArgs<{ id: string }>) {
+    const { id } = "data" in data ? data.data : data
+    const userModuleService: IUserModuleService = container.resolve(
+      ModuleRegistrationName.USER
+    )
+    const storeModuleService: IStoreModuleService = container.resolve(
+      ModuleRegistrationName.STORE
+    )
+    const marketplaceModuleService: MarketplaceModuleService = container.resolve(
+      "marketplaceModuleService"
+    )
 
     const user = await userModuleService.retrieveUser(id)
 
@@ -284,28 +278,26 @@ const marketplaceModuleService: MarketplaceModuleService = container.resolve(
     })
 
     console.log(`Created StoreUser ${storeUser.id}`)
+  }
 
-}
+  export const config: SubscriberConfig = {
+    event: "user.created",
+  }
+  ```
   
-export const config: SubscriberConfig = {
-event: "user.created",
-}
+  This adds a subscriber to the `user.created` event. In the subscriber, you:
   
-````
+  - Retrieve the created user. The created user’s ID is passed in the event’s data payload.
+  - Create a store for that user using the Store Module.
+  - Create a relationship between the user and the store by creating a `StoreUser` record.
   
-This adds a subscriber to the `user.created` event. In the subscriber, you:
+  To test it out, use the `medusa user` command to create a user:
   
-- Retrieve the created user. The created user’s ID is passed in the event’s data payload.
-- Create a store for that user using the Store Module.
-- Create a relationship between the user and the store by creating a `StoreUser` record.
+  ```bash npm2yarn
+  npx medusa user -e my-admin@medusa-test.com -p supersecret
+  ```
   
-To test it out, use the `medusa user` command to create a user:
-
-```bash npm2yarn
-npx medusa user -e my-admin@medusa-test.com -p supersecret
-````
-
-At the end of the output, you should see the message `Created StoreUser {store_user_id}` where the `{store_user_id}` is the ID of the created `StoreUser`.
+  At the end of the output, you should see the message `Created StoreUser {store_user_id}` where the `{store_user_id}` is the ID of the created `StoreUser`.
 
 </Details> */}
 
@@ -330,9 +322,9 @@ Similar to the previous section, to attach products to stores, create a subscrib
   showLinkIcon={false}
 />
 
-{/\* <Details summaryContent="Example">
+{/* <Details summaryContent="Example">
 
-Create the file `src/subscribers/product-created.ts` with the following content:
+  Create the file `src/subscribers/product-created.ts` with the following content:
 
 export const productSubscriberHighlights = [
   ["24", "retrieveProduct", "Retrieve the created product."],
@@ -351,14 +343,14 @@ export const productSubscriberHighlights = [
   } from "@medusajs/types"
   import MarketplaceModuleService from "../modules/marketplace/service"
 
-export default async function productCreateHandler({
-data,
-container,
-}: SubscriberArgs<{ id: string }>) {
-const { id } = "data" in data ? data.data : data
-const productModuleService: IProductModuleService = container.resolve(
-ModuleRegistrationName.PRODUCT
-)
+  export default async function productCreateHandler({
+    data,
+    container,
+  }: SubscriberArgs<{ id: string }>) {
+    const { id } = "data" in data ? data.data : data
+    const productModuleService: IProductModuleService = container.resolve(
+      ModuleRegistrationName.PRODUCT
+    )
     
     const marketplaceModuleService: MarketplaceModuleService = container.resolve(
       "marketplaceModuleService"
@@ -374,42 +366,40 @@ ModuleRegistrationName.PRODUCT
       store_id: product.metadata.store_id as string,
       product_id: id,
     })
+  }
 
-}
+  export const config: SubscriberConfig = {
+    event: "product.created",
+  }
+  ```
   
-export const config: SubscriberConfig = {
-event: "product.created",
-}
+  This adds a subscriber to the `product.created` event. In the subscriber, you:
   
-````
+  - Retrieve the created product.
+  - This subscriber requires the store ID to be set in `product.metadata.store_id`. If not, the subscriber ends execution.
+  - If the store ID is found, create a relationship between the product and the store by creating a `StoreProduct` record.
   
-This adds a subscriber to the `product.created` event. In the subscriber, you:
+  To test it out, start the Medusa application:
   
-- Retrieve the created product.
-- This subscriber requires the store ID to be set in `product.metadata.store_id`. If not, the subscriber ends execution.
-- If the store ID is found, create a relationship between the product and the store by creating a `StoreProduct` record.
+  ```bash npm2yarn
+  npm run dev
+  ```
   
-To test it out, start the Medusa application:
+  Then, send an authenticated `POST` request to `/admin/products`:
   
-```bash npm2yarn
-npm run dev
-````
+  ```bash
+  curl -X POST 'http://localhost:9000/admin/products' \
+  -H 'Content-Type: application/json' \
+  -H 'Authorization: Bearer {jwt_token}' \
+  --data '{
+      "title": "My Shirt 13",
+      "metadata": {
+          "store_id": "store_01HXV74JCCAHA3F2X3EWZTZG5R"
+      }
+  }' 
+  ```
   
-Then, send an authenticated `POST` request to `/admin/products`:
-
-```bash
-curl -X POST 'http://localhost:9000/admin/products' \
--H 'Content-Type: application/json' \
--H 'Authorization: Bearer {jwt_token}' \
---data '{
-    "title": "My Shirt 13",
-    "metadata": {
-        "store_id": "store_01HXV74JCCAHA3F2X3EWZTZG5R"
-    }
-}'
-```
-
-This returns the created product. In the next section, you’ll implement the API route to fetch the products of a store.
+  This returns the created product. In the next section, you’ll implement the API route to fetch the products of a store.
 
 </Details> */}
     
@@ -426,28 +416,26 @@ Retrieving module relationship data using the remote query is coming soon.
 
 </Note>
 
-<CardList
-  items={[
-    {
-      href: "!docs!/basics/api-routes",
-      title: "API Routes",
-      text: "Learn how to create an API Route in Medusa.",
-      startIcon: <AcademicCapSolid />,
-      showLinkIcon: false,
-    },
-    {
-      href: "!docs!/advanced-development/modules/remote-query",
-      title: "Remote Query",
-      text: "Use the remote query to fetch data across modules.",
-      startIcon: <AcademicCapSolid />,
-      showLinkIcon: false,
-    },
-  ]}
-/>
+<CardList items={[
+  {
+    href: "!docs!/basics/api-routes",
+    title: "API Routes",
+    text: "Learn how to create an API Route in Medusa.",
+    startIcon: <AcademicCapSolid />,
+    showLinkIcon: false
+  },
+  {
+    href: "!docs!/advanced-development/modules/remote-query",
+    title: "Remote Query",
+    text: "Use the remote query to fetch data across modules.",
+    startIcon: <AcademicCapSolid />,
+    showLinkIcon: false
+  },
+]} />
 
-{/\* <Details summaryContent="Example">
+{/* <Details summaryContent="Example">
 
-Create the file `src/api/admin/marketplace/products/route.ts` with the following content:
+  Create the file `src/api/admin/marketplace/products/route.ts` with the following content:
 
 export const productRoutesHighlights = [
   ["26", "storeUsers", "Retrieve the store of the logged-in user."],
@@ -469,17 +457,17 @@ export const productRoutesHighlights = [
   import MarketplaceModuleService 
     from "../../../../modules/marketplace/service"
 
-export async function GET(
-req: AuthenticatedMedusaRequest,
-res: MedusaResponse
-): Promise<void> {
-const marketplaceModuleService: MarketplaceModuleService =
-req.scope.resolve(
-"marketplaceModuleService"
-)
-const remoteQuery: RemoteQueryFunction = req.scope.resolve(
-ContainerRegistrationKeys.REMOTE_QUERY
-)
+  export async function GET(
+    req: AuthenticatedMedusaRequest,
+    res: MedusaResponse
+  ): Promise<void> {
+    const marketplaceModuleService: MarketplaceModuleService = 
+      req.scope.resolve(
+        "marketplaceModuleService"
+      )
+    const remoteQuery: RemoteQueryFunction = req.scope.resolve(
+      ContainerRegistrationKeys.REMOTE_QUERY
+    )
 
     const storeUsers = await marketplaceModuleService
       .listStoreUsers({
@@ -511,50 +499,48 @@ ContainerRegistrationKeys.REMOTE_QUERY
       store_id: storeUsers[0].store_id,
       products: result.map((data) => data.product),
     })
+  }
+  ```
   
-}
+  This creates a `GET` API route at `/admin/marketplace/products`. In the API route, you:
   
-````
+  - Retrieve the store of the logged-in user.
+  - Build a query that retrieves the products of that store.
+  - Retrieve the products using remote query and return them.
   
-This creates a `GET` API route at `/admin/marketplace/products`. In the API route, you:
+  Next, create the file `src/api/middlewares.ts` with the following content:
   
-- Retrieve the store of the logged-in user.
-- Build a query that retrieves the products of that store.
-- Retrieve the products using remote query and return them.
+  ```ts title="src/api/middlewares.ts"
+  import { 
+    MiddlewaresConfig, 
+    authenticate,
+  } from "@medusajs/medusa"
   
-Next, create the file `src/api/middlewares.ts` with the following content:
+  export const config: MiddlewaresConfig = {
+    routes: [
+      {
+        matcher: "/admin/marketplace*",
+        middlewares: [
+          authenticate(
+            "admin", 
+            ["session", "bearer", "api-key"]
+          ),
+        ],
+      },
+    ],
+  }
+  ```
   
-```ts title="src/api/middlewares.ts"
-import {
-  MiddlewaresConfig,
-  authenticate,
-} from "@medusajs/medusa"
+  This ensures that only authenticated admin users can access your API route.
   
-export const config: MiddlewaresConfig = {
-  routes: [
-    {
-      matcher: "/admin/marketplace*",
-      middlewares: [
-        authenticate(
-          "admin",
-          ["session", "bearer", "api-key"]
-        ),
-      ],
-    },
-  ],
-}
-````
+  To test it out, start the Medusa application. Then, send a `GET` request to `/admin/marketplace/products`:
   
-This ensures that only authenticated admin users can access your API route.
+  ```bash
+  curl 'localhost:9000/admin/marketplace/products' \
+  -H 'Authorization: Bearer {jwt_token}'
+  ```
   
-To test it out, start the Medusa application. Then, send a `GET` request to `/admin/marketplace/products`:
-
-```bash
-curl 'localhost:9000/admin/marketplace/products' \
--H 'Authorization: Bearer {jwt_token}'
-```
-
-This will return the product you created in the previous section, if the `{jwt_token}` belongs to the user of the same store ID.
+  This will return the product you created in the previous section, if the `{jwt_token}` belongs to the user of the same store ID.
 
 </Details> */}
     
@@ -579,9 +565,9 @@ The `order.placed` event is still not emitted in Medusa V2.
   showLinkIcon={false}
 />
 
-{/\* <Details summaryContent="Example">
+{/* <Details summaryContent="Example">
 
-Create the file `src/subscribers/order-created.ts` with the following content:
+  Create the file `src/subscribers/order-created.ts` with the following content:
 
 export const orderSubscriberHighlights = [
   ["35", "", "Loop over the created order’s items."],
@@ -605,15 +591,15 @@ export const orderSubscriberHighlights = [
     from "../modules/marketplace/service"
   import { createOrdersWorkflow } from "@medusajs/core-flows"
 
-export default async function orderCreatedHandler({
-data,
-container,
-}: SubscriberArgs<{ id: string }>) {
-const { id } = "data" in data ? data.data : data
-const orderModuleService: IOrderModuleService =
-container.resolve(
-ModuleRegistrationName.ORDER
-)
+  export default async function orderCreatedHandler({
+    data,
+    container,
+  }: SubscriberArgs<{ id: string }>) {
+    const { id } = "data" in data ? data.data : data
+    const orderModuleService: IOrderModuleService = 
+      container.resolve(
+        ModuleRegistrationName.ORDER
+      )
     
     const marketplaceModuleService: MarketplaceModuleService = 
       container.resolve(
@@ -686,25 +672,23 @@ ModuleRegistrationName.ORDER
         })
       })
     )
+  }
 
-}
+  export const config: SubscriberConfig = {
+    event: "order.placed",
+  }
+  ```
   
-export const config: SubscriberConfig = {
-event: "order.placed",
-}
+  This adds a subscriber to the `order.placed` event. In the subscriber, you:
   
-````
+  - Loop over the created order’s items.
+  - Group the items by their store ID.
+  - If the items have the same store ID, then associate the created order with the store.
+  - If there are items from more than one store in the order, create child orders and associate each of them with the store. Here, you use the `parent_order_id` property in the `StoreOrder` data model to point to the original order.
   
-This adds a subscriber to the `order.placed` event. In the subscriber, you:
+  To test this out, create an order in your store. That will run the subscriber and create the child orders.
   
-- Loop over the created order’s items.
-- Group the items by their store ID.
-- If the items have the same store ID, then associate the created order with the store.
-- If there are items from more than one store in the order, create child orders and associate each of them with the store. Here, you use the `parent_order_id` property in the `StoreOrder` data model to point to the original order.
-
-To test this out, create an order in your store. That will run the subscriber and create the child orders.
-
-The next section covers how to retrieve the store’s orders.
+  The next section covers how to retrieve the store’s orders.
 
 </Details> */}
     
@@ -722,95 +706,95 @@ Retrieving module relationship data using the remote query is coming soon.
 </Note>
 
 <CardList items={[
-{
-  href: "!docs!/basics/api-routes",
-  title: "API Routes",
-  text: "Learn how to create an API Route in Medusa.",
-  startIcon: <AcademicCapSolid />,
-  showLinkIcon: false
-},
-{
-  href: "!docs!/advanced-development/modules/remote-query",
-  title: "Remote Query",
-  text: "Use the remote query to fetch data across modules.",
-  startIcon: <AcademicCapSolid />,
-  showLinkIcon: false
-},
+  {
+    href: "!docs!/basics/api-routes",
+    title: "API Routes",
+    text: "Learn how to create an API Route in Medusa.",
+    startIcon: <AcademicCapSolid />,
+    showLinkIcon: false
+  },
+  {
+    href: "!docs!/advanced-development/modules/remote-query",
+    title: "Remote Query",
+    text: "Use the remote query to fetch data across modules.",
+    startIcon: <AcademicCapSolid />,
+    showLinkIcon: false
+  },
 ]} />
 
 {/* <Details summaryContent="Example">
 
-Create the file `src/api/admin/marketplace/orders/route.ts` with the following content:
+  Create the file `src/api/admin/marketplace/orders/route.ts` with the following content:
 
 export const orderRoutesHighlights = [
-["25", "", "Retrieve the store of the logged-in user."],
-["29", "", "Build a query that retrieves the orders of that store."],
-["41", "", "Retrieve the orders using remote query."]
+  ["25", "", "Retrieve the store of the logged-in user."],
+  ["29", "", "Build a query that retrieves the orders of that store."],
+  ["41", "", "Retrieve the orders using remote query."]
 ]
     
-```ts title="src/api/admin/marketplace/orders/route.ts" highlights={orderRoutesHighlights} collapsibleLines="1-12" expandButtonLabel="Show Imports"
-import {
-  AuthenticatedMedusaRequest,
-  MedusaResponse,
-} from "@medusajs/medusa"
-import { RemoteQueryFunction } from "@medusajs/modules-sdk"
-import {
-  remoteQueryObjectFromString,
-  ContainerRegistrationKeys,
-} from "@medusajs/utils"
-import MarketplaceModuleService
-  from "../../../../modules/marketplace/service"
+  ```ts title="src/api/admin/marketplace/orders/route.ts" highlights={orderRoutesHighlights} collapsibleLines="1-12" expandButtonLabel="Show Imports"
+  import { 
+    AuthenticatedMedusaRequest, 
+    MedusaResponse,
+  } from "@medusajs/medusa"
+  import { RemoteQueryFunction } from "@medusajs/modules-sdk"
+  import { 
+    remoteQueryObjectFromString,
+    ContainerRegistrationKeys,
+  } from "@medusajs/utils"
+  import MarketplaceModuleService 
+    from "../../../../modules/marketplace/service"
 
-export async function GET(
-  req: AuthenticatedMedusaRequest,
-  res: MedusaResponse
-): Promise<void> {
-  const marketplaceModuleService: MarketplaceModuleService =
-    req.scope.resolve(
-      "marketplaceModuleService"
+  export async function GET(
+    req: AuthenticatedMedusaRequest,
+    res: MedusaResponse
+  ): Promise<void> {
+    const marketplaceModuleService: MarketplaceModuleService = 
+      req.scope.resolve(
+        "marketplaceModuleService"
+      )
+    const remoteQuery: RemoteQueryFunction = req.scope.resolve(
+      ContainerRegistrationKeys.REMOTE_QUERY
     )
-  const remoteQuery: RemoteQueryFunction = req.scope.resolve(
-    ContainerRegistrationKeys.REMOTE_QUERY
-  )
 
-  const storeUsers = await marketplaceModuleService.listStoreUsers({
-    user_id: req.auth_context.actor_id,
-  })
+    const storeUsers = await marketplaceModuleService.listStoreUsers({
+      user_id: req.auth_context.actor_id,
+    })
 
-  const query = remoteQueryObjectFromString({
-    entryPoint: "store_order",
-    fields: [
-      "order.*",
-    ],
-    variables: {
-      filters: {
-        store_id: storeUsers[0].store_id,
+    const query = remoteQueryObjectFromString({
+      entryPoint: "store_order",
+      fields: [
+        "order.*",
+      ],
+      variables: {
+        filters: {
+          store_id: storeUsers[0].store_id,
+        },
       },
-    },
-  })
+    })
 
-  const result = await remoteQuery(query)
+    const result = await remoteQuery(query)
 
-  res.json({
-    orders: result.map((data) => data.order),
-  })
-}
-````
+    res.json({
+      orders: result.map((data) => data.order),
+    })
+  }
+  ```
   
-This creates a `GET` API route at `/admin/marketplace/orders`. In the API route, you:
+  This creates a `GET` API route at `/admin/marketplace/orders`. In the API route, you:
   
-- Retrieve the store of the logged-in user.
-- Build a query that retrieves the orders of that store.
-- Retrieve the orders using remote query and return them.
+  - Retrieve the store of the logged-in user.
+  - Build a query that retrieves the orders of that store.
+  - Retrieve the orders using remote query and return them.
   
-To test it out, start the Medusa application. Then, send a `GET` request to `/admin/marketplace/orders`:
+  To test it out, start the Medusa application. Then, send a `GET` request to `/admin/marketplace/orders`:
   
-```bash
-curl 'localhost:9000/admin/marketplace/orders' \
--H 'Authorization: Bearer {jwt_token}'
-```
+  ```bash
+  curl 'localhost:9000/admin/marketplace/orders' \
+  -H 'Authorization: Bearer {jwt_token}'
+  ```
   
-This will return the orders you created in the previous section if the `{jwt_token}` belongs to the user of the same store ID.
+  This will return the orders you created in the previous section if the `{jwt_token}` belongs to the user of the same store ID.
 
 </Details> */}
 
@@ -822,21 +806,19 @@ Medusa provides a Next.js storefront to use with your application. You can eithe
 
 For example, you can create an API route that retrieves available stores and another API route that retrieves the products of each store using the remote query as done in previous sections.
 
-<CardList
-  items={[
-    {
-      href: "/nextjs-starter",
-      title: "Next.js Storefront",
-      text: "Learn how to install and customize the Next.js storefront.",
-      startIcon: <AcademicCapSolid />,
-      showLinkIcon: false,
-    },
-    {
-      href: "!docs!/storefront-development/tips",
-      title: "Storefront Tips",
-      text: "Find tips on developing a custom storefront.",
-      startIcon: <AcademicCapSolid />,
-      showLinkIcon: false,
-    },
-  ]}
-/>
+<CardList items={[
+  {
+    href: "/nextjs-starter",
+    title: "Next.js Storefront",
+    text: "Learn how to install and customize the Next.js storefront.",
+    startIcon: <AcademicCapSolid />,
+    showLinkIcon: false
+  },
+  {
+    href: "!docs!/storefront-development/tips",
+    title: "Storefront Tips",
+    text: "Find tips on developing a custom storefront.",
+    startIcon: <AcademicCapSolid />,
+    showLinkIcon: false
+  },
+]} />

www/apps/resources/components/Navbar/index.tsx

@@ -30,6 +30,7 @@ const Navbar = () => {
         mobileSidebarOpen,
       }}
       isLoading={false}
+      showSearchOpener
     />
   )
 }

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

@@ -1,4 +1,8 @@
 export const filesMap = [
+  {
+    "filePath": "/www/apps/resources/app/_events-reference/page.mdx",
+    "pathname": "/_events-reference"
+  },
   {
     "filePath": "/www/apps/resources/app/admin-widget-injection-zones/page.mdx",
     "pathname": "/admin-widget-injection-zones"
@@ -79,18 +83,18 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/architectural-modules/workflow-engine/redis/page.mdx",
     "pathname": "/architectural-modules/workflow-engine/redis"
   },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/api-key/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/api-key/_events/_events-table"
+  },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/api-key/_events/page.mdx",
+    "pathname": "/commerce-modules/api-key/_events"
+  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/api-key/concepts/page.mdx",
     "pathname": "/commerce-modules/api-key/concepts"
   },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/api-key/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/api-key/events/_events-table"
-  },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/api-key/events/page.mdx",
-    "pathname": "/commerce-modules/api-key/events"
-  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/api-key/examples/page.mdx",
     "pathname": "/commerce-modules/api-key/examples"
@@ -103,6 +107,14 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/commerce-modules/api-key/relations-to-other-modules/page.mdx",
     "pathname": "/commerce-modules/api-key/relations-to-other-modules"
   },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/auth/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/auth/_events/_events-table"
+  },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/auth/_events/page.mdx",
+    "pathname": "/commerce-modules/auth/_events"
+  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/auth/auth-flows/page.mdx",
     "pathname": "/commerce-modules/auth/auth-flows"
@@ -131,14 +143,6 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/commerce-modules/auth/create-actor-type/page.mdx",
     "pathname": "/commerce-modules/auth/create-actor-type"
   },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/auth/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/auth/events/_events-table"
-  },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/auth/events/page.mdx",
-    "pathname": "/commerce-modules/auth/events"
-  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/auth/examples/page.mdx",
     "pathname": "/commerce-modules/auth/examples"
@@ -151,18 +155,18 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/commerce-modules/auth/page.mdx",
     "pathname": "/commerce-modules/auth"
   },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/cart/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/cart/_events/_events-table"
+  },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/cart/_events/page.mdx",
+    "pathname": "/commerce-modules/cart/_events"
+  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/cart/concepts/page.mdx",
     "pathname": "/commerce-modules/cart/concepts"
   },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/cart/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/cart/events/_events-table"
-  },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/cart/events/page.mdx",
-    "pathname": "/commerce-modules/cart/events"
-  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/cart/examples/page.mdx",
     "pathname": "/commerce-modules/cart/examples"
@@ -184,12 +188,12 @@ export const filesMap = [
     "pathname": "/commerce-modules/cart/tax-lines"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/currency/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/currency/events/_events-table"
+    "filePath": "/www/apps/resources/app/commerce-modules/currency/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/currency/_events/_events-table"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/currency/events/page.mdx",
-    "pathname": "/commerce-modules/currency/events"
+    "filePath": "/www/apps/resources/app/commerce-modules/currency/_events/page.mdx",
+    "pathname": "/commerce-modules/currency/_events"
   },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/currency/examples/page.mdx",
@@ -203,18 +207,18 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/commerce-modules/currency/relations-to-other-modules/page.mdx",
     "pathname": "/commerce-modules/currency/relations-to-other-modules"
   },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/customer/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/customer/_events/_events-table"
+  },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/customer/_events/page.mdx",
+    "pathname": "/commerce-modules/customer/_events"
+  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/customer/customer-accounts/page.mdx",
     "pathname": "/commerce-modules/customer/customer-accounts"
   },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/customer/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/customer/events/_events-table"
-  },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/customer/events/page.mdx",
-    "pathname": "/commerce-modules/customer/events"
-  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/customer/examples/page.mdx",
     "pathname": "/commerce-modules/customer/examples"
@@ -227,18 +231,18 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/commerce-modules/customer/relations-to-other-modules/page.mdx",
     "pathname": "/commerce-modules/customer/relations-to-other-modules"
   },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/fulfillment/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/fulfillment/_events/_events-table"
+  },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/fulfillment/_events/page.mdx",
+    "pathname": "/commerce-modules/fulfillment/_events"
+  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/fulfillment/concepts/page.mdx",
     "pathname": "/commerce-modules/fulfillment/concepts"
   },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/fulfillment/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/fulfillment/events/_events-table"
-  },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/fulfillment/events/page.mdx",
-    "pathname": "/commerce-modules/fulfillment/events"
-  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/fulfillment/fulfillment-provider/page.mdx",
     "pathname": "/commerce-modules/fulfillment/fulfillment-provider"
@@ -263,18 +267,18 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/commerce-modules/fulfillment/shipping-option/page.mdx",
     "pathname": "/commerce-modules/fulfillment/shipping-option"
   },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/inventory/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/inventory/_events/_events-table"
+  },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/inventory/_events/page.mdx",
+    "pathname": "/commerce-modules/inventory/_events"
+  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/inventory/concepts/page.mdx",
     "pathname": "/commerce-modules/inventory/concepts"
   },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/inventory/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/inventory/events/_events-table"
-  },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/inventory/events/page.mdx",
-    "pathname": "/commerce-modules/inventory/events"
-  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/inventory/examples/page.mdx",
     "pathname": "/commerce-modules/inventory/examples"
@@ -291,18 +295,18 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/commerce-modules/inventory/relations-to-other-modules/page.mdx",
     "pathname": "/commerce-modules/inventory/relations-to-other-modules"
   },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/order/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/order/_events/_events-table"
+  },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/order/_events/page.mdx",
+    "pathname": "/commerce-modules/order/_events"
+  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/order/concepts/page.mdx",
     "pathname": "/commerce-modules/order/concepts"
   },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/order/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/order/events/_events-table"
-  },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/order/events/page.mdx",
-    "pathname": "/commerce-modules/order/events"
-  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/order/order-change/page.mdx",
     "pathname": "/commerce-modules/order/order-change"
@@ -336,12 +340,12 @@ export const filesMap = [
     "pathname": "/commerce-modules"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/payment/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/payment/events/_events-table"
+    "filePath": "/www/apps/resources/app/commerce-modules/payment/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/payment/_events/_events-table"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/payment/events/page.mdx",
-    "pathname": "/commerce-modules/payment/events"
+    "filePath": "/www/apps/resources/app/commerce-modules/payment/_events/page.mdx",
+    "pathname": "/commerce-modules/payment/_events"
   },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/payment/examples/page.mdx",
@@ -387,18 +391,18 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/commerce-modules/payment/webhook-events/page.mdx",
     "pathname": "/commerce-modules/payment/webhook-events"
   },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/pricing/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/pricing/_events/_events-table"
+  },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/pricing/_events/page.mdx",
+    "pathname": "/commerce-modules/pricing/_events"
+  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/pricing/concepts/page.mdx",
     "pathname": "/commerce-modules/pricing/concepts"
   },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/pricing/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/pricing/events/_events-table"
-  },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/pricing/events/page.mdx",
-    "pathname": "/commerce-modules/pricing/events"
-  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/pricing/examples/page.mdx",
     "pathname": "/commerce-modules/pricing/examples"
@@ -420,12 +424,12 @@ export const filesMap = [
     "pathname": "/commerce-modules/pricing/relations-to-other-modules"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/product/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/product/events/_events-table"
+    "filePath": "/www/apps/resources/app/commerce-modules/product/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/product/_events/_events-table"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/product/events/page.mdx",
-    "pathname": "/commerce-modules/product/events"
+    "filePath": "/www/apps/resources/app/commerce-modules/product/_events/page.mdx",
+    "pathname": "/commerce-modules/product/_events"
   },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/product/examples/page.mdx",
@@ -439,6 +443,14 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/commerce-modules/product/relations-to-other-modules/page.mdx",
     "pathname": "/commerce-modules/product/relations-to-other-modules"
   },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/promotion/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/promotion/_events/_events-table"
+  },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/promotion/_events/page.mdx",
+    "pathname": "/commerce-modules/promotion/_events"
+  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/promotion/actions/page.mdx",
     "pathname": "/commerce-modules/promotion/actions"
@@ -455,14 +467,6 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/commerce-modules/promotion/concepts/page.mdx",
     "pathname": "/commerce-modules/promotion/concepts"
   },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/promotion/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/promotion/events/_events-table"
-  },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/promotion/events/page.mdx",
-    "pathname": "/commerce-modules/promotion/events"
-  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/promotion/examples/page.mdx",
     "pathname": "/commerce-modules/promotion/examples"
@@ -476,12 +480,12 @@ export const filesMap = [
     "pathname": "/commerce-modules/promotion/relations-to-other-modules"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/region/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/region/events/_events-table"
+    "filePath": "/www/apps/resources/app/commerce-modules/region/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/region/_events/_events-table"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/region/events/page.mdx",
-    "pathname": "/commerce-modules/region/events"
+    "filePath": "/www/apps/resources/app/commerce-modules/region/_events/page.mdx",
+    "pathname": "/commerce-modules/region/_events"
   },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/region/examples/page.mdx",
@@ -496,12 +500,12 @@ export const filesMap = [
     "pathname": "/commerce-modules/region/relations-to-other-modules"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/sales-channel/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/sales-channel/events/_events-table"
+    "filePath": "/www/apps/resources/app/commerce-modules/sales-channel/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/sales-channel/_events/_events-table"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/sales-channel/events/page.mdx",
-    "pathname": "/commerce-modules/sales-channel/events"
+    "filePath": "/www/apps/resources/app/commerce-modules/sales-channel/_events/page.mdx",
+    "pathname": "/commerce-modules/sales-channel/_events"
   },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/sales-channel/examples/page.mdx",
@@ -519,18 +523,18 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/commerce-modules/sales-channel/relations-to-other-modules/page.mdx",
     "pathname": "/commerce-modules/sales-channel/relations-to-other-modules"
   },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/stock-location/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/stock-location/_events/_events-table"
+  },
+  {
+    "filePath": "/www/apps/resources/app/commerce-modules/stock-location/_events/page.mdx",
+    "pathname": "/commerce-modules/stock-location/_events"
+  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/stock-location/concepts/page.mdx",
     "pathname": "/commerce-modules/stock-location/concepts"
   },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/stock-location/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/stock-location/events/_events-table"
-  },
-  {
-    "filePath": "/www/apps/resources/app/commerce-modules/stock-location/events/page.mdx",
-    "pathname": "/commerce-modules/stock-location/events"
-  },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/stock-location/examples/page.mdx",
     "pathname": "/commerce-modules/stock-location/examples"
@@ -544,12 +548,12 @@ export const filesMap = [
     "pathname": "/commerce-modules/stock-location/relations-to-other-modules"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/store/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/store/events/_events-table"
+    "filePath": "/www/apps/resources/app/commerce-modules/store/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/store/_events/_events-table"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/store/events/page.mdx",
-    "pathname": "/commerce-modules/store/events"
+    "filePath": "/www/apps/resources/app/commerce-modules/store/_events/page.mdx",
+    "pathname": "/commerce-modules/store/_events"
   },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/store/examples/page.mdx",
@@ -564,12 +568,12 @@ export const filesMap = [
     "pathname": "/commerce-modules/store/relations-to-other-modules"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/tax/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/tax/events/_events-table"
+    "filePath": "/www/apps/resources/app/commerce-modules/tax/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/tax/_events/_events-table"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/tax/events/page.mdx",
-    "pathname": "/commerce-modules/tax/events"
+    "filePath": "/www/apps/resources/app/commerce-modules/tax/_events/page.mdx",
+    "pathname": "/commerce-modules/tax/_events"
   },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/tax/examples/page.mdx",
@@ -596,12 +600,12 @@ export const filesMap = [
     "pathname": "/commerce-modules/tax/tax-region"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/user/events/_events-table/page.mdx",
-    "pathname": "/commerce-modules/user/events/_events-table"
+    "filePath": "/www/apps/resources/app/commerce-modules/user/_events/_events-table/page.mdx",
+    "pathname": "/commerce-modules/user/_events/_events-table"
   },
   {
-    "filePath": "/www/apps/resources/app/commerce-modules/user/events/page.mdx",
-    "pathname": "/commerce-modules/user/events"
+    "filePath": "/www/apps/resources/app/commerce-modules/user/_events/page.mdx",
+    "pathname": "/commerce-modules/user/_events"
   },
   {
     "filePath": "/www/apps/resources/app/commerce-modules/user/examples/page.mdx",
@@ -671,10 +675,6 @@ export const filesMap = [
     "filePath": "/www/apps/resources/app/deployment/storefront/vercel/page.mdx",
     "pathname": "/deployment/storefront/vercel"
   },
-  {
-    "filePath": "/www/apps/resources/app/events-reference/page.mdx",
-    "pathname": "/events-reference"
-  },
   {
     "filePath": "/www/apps/resources/app/favicon.ico",
     "pathname": "/"

www/apps/resources/generated/sidebar.mjs

@@ -162,13 +162,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/api-key/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -371,13 +364,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/auth/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -880,13 +866,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/cart/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -990,13 +969,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/currency/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -1275,13 +1247,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/customer/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -1931,13 +1896,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/fulfillment/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -2293,13 +2251,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/inventory/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -3187,13 +3138,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/order/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -3557,13 +3501,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/payment/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -3947,13 +3884,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/pricing/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -4533,13 +4463,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/product/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -4881,13 +4804,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/promotion/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -5061,13 +4977,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/region/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -5220,13 +5129,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/sales-channel/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -5386,13 +5288,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/stock-location/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -5545,13 +5440,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/store/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -5823,13 +5711,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/tax/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -6052,13 +5933,6 @@ export const generatedSidebar = [
                     ]
                   }
                 ]
-              },
-              {
-                "loaded": true,
-                "isPathHref": true,
-                "path": "/commerce-modules/user/events",
-                "title": "Events Reference",
-                "children": []
               }
             ]
           }
@@ -7917,13 +7791,6 @@ export const generatedSidebar = [
         "title": "Medusa Container Resources",
         "children": []
       },
-      {
-        "loaded": true,
-        "isPathHref": true,
-        "path": "/events-reference",
-        "title": "Events",
-        "children": []
-      },
       {
         "loaded": true,
         "isPathHref": true,

www/apps/resources/sidebar.mjs

@@ -65,10 +65,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/api-key/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/api-key/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -156,10 +156,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/auth/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/auth/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -224,10 +224,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/cart/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/cart/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -280,10 +280,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/currency/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/currency/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -340,10 +340,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/customer/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/customer/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -417,10 +417,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/fulfillment/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/fulfillment/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -482,10 +482,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/inventory/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/inventory/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -558,10 +558,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/order/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/order/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -657,10 +657,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/payment/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/payment/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -725,10 +725,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/pricing/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/pricing/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -781,10 +781,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/product/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/product/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -853,10 +853,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/promotion/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/promotion/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -909,10 +909,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/region/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/region/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -971,10 +971,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/sales-channel/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/sales-channel/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -1034,10 +1034,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/stock-location/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/stock-location/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -1090,10 +1090,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/store/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/store/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -1162,10 +1162,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/tax/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/tax/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -1222,10 +1222,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
                   },
                 ],
               },
-              {
-                path: "/commerce-modules/user/events",
-                title: "Events Reference",
-              },
+              // {
+              //   path: "/commerce-modules/user/events",
+              //   title: "Events Reference",
+              // },
             ],
           },
         ],
@@ -2104,10 +2104,10 @@ export const sidebar = sidebarAttachHrefCommonOptions([
         path: "/medusa-container-resources",
         title: "Medusa Container Resources",
       },
-      {
-        path: "/events-reference",
-        title: "Events",
-      },
+      // {
+      //   path: "/events-reference",
+      //   title: "Events",
+      // },
       {
         path: "/admin-widget-injection-zones",
         title: "Admin Widget Injection Zones",

www/apps/ui/.env.example

@@ -9,4 +9,3 @@ NEXT_PUBLIC_SEGMENT_API_KEY=
 NEXT_PUBLIC_AI_ASSISTANT_URL=
 NEXT_PUBLIC_AI_WEBSITE_ID=
 NEXT_PUBLIC_AI_API_ASSISTANT_RECAPTCHA_SITE_KEY=
-NEXT_PUBLIC_SHOW_V2=

www/apps/ui/src/config/docs.tsx

@@ -1,10 +1,5 @@
 import { ArrowUpRightOnBox } from "@medusajs/icons"
-import {
-  NavbarItem,
-  getNavbarItems,
-  legacyMobileSidebarItems,
-  mobileSidebarItemsV1,
-} from "docs-ui"
+import { NavbarItem, getNavbarItems, mobileSidebarItemsV1 } from "docs-ui"
 import { SidebarSectionItemsType } from "types"
 import { siteConfig } from "./site"
 
@@ -17,7 +12,7 @@ export const docsConfig: DocsConfig = {
   mainNav: getNavbarItems({
     basePath: siteConfig.baseUrl,
     activePath: process.env.NEXT_PUBLIC_BASE_PATH || "/ui",
-    version: process.env.NEXT_PUBLIC_SHOW_V2 ? "v1" : "legacy",
+    version: "v1",
   }),
   sidebar: {
     top: [
@@ -285,8 +280,6 @@ export const docsConfig: DocsConfig = {
         ],
       },
     ],
-    mobile: process.env.NEXT_PUBLIC_SHOW_V2
-      ? mobileSidebarItemsV1
-      : legacyMobileSidebarItems,
+    mobile: mobileSidebarItemsV1,
   },
 }

www/packages/docs-ui/src/constants.tsx

@@ -52,22 +52,23 @@ export const navbarItemsV1: NavbarItem[] = [
       href: `/ui`,
     },
   },
-  {
-    type: "divider",
-  },
-  {
-    type: "link",
-    props: {
-      label: "Learn Medusa v2",
-      target: "_blank",
-      rel: "noreferrer",
-      href: `/v2`,
-      badge: {
-        variant: "blue",
-        children: "New",
-      },
-    },
-  },
+  // TODO enable them later
+  // {
+  //   type: "divider",
+  // },
+  // {
+  //   type: "link",
+  //   props: {
+  //     label: "Learn Medusa v2",
+  //     target: "_blank",
+  //     rel: "noreferrer",
+  //     href: `/v2`,
+  //     badge: {
+  //       variant: "blue",
+  //       children: "New",
+  //     },
+  //   },
+  // },
 ]
 
 export const navbarItemsV2: NavbarItem[] = [
@@ -122,71 +123,10 @@ export const navbarItemsV2: NavbarItem[] = [
   {
     type: "link",
     props: {
-      label: "Medusa V1",
+      label: "Medusa v1",
       target: "_blank",
       rel: "noreferrer",
       href: `/`,
-      badge: {
-        variant: "neutral",
-        children: "v1",
-      },
-    },
-  },
-]
-
-export const legacyNavbarItems: NavbarItem[] = [
-  {
-    type: "link",
-    props: {
-      label: "Docs",
-      target: "_blank",
-      rel: "noreferrer",
-      href: `/`,
-    },
-  },
-  {
-    type: "link",
-    props: {
-      label: "Resources",
-      target: "_blank",
-      rel: "noreferrer",
-      href: `/resources`,
-    },
-  },
-  {
-    type: "link",
-    props: {
-      label: "User Guide",
-      target: "_blank",
-      rel: "noreferrer",
-      href: `/user-guide`,
-    },
-  },
-  {
-    type: "link",
-    props: {
-      label: "Store API",
-      target: "_blank",
-      rel: "noreferrer",
-      href: `/api/store`,
-    },
-  },
-  {
-    type: "link",
-    props: {
-      label: "Admin API",
-      target: "_blank",
-      rel: "noreferrer",
-      href: `/api/admin`,
-    },
-  },
-  {
-    type: "link",
-    props: {
-      label: "UI",
-      target: "_blank",
-      rel: "noreferrer",
-      href: `/ui`,
     },
   },
 ]
@@ -222,13 +162,13 @@ export const mobileSidebarItemsV1: SidebarItemType[] = [
     loaded: true,
     isPathHref: true,
   },
-  {
-    title: "Learn Medusa V2",
-    path: `/v2`,
-    loaded: true,
-    isPathHref: true,
-    additionalElms: <Badge variant="blue">v2</Badge>,
-  },
+  // {
+  //   title: "Learn Medusa V2",
+  //   path: `/v2`,
+  //   loaded: true,
+  //   isPathHref: true,
+  //   additionalElms: <Badge variant="blue">v2</Badge>,
+  // },
 ]
 
 export const mobileSidebarItemsV2: SidebarItemType[] = [
@@ -263,51 +203,17 @@ export const mobileSidebarItemsV2: SidebarItemType[] = [
     isPathHref: true,
   },
   {
-    title: "Docs",
+    title: "Medusa v1",
     path: `/`,
     loaded: true,
     isPathHref: true,
-    additionalElms: <Badge variant="neutral">v1</Badge>,
-  },
-]
-
-export const legacyMobileSidebarItems: SidebarItemType[] = [
-  {
-    title: "Docs",
-    path: `/`,
-    loaded: true,
-    isPathHref: true,
-  },
-  {
-    title: "User Guide",
-    path: `/user-guide`,
-    loaded: true,
-    isPathHref: true,
-  },
-  {
-    title: "Store API",
-    path: `/api/store`,
-    loaded: true,
-    isPathHref: true,
-  },
-  {
-    title: "Admin API",
-    path: `/api/admin`,
-    loaded: true,
-    isPathHref: true,
-  },
-  {
-    title: "UI",
-    path: `/ui`,
-    loaded: true,
-    isPathHref: true,
   },
 ]
 
 export const searchFiltersV2: OptionType[] = [
   {
     value: "book",
-    label: "Docs V2",
+    label: "Docs v2",
   },
   {
     value: "resources",
@@ -315,11 +221,11 @@ export const searchFiltersV2: OptionType[] = [
   },
   {
     value: "admin-v2",
-    label: "Admin API",
+    label: "Admin API (v2)",
   },
   {
     value: "store-v2",
-    label: "Store API",
+    label: "Store API (v2)",
   },
   // TODO add more filters
 ]

www/packages/docs-ui/src/utils/get-navbar-items.ts

@@ -1,22 +1,17 @@
-import { NavbarItem, legacyNavbarItems, navbarItemsV1, navbarItemsV2 } from ".."
+import { NavbarItem, navbarItemsV1, navbarItemsV2 } from ".."
 
 type Options = {
   basePath: string
   activePath: string
-  version?: "v1" | "v2" | "legacy"
+  version?: "v1" | "v2"
 }
 
 export function getNavbarItems({
   basePath,
   activePath,
-  version = "legacy",
+  version = "v1",
 }: Options): NavbarItem[] {
-  const navbarItems =
-    version === "v2"
-      ? navbarItemsV2
-      : version === "v1"
-      ? navbarItemsV1
-      : legacyNavbarItems
+  const navbarItems = version === "v2" ? navbarItemsV2 : navbarItemsV1
   return navbarItems.map((item) => {
     if (item.type === "divider") {
       return item