feat(showcase/shell): add 301 redirects from /docs /ag-ui /reference /[framework] to docs.showcase.copilotkit.ai

Shell no longer hosts MDX docs routes — they live on shell-docs
(docs.showcase.copilotkit.ai). Add permanent redirects from the legacy
shell paths so old URLs and SEO authority carry over to the new host.

Framework slugs are enumerated from registry.json at build time (not a
:slug* wildcard) so /integrations and /matrix — both still owned by
shell — are NOT caught by the redirect. Fixed routes (/docs, /ag-ui,
/reference) cover the three other docs catch-alls.

Author: jpr5

showcase/shell/next.config.ts

@@ -20,13 +20,88 @@ function localBackendsEnv(): string {
   return JSON.stringify(map);
 }
 
+// Read registry to get the list of framework slugs owned by the docs
+// shell. Any path whose first segment is a framework slug must 301 to
+// docs.showcase.copilotkit.ai. This list is derived at build time so
+// the redirect table tracks registry changes automatically — no manual
+// sync between next.config.ts and the docs shell's ownership list.
+function frameworkSlugs(): string[] {
+  const registryPath = path.resolve(__dirname, "src", "data", "registry.json");
+  if (!fs.existsSync(registryPath)) return [];
+  try {
+    const registry = JSON.parse(fs.readFileSync(registryPath, "utf-8")) as {
+      integrations?: { slug: string }[];
+    };
+    return (registry.integrations ?? []).map((i) => i.slug);
+  } catch {
+    return [];
+  }
+}
+
+const DOCS_HOST = "https://docs.showcase.copilotkit.ai";
+
 const nextConfig: NextConfig = {
   env: {
     NEXT_PUBLIC_BASE_URL:
       process.env.NEXT_PUBLIC_BASE_URL || "http://localhost:3000",
     NEXT_PUBLIC_LOCAL_BACKENDS: localBackendsEnv(),
   },
   serverExternalPackages: ["@copilotkit/runtime", "@copilotkitnext/runtime"],
+  async redirects() {
+    const slugs = frameworkSlugs();
+    // Fixed docs-route redirects — whole sections (docs, ag-ui, reference)
+    // now live on docs.showcase.copilotkit.ai. Use 301 (permanent) so
+    // search engines carry authority over to the new host.
+    const fixed = [
+      {
+        source: "/docs",
+        destination: `${DOCS_HOST}`,
+        permanent: true,
+      },
+      {
+        source: "/docs/:path*",
+        destination: `${DOCS_HOST}/:path*`,
+        permanent: true,
+      },
+      {
+        source: "/ag-ui",
+        destination: `${DOCS_HOST}/ag-ui`,
+        permanent: true,
+      },
+      {
+        source: "/ag-ui/:path*",
+        destination: `${DOCS_HOST}/ag-ui/:path*`,
+        permanent: true,
+      },
+      {
+        source: "/reference",
+        destination: `${DOCS_HOST}/reference`,
+        permanent: true,
+      },
+      {
+        source: "/reference/:path*",
+        destination: `${DOCS_HOST}/reference/:path*`,
+        permanent: true,
+      },
+    ];
+    // Framework-scoped routes — /<slug> and /<slug>/... both go to the
+    // docs host. Enumerated from registry rather than a `:slug*` wildcard
+    // so we DON'T blanket-redirect /integrations or /matrix (which are
+    // owned by shell).
+    const frameworkRedirects = slugs.flatMap((slug) => [
+      {
+        source: `/${slug}`,
+        destination: `${DOCS_HOST}/${slug}`,
+        permanent: true,
+      },
+      {
+        source: `/${slug}/:path*`,
+        destination: `${DOCS_HOST}/${slug}/:path*`,
+        permanent: true,
+      },
+    ]);
+    return [...fixed, ...frameworkRedirects];
+  },
 };
 
 export default nextConfig;