cache control headers

kennyderek · kennyderek · commit ad52193ac044 · 2025-11-25T13:47:56.000-05:00
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@announcement/[slug]/page.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@announcement/[slug]/page.tsx
@@ -10,7 +10,7 @@ import { Announcement } from "@/components/header/Announcement";
 import { MdxServerComponent } from "@/mdx/components/server-component";
 import { createCachedMdxSerializer } from "@/server/mdx-serializer";
 
-export const revalidate = 900;
+export const revalidate = false;
 
 export default async function AnnouncementPage({
     params
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@explorer/@sidebar/[slug]/page.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@explorer/@sidebar/[slug]/page.tsx
@@ -8,7 +8,7 @@ import { slugjoin } from "@fern-api/fdr-sdk/navigation";
 import { PlaygroundEndpointSelectorContent } from "@/components/playground/endpoint/PlaygroundEndpointSelectorContent";
 import { flattenApiSection } from "@/components/playground/utils/flatten-apis";
 
-export const revalidate = 900;
+export const revalidate = false;
 
 export default async function EndpointSelectorPage({
     params
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@explorer/[slug]/page.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@explorer/[slug]/page.tsx
@@ -15,7 +15,7 @@ import { Suspense } from "react";
 import { ExplorerContent, NoEndpointSelected } from "@/components/playground/ExplorerContent";
 import { PlaygroundEndpointSkeleton } from "@/components/playground/endpoint";
 
-export const revalidate = 900;
+export const revalidate = false;
 
 export default async function ExplorerPage({
     params
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@explorer/layout.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@explorer/layout.tsx
@@ -2,8 +2,6 @@ import { InterceptedPlaygroundCloseButton } from "@/components/playground/Playgr
 import { PlaygroundDrawer } from "@/components/playground/PlaygroundDrawer";
 import { HorizontalSplitPane } from "@/components/playground/VerticalSplitPane";
 
-export const revalidate = 900;
-
 export default async function ExplorerLayout({
     children,
     sidebar
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@headertabs/[slug]/page.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@headertabs/[slug]/page.tsx
@@ -6,7 +6,7 @@ import { FernNavigation } from "@fern-api/fdr-sdk";
 import { slugjoin } from "@fern-api/fdr-sdk/navigation";
 import { HeaderTabsList } from "@fern-docs/components/HeaderTabsList";
 
-export const revalidate = 900;
+export const revalidate = false;
 
 export default async function HeaderTabsPage({
     params
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@languageSelect/[slug]/page.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@languageSelect/[slug]/page.tsx
@@ -7,7 +7,7 @@ import { LanguageDropdown } from "@fern-docs/components/header/LanguageDropdown"
 
 import { getFernToken } from "@/app/fern-token";
 
-export const revalidate = 900;
+export const revalidate = false;
 
 export default async function LanguageSelectPage({
     params
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@logo/[slug]/page.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@logo/[slug]/page.tsx
@@ -10,7 +10,7 @@ import { getFernToken } from "@/app/fern-token";
 import { Logo } from "@/components/logo";
 import { withLogo } from "@/server/withLogo";
 
-export const revalidate = 900;
+export const revalidate = false;
 
 export default async function LogoPage({
     params
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@productSelect/[slug]/page.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@productSelect/[slug]/page.tsx
@@ -8,7 +8,7 @@ import { ProductDropdown } from "@fern-docs/components/header/ProductDropdown";
 
 import { getFernToken } from "@/app/fern-token";
 
-export const revalidate = 900;
+export const revalidate = false;
 
 export default async function ProductSelectPage({
     params
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@sidebar/[slug]/page.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@sidebar/[slug]/page.tsx
@@ -10,7 +10,7 @@ import { SidebarTabsList } from "@fern-docs/components/sidebar/SidebarTabsList";
 import { SidebarTabsRoot } from "@fern-docs/components/sidebar/SidebarTabsRoot";
 import { HiddenSidebar } from "@fern-docs/components/theming/HiddenSidebar";
 
-export const revalidate = 900;
+export const revalidate = false;
 
 export default async function SidebarPage({
     params
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@versionSelect/[slug]/page.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/@versionSelect/[slug]/page.tsx
@@ -8,7 +8,7 @@ import { VersionDropdown } from "@fern-docs/components/header/VersionDropdown";
 
 import { getFernToken } from "@/app/fern-token";
 
-export const revalidate = 900;
+export const revalidate = false;
 
 export default async function VersionSelectPage({
     params
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/[slug]/page.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/[slug]/page.tsx
@@ -9,7 +9,7 @@ import { generateMetadataFromPage } from "@/components/seo";
 import SharedPage from "@/components/shared-page";
 
 export const dynamic = "force-static";
-export const revalidate = 900;
+export const revalidate = false;
 
 export default async function StaticPage({
     params
diff --git a/packages/fern-docs/bundle/src/app/[host]/[domain]/static/layout.tsx b/packages/fern-docs/bundle/src/app/[host]/[domain]/static/layout.tsx
@@ -4,8 +4,6 @@ import { createCachedDocsLoader } from "@fern-api/docs-loader";
 
 import SharedLayout from "@/components/shared-layout";
 
-export const revalidate = 900;
-
 export default async function Layout({
     children,
     params,
diff --git a/packages/fern-docs/bundle/src/middleware.ts b/packages/fern-docs/bundle/src/middleware.ts
@@ -330,8 +330,9 @@ export const middleware: NextMiddleware = async (request) => {
             reason: "Self-hosted mode - using static route"
         });
         const response = rewrite(rewritePath);
-        // Set CDN cache headers for static pages: 7 min cache + 1 day stale-while-revalidate
-        response.headers.set("Cache-Control", "public, s-maxage=420, stale-while-revalidate=86400");
+        // Set CDN cache headers for static pages: no browser cache, 7 min CDN cache + 1 day stale-while-revalidate
+        response.headers.set("Cache-Control", "public, max-age=0, s-maxage=420, stale-while-revalidate=86400");
+        response.headers.set("CDN-Cache-Control", "max-age=420, stale-while-revalidate=86400");
         return response;
     }
 
@@ -346,8 +347,9 @@ export const middleware: NextMiddleware = async (request) => {
         }
 
         const response = rewrite(withDomain(`/static/${encodeURIComponent(conformTrailingSlash(pathname))}`));
-        // Set CDN cache headers for static pages: 7 min cache + 1 day stale-while-revalidate
-        response.headers.set("Cache-Control", "public, s-maxage=420, stale-while-revalidate=86400");
+        response.headers.set("Cache-Control", "public, max-age=0, s-maxage=420, stale-while-revalidate=86400"); // no browser cache, 7 min CDN cache, 1 day stale-while-revalidate
+        response.headers.set("CDN-Cache-Control", "max-age=420, stale-while-revalidate=86400");
+        response.headers.set("Vercel-CDN-Cache-Control", "max-age=86400, stale-while-revalidate=86400"); // longer value for vercel CDN since it respects invalidateTag
         return response;
     };
 
