remove base path URL in docs (#2375)

Author: MarcusSorealheis

web/apps/docs/app/layout.config.tsx

@@ -3,16 +3,12 @@ import type { BaseLayoutProps } from "fumadocs-ui/layouts/shared";
 
 export const baseOptions: BaseLayoutProps = {
   nav: {
-    // basePath="/docs" so the logo SVG resolves under the docs server's
-    // basePath. Without this, <img src="/logo-light.svg"> 404s when the
-    // docs app is hit directly.
-    title: <Logo size="md" basePath="/docs" />,
+    title: <Logo size="md" />,
     url: "/",
     transparentMode: "top",
   },
   // Only the GitHub icon in the top-nav. Cross-app links back to marketing
-  // (/product, /pricing, /resources) were removed — they 404'd inside the
-  // docs basePath and clutter a docs-focused nav.
+  // (/product, /pricing, /resources) clutter a docs-focused nav.
   links: [
     {
       type: "icon",

web/apps/docs/app/layout.tsx

@@ -1,10 +1,10 @@
+import { source } from "@/lib/source";
+import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import { RootProvider } from "fumadocs-ui/provider";
 import { GeistMono } from "geist/font/mono";
 import { GeistSans } from "geist/font/sans";
 import type { Metadata } from "next";
 import type { ReactNode } from "react";
-import { DocsLayout } from "fumadocs-ui/layouts/docs";
-import { source } from "@/lib/source";
 import { baseOptions } from "./layout.config";
 import "./globals.css";
 
@@ -13,9 +13,8 @@ export const metadata: Metadata = {
     default: "NativeLink Docs",
     template: "%s — NativeLink Docs",
   },
-  description:
-    "Documentation for NativeLink — high-performance remote build cache & execution.",
-  metadataBase: new URL("https://nativelink.com"),
+  description: "Documentation for NativeLink — high-performance remote build cache & execution.",
+  metadataBase: new URL("https://docs.nativelink.com"),
 };
 
 export default function RootLayout({ children }: { children: ReactNode }) {
@@ -41,7 +40,7 @@ export default function RootLayout({ children }: { children: ReactNode }) {
             enableSystem: true,
             storageKey: "nl-theme",
           }}
-          search={{ options: { api: "/docs/api/search" } }}
+          search={{ options: { api: "/api/search" } }}
         >
           <DocsLayout tree={source.pageTree} {...baseOptions}>
             {children}

web/apps/docs/app/sitemap.ts

@@ -1,14 +1,14 @@
-import type { MetadataRoute } from "next";
 import { source } from "@/lib/source";
+import type { MetadataRoute } from "next";
 
-const BASE_URL = "https://nativelink.com";
+const BASE_URL = "https://docs.nativelink.com";
 
 export default function sitemap(): MetadataRoute.Sitemap {
   const lastModified = new Date();
   return source.getPages().map((page) => ({
     url: `${BASE_URL}${page.url}`,
     lastModified,
     changeFrequency: "weekly" as const,
-    priority: page.url === "/docs" ? 0.9 : 0.6,
+    priority: page.url === "/" ? 0.9 : 0.6,
   }));
 }

web/apps/docs/lib/source.ts

@@ -1,10 +1,6 @@
 import { docs } from "@/.source";
 import { loader } from "fumadocs-core/source";
 
-// baseUrl is "/" because Next.js basePath ("/docs") prepends to every
-// next/link href automatically. If we put "/docs" here as well, the
-// sidebar would emit /docs/foo and next/link would double-prefix it to
-// /docs/docs/foo.
 export const source = loader({
   baseUrl: "/",
   source: docs.toFumadocsSource(),

web/apps/docs/next.config.mjs

@@ -5,11 +5,6 @@ const withMDX = createMDX();
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   reactStrictMode: true,
-  // Docs ship under /docs. With basePath set, every internal Next.js link
-  // and every emitted asset URL (/_next/static/*) is automatically
-  // prefixed — which is what makes the marketing dev rewrite work for
-  // both pages and assets in one rule.
-  basePath: "/docs",
   transpilePackages: ["@nativelink/ui"],
 };
 

web/apps/web/next.config.mjs

@@ -8,25 +8,24 @@ const nextConfig = {
       { protocol: "https", hostname: "github.com" },
     ],
   },
-  // Marketing serves the apex; the docs app lives at /docs/* and is a
-  // separate Vercel deployment. We proxy here so /docs URLs stay on the
-  // marketing origin (SEO, cookies, one set of analytics).
+  // Marketing serves the apex; the docs app lives on docs.nativelink.com.
+  // Redirect /docs links there so old URLs and local nav links keep working.
   //
   //   Production: target is process.env.DOCS_URL (set on Vercel).
   //   Development: target is process.env.DOCS_DEV_URL or localhost:3001.
-  async rewrites() {
+  async redirects() {
     const target =
       process.env.NODE_ENV === "production"
         ? process.env.DOCS_URL
         : (process.env.DOCS_DEV_URL ?? "http://localhost:3001");
 
-    // If we're in production and DOCS_URL isn't set, skip the rewrite
-    // entirely — better to 404 cleanly than to proxy to nothing.
+    // If we're in production and DOCS_URL isn't set, skip the redirect
+    // entirely — better to 404 cleanly than to redirect to nothing.
     if (!target) return [];
 
     return [
-      { source: "/docs", destination: `${target}/docs` },
-      { source: "/docs/:path*", destination: `${target}/docs/:path*` },
+      { source: "/docs", destination: target, permanent: false },
+      { source: "/docs/:path*", destination: `${target}/:path*`, permanent: false },
     ];
   },
 };