@mantajs/dashboard 0.1.10 → 0.1.12

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+declare function App(props: {
+  plugins?: any[]
+}): JSX.Element
+
+export default App
+
+import type enTranslation from "./en.json"
+export type Resources = {
+  translation: typeof enTranslation
+}

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

@@ -0,0 +1,31 @@
+import { Plugin } from 'vite';
+import { ReactNode } from 'react';
+
+type MenuNestedItem = {
+    label: string;
+    to: string;
+    useTranslation?: boolean;
+};
+type MenuItem = {
+    icon: ReactNode;
+    label: string;
+    to: string;
+    useTranslation?: boolean;
+    items?: MenuNestedItem[];
+};
+type MenuConfig = {
+    items: MenuItem[];
+};
+
+/**
+ * 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, customDashboardPlugin, menuConfigPlugin };

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

@@ -0,0 +1,31 @@
+import { Plugin } from 'vite';
+import { ReactNode } from 'react';
+
+type MenuNestedItem = {
+    label: string;
+    to: string;
+    useTranslation?: boolean;
+};
+type MenuItem = {
+    icon: ReactNode;
+    label: string;
+    to: string;
+    useTranslation?: boolean;
+    items?: MenuNestedItem[];
+};
+type MenuConfig = {
+    items: MenuItem[];
+};
+
+/**
+ * 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, 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.10",
+  "version": "0.1.12",
   "description": "B2B Admin Dashboard for Medusa - Fork of @medusajs/dashboard",
   "scripts": {
     "dev": "vite",
@@ -84,6 +84,7 @@
     "@medusajs/types": "2.13.1",
     "@medusajs/ui-preset": "2.13.1",
     "@types/node": "^20.0.0",
+    "@types/react": "^19.2.13",
     "@vitejs/plugin-react": "^4.0.0",
     "autoprefixer": "^10.4.16",
     "postcss": "^8.4.31",

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"