diff --git a/apps/docs/middleware.ts b/apps/docs/middleware.ts
new file mode 100644
index 0000000..a3df506
--- /dev/null
+++ b/apps/docs/middleware.ts
@@ -0,0 +1,26 @@
+import type { NextRequest } from "next/server";
+import { NextResponse } from "next/server";
+
+/**
+ * Browsers or other localhost apps (e.g. MSW) may request `/mockServiceWorker.js`.
+ * Without this, the request hits `[[...mdxPath]]` and Nextra tries to load it as MDX.
+ */
+export function middleware(request: NextRequest) {
+  if (request.nextUrl.pathname === "/mockServiceWorker.js") {
+    return new NextResponse(
+      "// antd-admin docs: no MSW; unregister stray workers from other localhost apps if needed.\n",
+      {
+        status: 200,
+        headers: {
+          "content-type": "application/javascript; charset=utf-8",
+          "cache-control": "no-store",
+        },
+      },
+    );
+  }
+  return NextResponse.next();
+}
+
+export const config = {
+  matcher: "/mockServiceWorker.js",
+};