@mantajs/dashboard 0.1.11 → 0.1.12

package/dist/app.css

@@ -1574,6 +1574,9 @@ video {
 .grid {
   display: grid;
 }
+.contents {
+  display: contents;
+}
 .hidden {
   display: none;
 }

package/dist/app.js

@@ -100539,7 +100539,7 @@ var init_main_layout = __esm({
         items: item.items?.map((sub2) => ({
           label: sub2.useTranslation ? t5(sub2.label) : sub2.label,
           to: sub2.to
-        }))
+        })) ?? []
       }));
     };
     Searchbar = () => {
@@ -100569,7 +100569,7 @@ var init_main_layout = __esm({
       menuItems.forEach((item) => {
         if (item.nested) {
           const route = coreRoutes.find((route2) => route2.to === item.nested);
-          if (route) {
+          if (route && !route.items?.some((existing) => existing.to === item.to)) {
             route.items?.push(item);
           }
         }
@@ -102790,6 +102790,42 @@ var init_loader = __esm({
   }
 });
 
+// src/dashboard-app/routes/merge-extension-routes.ts
+function mergeExtensionRoutes(staticRoutes, extensionRoutes) {
+  if (!extensionRoutes.length) return staticRoutes;
+  const result = [...staticRoutes];
+  for (const ext of extensionRoutes) {
+    const extPath = (ext.path ?? "").replace(/^\/+/, "");
+    const idx = result.findIndex(
+      (r) => (r.path ?? "").replace(/^\/+/, "") === extPath
+    );
+    if (idx === -1) {
+      result.push(ext);
+      continue;
+    }
+    const existing = result[idx];
+    const merged = { ...existing };
+    if (ext.lazy) {
+      merged.lazy = ext.lazy;
+      delete merged.Component;
+      delete merged.loader;
+    }
+    if (ext.children || existing.children) {
+      merged.children = mergeExtensionRoutes(
+        existing.children || [],
+        ext.children || []
+      );
+    }
+    result[idx] = merged;
+  }
+  return result;
+}
+var init_merge_extension_routes = __esm({
+  "src/dashboard-app/routes/merge-extension-routes.ts"() {
+    "use strict";
+  }
+});
+
 // src/routes/home/home.tsx
 var import_react28, import_react_router_dom13, import_jsx_runtime27, Home;
 var init_home = __esm({
@@ -193924,7 +193960,7 @@ function getRouteMap({
       children: [
         {
           element: /* @__PURE__ */ (0, import_jsx_runtime706.jsx)(MainLayout, {}),
-          children: [
+          children: mergeExtensionRoutes([
             {
               path: "/",
               errorElement: /* @__PURE__ */ (0, import_jsx_runtime706.jsx)(ErrorBoundary, {}),
@@ -194610,9 +194646,8 @@ function getRouteMap({
                   ]
                 }
               ]
-            },
-            ...coreRoutes
-          ]
+            }
+          ], coreRoutes)
         }
       ]
     },
@@ -194626,7 +194661,7 @@ function getRouteMap({
             breadcrumb: () => (0, import_i18next9.t)("app.nav.settings.header")
           },
           element: /* @__PURE__ */ (0, import_jsx_runtime706.jsx)(SettingsLayout, {}),
-          children: [
+          children: mergeExtensionRoutes([
             {
               index: true,
               errorElement: /* @__PURE__ */ (0, import_jsx_runtime706.jsx)(ErrorBoundary, {}),
@@ -195357,9 +195392,8 @@ function getRouteMap({
                   lazy: () => Promise.resolve().then(() => (init_add_locales2(), add_locales_exports))
                 }
               ]
-            },
-            ...settingsRoutes?.[0]?.children || []
-          ]
+            }
+          ], settingsRoutes?.[0]?.children || [])
         }
       ]
     },
@@ -195404,6 +195438,7 @@ var init_get_route_map = __esm({
     init_error_boundary2();
     init_breadcrumb();
     init_loader();
+    init_merge_extension_routes();
     import_jsx_runtime706 = require("react/jsx-runtime");
   }
 });

package/dist/app.mjs

@@ -1,6 +1,6 @@
 import {
   DashboardApp
-} from "./chunk-6AOXP3RP.mjs";
+} from "./chunk-VHUQFKRO.mjs";
 import "./chunk-2SSUH2HJ.mjs";
 import "./chunk-ONB3JEHR.mjs";
 import "./chunk-YCDDT44O.mjs";

package/dist/{chunk-6AOXP3RP.mjs → chunk-VHUQFKRO.mjs}

@@ -95537,7 +95537,7 @@ var useCoreRoutes = () => {
     items: item.items?.map((sub) => ({
       label: sub.useTranslation ? t2(sub.label) : sub.label,
       to: sub.to
-    }))
+    })) ?? []
   }));
 };
 var Searchbar = () => {
@@ -95567,7 +95567,7 @@ var CoreRouteSection = () => {
   menuItems.forEach((item) => {
     if (item.nested) {
       const route = coreRoutes.find((route2) => route2.to === item.nested);
-      if (route) {
+      if (route && !route.items?.some((existing) => existing.to === item.to)) {
         route.items?.push(item);
       }
     }
@@ -95910,6 +95910,37 @@ var ErrorBoundary = () => {
   ] }) }) });
 };
 
+// src/dashboard-app/routes/merge-extension-routes.ts
+function mergeExtensionRoutes(staticRoutes, extensionRoutes) {
+  if (!extensionRoutes.length) return staticRoutes;
+  const result = [...staticRoutes];
+  for (const ext of extensionRoutes) {
+    const extPath = (ext.path ?? "").replace(/^\/+/, "");
+    const idx = result.findIndex(
+      (r) => (r.path ?? "").replace(/^\/+/, "") === extPath
+    );
+    if (idx === -1) {
+      result.push(ext);
+      continue;
+    }
+    const existing = result[idx];
+    const merged = { ...existing };
+    if (ext.lazy) {
+      merged.lazy = ext.lazy;
+      delete merged.Component;
+      delete merged.loader;
+    }
+    if (ext.children || existing.children) {
+      merged.children = mergeExtensionRoutes(
+        existing.children || [],
+        ext.children || []
+      );
+    }
+    result[idx] = merged;
+  }
+  return result;
+}
+
 // src/dashboard-app/routes/get-route.map.tsx
 import { jsx as jsx17 } from "react/jsx-runtime";
 function getRouteMap({
@@ -95923,7 +95954,7 @@ function getRouteMap({
       children: [
         {
           element: /* @__PURE__ */ jsx17(MainLayout, {}),
-          children: [
+          children: mergeExtensionRoutes([
             {
               path: "/",
               errorElement: /* @__PURE__ */ jsx17(ErrorBoundary, {}),
@@ -95950,7 +95981,7 @@ function getRouteMap({
                   children: [
                     {
                       path: "create",
-                      lazy: () => import("./product-create-T4PVLEL7.mjs")
+                      lazy: () => import("./product-create-GZANVK54.mjs")
                     },
                     {
                       path: "import",
@@ -95966,7 +95997,7 @@ function getRouteMap({
                   path: ":id",
                   errorElement: /* @__PURE__ */ jsx17(ErrorBoundary, {}),
                   lazy: async () => {
-                    const { Breadcrumb, loader } = await import("./product-detail-77R3VVI5.mjs");
+                    const { Breadcrumb, loader } = await import("./product-detail-P3LEJNTC.mjs");
                     return {
                       Component: Outlet4,
                       loader,
@@ -95978,11 +96009,11 @@ function getRouteMap({
                   children: [
                     {
                       path: "",
-                      lazy: () => import("./product-detail-77R3VVI5.mjs"),
+                      lazy: () => import("./product-detail-P3LEJNTC.mjs"),
                       children: [
                         {
                           path: "edit",
-                          lazy: () => import("./product-edit-CPKK4QSD.mjs")
+                          lazy: () => import("./product-edit-ZWEDI4DK.mjs")
                         },
                         {
                           path: "edit-variant",
@@ -95994,11 +96025,11 @@ function getRouteMap({
                         },
                         {
                           path: "attributes",
-                          lazy: () => import("./product-attributes-WOKHQSU3.mjs")
+                          lazy: () => import("./product-attributes-NT25DQN6.mjs")
                         },
                         {
                           path: "organization",
-                          lazy: () => import("./product-organization-BH5TZRYS.mjs")
+                          lazy: () => import("./product-organization-3PJP3Y43.mjs")
                         },
                         {
                           path: "shipping-profile",
@@ -96609,9 +96640,8 @@ function getRouteMap({
                   ]
                 }
               ]
-            },
-            ...coreRoutes
-          ]
+            }
+          ], coreRoutes)
         }
       ]
     },
@@ -96625,7 +96655,7 @@ function getRouteMap({
             breadcrumb: () => t("app.nav.settings.header")
           },
           element: /* @__PURE__ */ jsx17(SettingsLayout, {}),
-          children: [
+          children: mergeExtensionRoutes([
             {
               index: true,
               errorElement: /* @__PURE__ */ jsx17(ErrorBoundary, {}),
@@ -97356,9 +97386,8 @@ function getRouteMap({
                   lazy: () => import("./add-locales-47HF5EWF.mjs")
                 }
               ]
-            },
-            ...settingsRoutes?.[0]?.children || []
-          ]
+            }
+          ], settingsRoutes?.[0]?.children || [])
         }
       ]
     },

package/dist/{product-attributes-WOKHQSU3.mjs → product-attributes-NT25DQN6.mjs}

@@ -15,7 +15,7 @@ import {
 import {
   FormExtensionZone,
   useExtendableForm
-} from "./chunk-6AOXP3RP.mjs";
+} from "./chunk-VHUQFKRO.mjs";
 import "./chunk-2SSUH2HJ.mjs";
 import "./chunk-ONB3JEHR.mjs";
 import "./chunk-YCDDT44O.mjs";

package/dist/{product-create-T4PVLEL7.mjs → product-create-GZANVK54.mjs}

@@ -57,7 +57,7 @@ import {
 import {
   FormExtensionZone,
   useExtendableForm
-} from "./chunk-6AOXP3RP.mjs";
+} from "./chunk-VHUQFKRO.mjs";
 import "./chunk-2SSUH2HJ.mjs";
 import "./chunk-ONB3JEHR.mjs";
 import "./chunk-YCDDT44O.mjs";

package/dist/{product-detail-77R3VVI5.mjs → product-detail-P3LEJNTC.mjs}

@@ -17,7 +17,7 @@ import {
 } from "./chunk-GIZFNLKK.mjs";
 import {
   getLinkedFields
-} from "./chunk-6AOXP3RP.mjs";
+} from "./chunk-VHUQFKRO.mjs";
 import "./chunk-2SSUH2HJ.mjs";
 import "./chunk-ONB3JEHR.mjs";
 import "./chunk-YCDDT44O.mjs";

package/dist/{product-edit-CPKK4QSD.mjs → product-edit-ZWEDI4DK.mjs}

@@ -18,7 +18,7 @@ import {
 import {
   FormExtensionZone,
   useExtendableForm
-} from "./chunk-6AOXP3RP.mjs";
+} from "./chunk-VHUQFKRO.mjs";
 import "./chunk-2SSUH2HJ.mjs";
 import "./chunk-ONB3JEHR.mjs";
 import "./chunk-YCDDT44O.mjs";

package/dist/{product-organization-BH5TZRYS.mjs → product-organization-3PJP3Y43.mjs}

@@ -20,7 +20,7 @@ import {
 import {
   FormExtensionZone,
   useExtendableForm
-} from "./chunk-6AOXP3RP.mjs";
+} from "./chunk-VHUQFKRO.mjs";
 import "./chunk-2SSUH2HJ.mjs";
 import "./chunk-ONB3JEHR.mjs";
 import "./chunk-YCDDT44O.mjs";

package/dist/vite-plugin/index.d.mts

@@ -17,6 +17,15 @@ type MenuConfig = {
     items: MenuItem[];
 };
 
-declare function menuConfigPlugin(): Plugin;
+/**
+ * Unified Vite plugin for @mantajs/dashboard.
+ *
+ * Handles:
+ * 1. Menu config virtual module (virtual:dashboard/menu-config)
+ * 2. Component overrides — any file in src/admin/components/ overrides the
+ *    dashboard component with the same name.
+ */
+declare function customDashboardPlugin(): Plugin;
+declare const menuConfigPlugin: typeof customDashboardPlugin;
 
-export { type MenuConfig, type MenuItem, type MenuNestedItem, menuConfigPlugin };
+export { type MenuConfig, type MenuItem, type MenuNestedItem, customDashboardPlugin, menuConfigPlugin };

package/dist/vite-plugin/index.d.ts

@@ -17,6 +17,15 @@ type MenuConfig = {
     items: MenuItem[];
 };
 
-declare function menuConfigPlugin(): Plugin;
+/**
+ * Unified Vite plugin for @mantajs/dashboard.
+ *
+ * Handles:
+ * 1. Menu config virtual module (virtual:dashboard/menu-config)
+ * 2. Component overrides — any file in src/admin/components/ overrides the
+ *    dashboard component with the same name.
+ */
+declare function customDashboardPlugin(): Plugin;
+declare const menuConfigPlugin: typeof customDashboardPlugin;
 
-export { type MenuConfig, type MenuItem, type MenuNestedItem, menuConfigPlugin };
+export { type MenuConfig, type MenuItem, type MenuNestedItem, customDashboardPlugin, menuConfigPlugin };

package/dist/vite-plugin/index.js

@@ -30,30 +30,104 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/vite-plugin/index.ts
 var index_exports = {};
 __export(index_exports, {
+  customDashboardPlugin: () => customDashboardPlugin,
   menuConfigPlugin: () => menuConfigPlugin
 });
 module.exports = __toCommonJS(index_exports);
 var import_path = __toESM(require("path"));
 var import_fs = __toESM(require("fs"));
-var VIRTUAL_MODULE_ID = "virtual:dashboard/menu-config";
-var RESOLVED_ID = "\0" + VIRTUAL_MODULE_ID;
-function menuConfigPlugin() {
+var MENU_VIRTUAL_ID = "virtual:dashboard/menu-config";
+var MENU_RESOLVED_ID = "\0" + MENU_VIRTUAL_ID;
+var COMPONENT_EXTENSIONS = [".tsx", ".ts", ".jsx", ".js", ".mts", ".mjs"];
+function getComponentName(filePath) {
+  const normalized = filePath.replace(/\\/g, "/");
+  const parts = normalized.split("/");
+  const fileName = parts[parts.length - 1];
+  const baseName = fileName.replace(/\.(tsx?|jsx?|mts|mjs)$/, "");
+  if (baseName === "index") {
+    return parts.length >= 2 ? parts[parts.length - 2] : null;
+  }
+  if (parts.length >= 2 && baseName === parts[parts.length - 2]) {
+    return baseName;
+  }
+  return baseName;
+}
+function customDashboardPlugin() {
+  const componentsDir = import_path.default.resolve(process.cwd(), "src/admin/components");
+  const overridesByName = /* @__PURE__ */ new Map();
+  if (import_fs.default.existsSync(componentsDir)) {
+    for (const file of import_fs.default.readdirSync(componentsDir)) {
+      const fullPath = import_path.default.resolve(componentsDir, file);
+      if (!import_fs.default.statSync(fullPath).isFile()) continue;
+      const name = file.replace(/\.(tsx?|jsx?|mts|mjs)$/, "");
+      overridesByName.set(name, fullPath);
+    }
+  }
+  const hasOverrides = overridesByName.size > 0;
+  if (hasOverrides) {
+    console.log("[custom-dashboard] overrides:", [...overridesByName.keys()]);
+  }
   return {
-    name: "dashboard-menu-config",
-    config() {
-      return {
-        optimizeDeps: {
-          exclude: [VIRTUAL_MODULE_ID]
-        }
-      };
+    name: "custom-dashboard",
+    enforce: "pre",
+    config(config) {
+      config.optimizeDeps = config.optimizeDeps || {};
+      config.optimizeDeps.exclude = config.optimizeDeps.exclude || [];
+      config.optimizeDeps.exclude.push(MENU_VIRTUAL_ID);
+      if (hasOverrides) {
+        config.optimizeDeps.esbuildOptions = config.optimizeDeps.esbuildOptions || {};
+        config.optimizeDeps.esbuildOptions.plugins = config.optimizeDeps.esbuildOptions.plugins || [];
+        const overrides = overridesByName;
+        config.optimizeDeps.esbuildOptions.plugins.push({
+          name: "dashboard-component-overrides",
+          setup(build) {
+            build.onLoad({ filter: /app\.(mjs|js)$/ }, (args) => {
+              const normalized = args.path.replace(/\\/g, "/");
+              if (!normalized.includes("/dashboard/dist/")) return void 0;
+              const srcEntry = args.path.replace(/\/dist\/app\.(mjs|js)$/, "/src/app.tsx");
+              if (!import_fs.default.existsSync(srcEntry)) return void 0;
+              console.log(
+                `[custom-dashboard] Redirecting entry: ${args.path} \u2192 ${srcEntry}`
+              );
+              return {
+                contents: import_fs.default.readFileSync(srcEntry, "utf-8"),
+                loader: "tsx",
+                resolveDir: import_path.default.dirname(srcEntry)
+              };
+            });
+            build.onLoad({ filter: /\.(tsx?|jsx?)$/ }, (args) => {
+              const normalized = args.path.replace(/\\/g, "/");
+              if (!normalized.includes("/dashboard/src/")) return void 0;
+              const fileName = import_path.default.basename(args.path);
+              if (fileName.startsWith("index.")) return void 0;
+              const componentName = getComponentName(args.path);
+              if (componentName && overrides.has(componentName)) {
+                const overridePath = overrides.get(componentName);
+                const ext = import_path.default.extname(overridePath).slice(1);
+                console.log(
+                  `[custom-dashboard] Override: ${componentName} \u2192 ${overridePath}`
+                );
+                return {
+                  contents: import_fs.default.readFileSync(overridePath, "utf-8"),
+                  loader: ext,
+                  resolveDir: import_path.default.dirname(overridePath)
+                };
+              }
+              return void 0;
+            });
+          }
+        });
+        config.optimizeDeps.force = true;
+      }
     },
-    resolveId(id) {
-      if (id === VIRTUAL_MODULE_ID) return RESOLVED_ID;
+    resolveId(source) {
+      if (source === MENU_VIRTUAL_ID) return MENU_RESOLVED_ID;
+      return null;
     },
     load(id) {
-      if (id !== RESOLVED_ID) return;
+      if (id !== MENU_RESOLVED_ID) return;
       const basePath = import_path.default.resolve(process.cwd(), "src/admin/menu.config");
-      for (const ext of [".tsx", ".ts", ".jsx", ".js", ".mts", ".mjs"]) {
+      for (const ext of COMPONENT_EXTENSIONS) {
         if (import_fs.default.existsSync(basePath + ext)) {
           return `export { default } from "${basePath + ext}"`;
         }
@@ -62,7 +136,9 @@ function menuConfigPlugin() {
     }
   };
 }
+var menuConfigPlugin = customDashboardPlugin;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  customDashboardPlugin,
   menuConfigPlugin
 });

package/dist/vite-plugin/index.mjs

@@ -1,25 +1,98 @@
 // src/vite-plugin/index.ts
 import path from "path";
 import fs from "fs";
-var VIRTUAL_MODULE_ID = "virtual:dashboard/menu-config";
-var RESOLVED_ID = "\0" + VIRTUAL_MODULE_ID;
-function menuConfigPlugin() {
+var MENU_VIRTUAL_ID = "virtual:dashboard/menu-config";
+var MENU_RESOLVED_ID = "\0" + MENU_VIRTUAL_ID;
+var COMPONENT_EXTENSIONS = [".tsx", ".ts", ".jsx", ".js", ".mts", ".mjs"];
+function getComponentName(filePath) {
+  const normalized = filePath.replace(/\\/g, "/");
+  const parts = normalized.split("/");
+  const fileName = parts[parts.length - 1];
+  const baseName = fileName.replace(/\.(tsx?|jsx?|mts|mjs)$/, "");
+  if (baseName === "index") {
+    return parts.length >= 2 ? parts[parts.length - 2] : null;
+  }
+  if (parts.length >= 2 && baseName === parts[parts.length - 2]) {
+    return baseName;
+  }
+  return baseName;
+}
+function customDashboardPlugin() {
+  const componentsDir = path.resolve(process.cwd(), "src/admin/components");
+  const overridesByName = /* @__PURE__ */ new Map();
+  if (fs.existsSync(componentsDir)) {
+    for (const file of fs.readdirSync(componentsDir)) {
+      const fullPath = path.resolve(componentsDir, file);
+      if (!fs.statSync(fullPath).isFile()) continue;
+      const name = file.replace(/\.(tsx?|jsx?|mts|mjs)$/, "");
+      overridesByName.set(name, fullPath);
+    }
+  }
+  const hasOverrides = overridesByName.size > 0;
+  if (hasOverrides) {
+    console.log("[custom-dashboard] overrides:", [...overridesByName.keys()]);
+  }
   return {
-    name: "dashboard-menu-config",
-    config() {
-      return {
-        optimizeDeps: {
-          exclude: [VIRTUAL_MODULE_ID]
-        }
-      };
+    name: "custom-dashboard",
+    enforce: "pre",
+    config(config) {
+      config.optimizeDeps = config.optimizeDeps || {};
+      config.optimizeDeps.exclude = config.optimizeDeps.exclude || [];
+      config.optimizeDeps.exclude.push(MENU_VIRTUAL_ID);
+      if (hasOverrides) {
+        config.optimizeDeps.esbuildOptions = config.optimizeDeps.esbuildOptions || {};
+        config.optimizeDeps.esbuildOptions.plugins = config.optimizeDeps.esbuildOptions.plugins || [];
+        const overrides = overridesByName;
+        config.optimizeDeps.esbuildOptions.plugins.push({
+          name: "dashboard-component-overrides",
+          setup(build) {
+            build.onLoad({ filter: /app\.(mjs|js)$/ }, (args) => {
+              const normalized = args.path.replace(/\\/g, "/");
+              if (!normalized.includes("/dashboard/dist/")) return void 0;
+              const srcEntry = args.path.replace(/\/dist\/app\.(mjs|js)$/, "/src/app.tsx");
+              if (!fs.existsSync(srcEntry)) return void 0;
+              console.log(
+                `[custom-dashboard] Redirecting entry: ${args.path} \u2192 ${srcEntry}`
+              );
+              return {
+                contents: fs.readFileSync(srcEntry, "utf-8"),
+                loader: "tsx",
+                resolveDir: path.dirname(srcEntry)
+              };
+            });
+            build.onLoad({ filter: /\.(tsx?|jsx?)$/ }, (args) => {
+              const normalized = args.path.replace(/\\/g, "/");
+              if (!normalized.includes("/dashboard/src/")) return void 0;
+              const fileName = path.basename(args.path);
+              if (fileName.startsWith("index.")) return void 0;
+              const componentName = getComponentName(args.path);
+              if (componentName && overrides.has(componentName)) {
+                const overridePath = overrides.get(componentName);
+                const ext = path.extname(overridePath).slice(1);
+                console.log(
+                  `[custom-dashboard] Override: ${componentName} \u2192 ${overridePath}`
+                );
+                return {
+                  contents: fs.readFileSync(overridePath, "utf-8"),
+                  loader: ext,
+                  resolveDir: path.dirname(overridePath)
+                };
+              }
+              return void 0;
+            });
+          }
+        });
+        config.optimizeDeps.force = true;
+      }
     },
-    resolveId(id) {
-      if (id === VIRTUAL_MODULE_ID) return RESOLVED_ID;
+    resolveId(source) {
+      if (source === MENU_VIRTUAL_ID) return MENU_RESOLVED_ID;
+      return null;
     },
     load(id) {
-      if (id !== RESOLVED_ID) return;
+      if (id !== MENU_RESOLVED_ID) return;
       const basePath = path.resolve(process.cwd(), "src/admin/menu.config");
-      for (const ext of [".tsx", ".ts", ".jsx", ".js", ".mts", ".mjs"]) {
+      for (const ext of COMPONENT_EXTENSIONS) {
         if (fs.existsSync(basePath + ext)) {
           return `export { default } from "${basePath + ext}"`;
         }
@@ -28,6 +101,8 @@ function menuConfigPlugin() {
     }
   };
 }
+var menuConfigPlugin = customDashboardPlugin;
 export {
+  customDashboardPlugin,
   menuConfigPlugin
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mantajs/dashboard",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "B2B Admin Dashboard for Medusa - Fork of @medusajs/dashboard",
   "scripts": {
     "dev": "vite",

package/src/components/layout/main-layout/main-layout.tsx

@@ -211,7 +211,7 @@ const useCoreRoutes = (): Omit<INavItem, "pathname">[] => {
     items: item.items?.map((sub) => ({
       label: sub.useTranslation ? t(sub.label) : sub.label,
       to: sub.to,
-    })),
+    })) ?? [],
   }))
 }
 
@@ -253,7 +253,7 @@ const CoreRouteSection = () => {
   menuItems.forEach((item) => {
     if (item.nested) {
       const route = coreRoutes.find((route) => route.to === item.nested)
-      if (route) {
+      if (route && !route.items?.some((existing) => existing.to === item.to)) {
         route.items?.push(item)
       }
     }

package/src/dashboard-app/routes/get-route.map.tsx

@@ -8,6 +8,7 @@ import { SettingsLayout } from "../../components/layout/settings-layout"
 import { ErrorBoundary } from "../../components/utilities/error-boundary"
 import { TaxRegionDetailBreadcrumb } from "../../routes/tax-regions/tax-region-detail/breadcrumb"
 import { taxRegionLoader } from "../../routes/tax-regions/tax-region-detail/loader"
+import { mergeExtensionRoutes } from "./merge-extension-routes"
 
 export function getRouteMap({
   settingsRoutes,
@@ -23,7 +24,7 @@ export function getRouteMap({
       children: [
         {
           element: <MainLayout />,
-          children: [
+          children: mergeExtensionRoutes([
             {
               path: "/",
               errorElement: <ErrorBoundary />,
@@ -918,8 +919,7 @@ export function getRouteMap({
                 },
               ],
             },
-            ...coreRoutes,
-          ],
+          ], coreRoutes),
         },
       ],
     },
@@ -933,7 +933,7 @@ export function getRouteMap({
             breadcrumb: () => t("app.nav.settings.header"),
           },
           element: <SettingsLayout />,
-          children: [
+          children: mergeExtensionRoutes([
             {
               index: true,
               errorElement: <ErrorBoundary />,
@@ -1877,8 +1877,7 @@ export function getRouteMap({
                 },
               ],
             },
-            ...(settingsRoutes?.[0]?.children || []),
-          ],
+          ], settingsRoutes?.[0]?.children || []),
         },
       ],
     },

package/src/dashboard-app/routes/merge-extension-routes.ts

@@ -0,0 +1,51 @@
+import { RouteObject } from "react-router-dom"
+
+/**
+ * Merges extension routes into static routes. When an extension route has the
+ * same path as a static route, the extension's component/lazy wins while
+ * static children that are not redefined by the extension are preserved.
+ */
+export function mergeExtensionRoutes(
+  staticRoutes: RouteObject[],
+  extensionRoutes: RouteObject[]
+): RouteObject[] {
+  if (!extensionRoutes.length) return staticRoutes
+
+  const result = [...staticRoutes]
+
+  for (const ext of extensionRoutes) {
+    const extPath = (ext.path ?? "").replace(/^\/+/, "")
+    const idx = result.findIndex(
+      (r) => (r.path ?? "").replace(/^\/+/, "") === extPath
+    )
+
+    if (idx === -1) {
+      result.push(ext)
+      continue
+    }
+
+    const existing = result[idx]
+    const merged = { ...existing }
+
+    // Extension component takes priority
+    if (ext.lazy) {
+      merged.lazy = ext.lazy
+      delete (merged as any).Component
+      delete (merged as any).loader
+    }
+
+    // Recursively merge children — static children not redefined by the
+    // extension are preserved (e.g. /orders/:id stays when only /orders ""
+    // is overridden).
+    if (ext.children || existing.children) {
+      merged.children = mergeExtensionRoutes(
+        existing.children || [],
+        ext.children || []
+      )
+    }
+
+    result[idx] = merged
+  }
+
+  return result
+}

package/src/vite-plugin/index.ts

@@ -2,26 +2,141 @@ import { Plugin } from "vite"
 import path from "path"
 import fs from "fs"
 
-const VIRTUAL_MODULE_ID = "virtual:dashboard/menu-config"
-const RESOLVED_ID = "\0" + VIRTUAL_MODULE_ID
+const MENU_VIRTUAL_ID = "virtual:dashboard/menu-config"
+const MENU_RESOLVED_ID = "\0" + MENU_VIRTUAL_ID
+
+const COMPONENT_EXTENSIONS = [".tsx", ".ts", ".jsx", ".js", ".mts", ".mjs"]
+
+/**
+ * Extract a component name from a resolved file path.
+ */
+function getComponentName(filePath: string): string | null {
+  const normalized = filePath.replace(/\\/g, "/")
+  const parts = normalized.split("/")
+  const fileName = parts[parts.length - 1]
+  const baseName = fileName.replace(/\.(tsx?|jsx?|mts|mjs)$/, "")
+
+  if (baseName === "index") {
+    return parts.length >= 2 ? parts[parts.length - 2] : null
+  }
+  if (parts.length >= 2 && baseName === parts[parts.length - 2]) {
+    return baseName
+  }
+  return baseName
+}
+
+/**
+ * Unified Vite plugin for @mantajs/dashboard.
+ *
+ * Handles:
+ * 1. Menu config virtual module (virtual:dashboard/menu-config)
+ * 2. Component overrides — any file in src/admin/components/ overrides the
+ *    dashboard component with the same name.
+ */
+export function customDashboardPlugin(): Plugin {
+  const componentsDir = path.resolve(process.cwd(), "src/admin/components")
+  const overridesByName = new Map<string, string>()
+
+  if (fs.existsSync(componentsDir)) {
+    for (const file of fs.readdirSync(componentsDir)) {
+      const fullPath = path.resolve(componentsDir, file)
+      if (!fs.statSync(fullPath).isFile()) continue
+      const name = file.replace(/\.(tsx?|jsx?|mts|mjs)$/, "")
+      overridesByName.set(name, fullPath)
+    }
+  }
+
+  const hasOverrides = overridesByName.size > 0
+
+  if (hasOverrides) {
+    console.log("[custom-dashboard] overrides:", [...overridesByName.keys()])
+  }
 
-export function menuConfigPlugin(): Plugin {
   return {
-    name: "dashboard-menu-config",
-    config() {
-      return {
-        optimizeDeps: {
-          exclude: [VIRTUAL_MODULE_ID],
-        },
+    name: "custom-dashboard",
+    enforce: "pre",
+
+    config(config) {
+      // Always exclude the menu virtual module
+      config.optimizeDeps = config.optimizeDeps || {}
+      config.optimizeDeps.exclude = config.optimizeDeps.exclude || []
+      config.optimizeDeps.exclude.push(MENU_VIRTUAL_ID)
+
+      if (hasOverrides) {
+        // Strategy: the package.json points to dist/app.mjs (so the browser
+        // gets a working pre-bundled chunk — no blank page).  But during
+        // esbuild pre-bundling we redirect the dist entry to the source TSX
+        // via onLoad, so esbuild follows individual imports and we can swap
+        // component files with the user's overrides.
+        config.optimizeDeps.esbuildOptions = config.optimizeDeps.esbuildOptions || {}
+        config.optimizeDeps.esbuildOptions.plugins =
+          config.optimizeDeps.esbuildOptions.plugins || []
+
+        const overrides = overridesByName
+        config.optimizeDeps.esbuildOptions.plugins.push({
+          name: "dashboard-component-overrides",
+          setup(build) {
+            // 1. Redirect the dist entry to source so esbuild processes
+            //    individual TSX files instead of one big pre-built bundle.
+            build.onLoad({ filter: /app\.(mjs|js)$/ }, (args) => {
+              const normalized = args.path.replace(/\\/g, "/")
+              if (!normalized.includes("/dashboard/dist/")) return undefined
+
+              const srcEntry = args.path
+                .replace(/\/dist\/app\.(mjs|js)$/, "/src/app.tsx")
+              if (!fs.existsSync(srcEntry)) return undefined
+
+              console.log(
+                `[custom-dashboard] Redirecting entry: ${args.path} → ${srcEntry}`
+              )
+              return {
+                contents: fs.readFileSync(srcEntry, "utf-8"),
+                loader: "tsx",
+                resolveDir: path.dirname(srcEntry),
+              }
+            })
+
+            // 2. Intercept individual source files to swap with overrides.
+            build.onLoad({ filter: /\.(tsx?|jsx?)$/ }, (args) => {
+              const normalized = args.path.replace(/\\/g, "/")
+              if (!normalized.includes("/dashboard/src/")) return undefined
+
+              // Skip index/barrel files to preserve re-exports
+              const fileName = path.basename(args.path)
+              if (fileName.startsWith("index.")) return undefined
+
+              const componentName = getComponentName(args.path)
+              if (componentName && overrides.has(componentName)) {
+                const overridePath = overrides.get(componentName)!
+                const ext = path.extname(overridePath).slice(1)
+                console.log(
+                  `[custom-dashboard] Override: ${componentName} → ${overridePath}`
+                )
+                return {
+                  contents: fs.readFileSync(overridePath, "utf-8"),
+                  loader: ext as any,
+                  resolveDir: path.dirname(overridePath),
+                }
+              }
+              return undefined
+            })
+          },
+        })
+
+        // Force re-optimisation so overrides are always applied
+        config.optimizeDeps.force = true
       }
     },
-    resolveId(id) {
-      if (id === VIRTUAL_MODULE_ID) return RESOLVED_ID
+
+    resolveId(source) {
+      if (source === MENU_VIRTUAL_ID) return MENU_RESOLVED_ID
+      return null
     },
+
     load(id) {
-      if (id !== RESOLVED_ID) return
+      if (id !== MENU_RESOLVED_ID) return
       const basePath = path.resolve(process.cwd(), "src/admin/menu.config")
-      for (const ext of [".tsx", ".ts", ".jsx", ".js", ".mts", ".mjs"]) {
+      for (const ext of COMPONENT_EXTENSIONS) {
         if (fs.existsSync(basePath + ext)) {
           return `export { default } from "${basePath + ext}"`
         }
@@ -31,4 +146,7 @@ export function menuConfigPlugin(): Plugin {
   }
 }
 
+// Keep backward-compatible alias
+export const menuConfigPlugin = customDashboardPlugin
+
 export type { MenuConfig, MenuItem, MenuNestedItem } from "./types"