Migrate docs app to Geistdocs canary

apps/docs/.env.example

@@ -1,5 +1,12 @@
 # AI Gateway API Key (optional - for AI chat)
 AI_GATEWAY_API_KEY=""
 
+# Optional central Geistdocs chat proxy. When set, this is used instead of AI Gateway.
+GEISTDOCS_CHAT_PROXY_URL=""
+GEISTDOCS_CHAT_PROXY_TOKEN=""
+
 # Production URL (automatically set on Vercel)
-NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL="localhost:3000"
+NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL="localhost:3000"
+
+# Required for precomputed feature flag URLs
+FLAGS_SECRET="AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="

apps/docs/app/[lang]/agents.md/route.ts

@@ -0,0 +1,10 @@
+import { createAgentsRoute } from '@vercel/geistdocs/routes/agents';
+import { config } from '@/lib/geistdocs/config';
+
+const agentsRoute = createAgentsRoute({
+  config,
+});
+
+export const GET = agentsRoute.GET;
+export const generateStaticParams = agentsRoute.generateStaticParams;
+export const revalidate = false;

apps/docs/app/[lang]/docs/[[...slug]]/page.tsx

@@ -1,106 +1,35 @@
-import { createRelativeLink } from "fumadocs-ui/mdx";
-import type { Metadata } from "next";
-import { notFound } from "next/navigation";
-import { AskAI } from "@/components/geistdocs/ask-ai";
-import { CopyPage } from "@/components/geistdocs/copy-page";
-import {
-  DocsBody,
-  DocsDescription,
-  DocsPage,
-  DocsTitle,
-} from "@/components/geistdocs/docs-page";
-import { EditSource } from "@/components/geistdocs/edit-source";
-import { Feedback } from "@/components/geistdocs/feedback";
+import { MobileDocsBar } from "@vercel/geistdocs/mobile-docs-bar";
+import { createDocsPage } from "@vercel/geistdocs/pages/docs";
 import { getMDXComponents } from "@/components/geistdocs/mdx-components";
-import { MobileDocsBar } from "@/components/geistdocs/mobile-docs-bar";
-import { OpenInChat } from "@/components/geistdocs/open-in-chat";
-import { ScrollTop } from "@/components/geistdocs/scroll-top";
-import { Separator } from "@/components/ui/separator";
-import { getLLMText, getPageImage, source } from "@/lib/geistdocs/source";
 import { IframeBrowser } from "@/components/custom/iframe-browser";
 import { LearnMore } from "@/components/custom/learn-more";
 import { ProviderList } from "@/components/custom/provider-list";
 import { ThemeAwareImage } from "@/components/custom/theme-aware-image";
+import { config } from "@/lib/geistdocs/config";
+import { geistdocsSource } from "@/lib/geistdocs/source";
 import { ExternalLinkIcon } from "lucide-react";
 
-const Page = async ({ params }: PageProps<"/[lang]/docs/[[...slug]]">) => {
-  const { slug, lang } = await params;
-  const page = source.getPage(slug, lang);
-
-  if (!page) {
-    notFound();
-  }
-
-  const markdown = await getLLMText(page);
-  const MDX = page.data.body;
-
-  return (
-    <DocsPage
-      full={page.data.full}
-      tableOfContent={{
-        style: "clerk",
-        footer: (
-          <div className="my-3 space-y-3">
-            <Separator />
-            <EditSource path={page.path} />
-            <ScrollTop />
-            <Feedback />
-            <CopyPage text={markdown} />
-            <AskAI href={page.url} />
-            <OpenInChat href={page.url} />
-          </div>
-        ),
-      }}
-      tableOfContentPopover={{ enabled: false }}
-      toc={page.data.toc}
-    >
-      <MobileDocsBar toc={page.data.toc} />
-      <DocsTitle>{page.data.title}</DocsTitle>
-      <DocsDescription>{page.data.description}</DocsDescription>
-      <DocsBody>
-        <MDX
-          components={getMDXComponents({
-            a: createRelativeLink(source, page),
-
-            // Add your custom components here
-            IframeBrowser,
-            LearnMore,
-            ProviderList,
-            ThemeAwareImage,
-            ExternalSmall: ExternalLinkIcon,
-          })}
-        />
-      </DocsBody>
-    </DocsPage>
-  );
-};
-
-export const generateStaticParams = () => source.generateParams();
-
-export const generateMetadata = async ({
-  params,
-}: PageProps<"/[lang]/docs/[[...slug]]">) => {
-  const { slug, lang } = await params;
-  const page = source.getPage(slug, lang);
-
-  if (!page) {
-    notFound();
-  }
-
-  const metadata: Metadata = {
-    title: page.data.title,
-    description: page.data.description,
-    openGraph: {
-      images: getPageImage(page).url,
-    },
-    alternates: {
-      types: {
-        "text/markdown": slug ? `/docs/${slug}.md` : "/docs.md",
-      },
-    },
-  };
-
-  return metadata;
-};
-
-export default Page;
+const docsPage = createDocsPage({
+  config,
+  mdx: ({ link }) =>
+    getMDXComponents({
+      a: link,
+      IframeBrowser,
+      LearnMore,
+      ProviderList,
+      ThemeAwareImage,
+      ExternalSmall: ExternalLinkIcon,
+    }),
+  openGraph: {
+    images: true,
+  },
+  source: geistdocsSource,
+  tableOfContentPopover: {
+    enabled: false,
+  },
+  renderTop: ({ data }) => <MobileDocsBar toc={data.toc} />,
+});
+
+export default docsPage.Page;
+export const generateStaticParams = docsPage.generateStaticParams;
+export const generateMetadata = docsPage.generateMetadata;

apps/docs/app/[lang]/home/[code]/page.tsx

@@ -1,9 +1,9 @@
+import { Button } from '@vercel/geistdocs/components/button';
 import { generatePermutations } from 'flags/next';
 import { FlagValues } from 'flags/react';
 import { ArrowRight } from 'lucide-react';
 import type { Metadata } from 'next';
 import Link from 'next/link';
-import { Button } from '@/components/ui/button';
 import {
   enableBannerFlag,
   enableDitheredHeroFlag,

apps/docs/app/[lang]/layout.tsx

@@ -1,20 +1,19 @@
 import "../global.css";
+import { Footer } from "@vercel/geistdocs/footer";
+import { Navbar } from "@vercel/geistdocs/navbar";
 import { VercelToolbar } from "@vercel/toolbar/next";
-import { Footer } from "@/components/geistdocs/footer";
-import { Navbar } from "@/components/geistdocs/navbar";
 import { GeistdocsProvider } from "@/components/geistdocs/provider";
-import { basePath } from "@/geistdocs";
+import { config } from "@/lib/geistdocs/config";
 import { mono, sans } from "@/lib/geistdocs/fonts";
 import { cn } from "@/lib/utils";
-import { translations } from "@/geistdocs";
 import type { Metadata } from "next";
 
 export const metadata: Metadata = {
   metadataBase: new URL("https://flags-sdk.dev"),
 };
 
 export const generateStaticParams = async () => {
-  const langs = Object.keys(translations);
+  const langs = Object.keys(config.translations ?? {});
   return langs.map((lang) => ({ lang }));
 };
 
@@ -29,11 +28,11 @@ const Layout = async ({ children, params }: LayoutProps<"/[lang]">) => {
       suppressHydrationWarning
     >
       <body>
-        <GeistdocsProvider basePath={basePath} lang={lang}>
-          <Navbar />
+        <GeistdocsProvider basePath={config.basePath} lang={lang}>
+          <Navbar config={config} />
           {children}
           {shouldInjectToolbar && <VercelToolbar />}
-          <Footer />
+          <Footer config={config} />
         </GeistdocsProvider>
       </body>
     </html>

apps/docs/app/[lang]/llms.mdx/[[...slug]]/route.ts

@@ -1,30 +1,10 @@
-import { notFound } from "next/navigation";
-import { getLLMText, source } from "@/lib/geistdocs/source";
+import { createDocsMarkdownRoute } from "@vercel/geistdocs/routes/llms";
+import { geistdocsSource } from "@/lib/geistdocs/source";
 
-export const revalidate = false;
-
-export async function GET(
-  _req: Request,
-  { params }: RouteContext<"/[lang]/llms.mdx/[[...slug]]">
-) {
-  const { slug, lang } = await params;
-  const page = source.getPage(slug, lang);
-
-  if (!page) {
-    notFound();
-  }
+const docsMarkdownRoute = createDocsMarkdownRoute({
+  source: geistdocsSource,
+});
 
-  return new Response(await getLLMText(page), {
-    headers: {
-      "Content-Type": "text/markdown",
-    },
-  });
-}
-
-export const generateStaticParams = async ({
-  params,
-}: RouteContext<"/[lang]/llms.mdx/[[...slug]]">) => {
-  const { lang } = await params;
-
-  return source.generateParams(lang);
-};
+export const GET = docsMarkdownRoute.GET;
+export const generateStaticParams = docsMarkdownRoute.generateStaticParams;
+export const revalidate = false;

apps/docs/app/[lang]/llms.txt/route.ts

@@ -1,26 +1,16 @@
-import type { NextRequest } from "next/server";
-import { getLLMText, source } from "@/lib/geistdocs/source";
-import { translations } from "@/geistdocs";
+import { createLlmsRoute } from "@vercel/geistdocs/routes/llms";
+import { config } from "@/lib/geistdocs/config";
+import { geistdocsSource } from "@/lib/geistdocs/source";
 
-export const revalidate = false;
+const llmsRoute = createLlmsRoute({
+  source: geistdocsSource,
+});
 
 export const dynamicParams = false;
-export const generateStaticParams = async () => {
-  const langs = Object.keys(translations);
+export const generateStaticParams = () => {
+  const langs = Object.keys(config.translations ?? {});
   return langs.map((lang) => ({ lang }));
 };
 
-export const GET = async (
-  _req: NextRequest,
-  { params }: RouteContext<"/[lang]/llms.txt">
-) => {
-  const { lang } = await params;
-  const scan = source.getPages(lang).map(getLLMText);
-  const scanned = await Promise.all(scan);
-
-  return new Response(scanned.join("\n\n"), {
-    headers: {
-      "Content-Type": "text/markdown; charset=utf-8",
-    },
-  });
-};
+export const GET = llmsRoute.GET;
+export const revalidate = false;

apps/docs/app/[lang]/rss.xml/route.ts

@@ -31,7 +31,7 @@ export const GET = async (
   for (const page of source.getPages(lang)) {
     feed.addItem({
       id: page.url,
-      title: page.data.title,
+      title: page.data.title ?? page.url,
       description: page.data.description,
       link: `${baseUrl}${page.url}`,
       date: new Date(),