fix: Force trailing slashes at all levels for MkDocs CSS compatibility

- Add trailingSlash: true to vercel.json for edge-level enforcement
- Add explicit redirect rule in vercel.json for framework-docs paths
- Set trailingSlash: true in next.config.ts
- Update middleware to handle all framework-docs paths consistently

Author: GeneAI

website/middleware.ts

@@ -4,18 +4,28 @@ import type { NextRequest } from 'next/server';
 export function middleware(request: NextRequest) {
   const pathname = request.nextUrl.pathname;
 
-  // Add trailing slash to framework-docs paths (except for files with extensions)
-  if (pathname.startsWith('/framework-docs/') &&
-      !pathname.endsWith('/') &&
-      !pathname.match(/\.[a-zA-Z0-9]+$/)) {
-    const url = request.nextUrl.clone();
-    url.pathname = pathname + '/';
-    return NextResponse.redirect(url, 308);
+  // Handle framework-docs paths - ensure trailing slash for MkDocs relative paths
+  if (pathname.startsWith('/framework-docs')) {
+    // Skip files with extensions (CSS, JS, images, etc.)
+    if (pathname.match(/\.[a-zA-Z0-9]+$/)) {
+      return NextResponse.next();
+    }
+
+    // Add trailing slash if missing
+    if (!pathname.endsWith('/')) {
+      const url = request.nextUrl.clone();
+      url.pathname = pathname + '/';
+      return NextResponse.redirect(url, 308);
+    }
   }
 
   return NextResponse.next();
 }
 
 export const config = {
-  matcher: '/framework-docs/:path*',
+  // Match all framework-docs paths
+  matcher: [
+    '/framework-docs',
+    '/framework-docs/:path*',
+  ],
 };

website/next.config.ts

@@ -4,7 +4,7 @@ import path from "path";
 const nextConfig: NextConfig = {
   output: 'standalone',
   outputFileTracingRoot: path.join(__dirname, './'),
-  skipTrailingSlashRedirect: true,  // Don't auto-redirect trailing slashes - let middleware handle it
+  trailingSlash: true,  // Force trailing slashes for MkDocs compatibility
   eslint: {
     // Only run ESLint on these directories during production builds
     dirs: ['app'],

website/vercel.json

@@ -1,4 +1,12 @@
 {
+  "trailingSlash": true,
+  "redirects": [
+    {
+      "source": "/framework-docs/:path((?!.*\\.).*[^/])",
+      "destination": "/framework-docs/:path/",
+      "permanent": true
+    }
+  ],
   "headers": [
     {
       "source": "/framework-docs/(.*)",