@usedetach/next

Next.js App Router integration for Detach. Published pages stay statically generated and cache-tagged; draft content is served only when a verified preview session exists.

npm install @usedetach/next

// app/[handle]/page.tsx
import { getPage } from "@usedetach/next";

const { page, preview } = await getPage(cms, { handle, locale, workspace });

// app/api/cms-preview/route.ts
import { createPreviewRouteHandler } from "@usedetach/next";
export const GET = createPreviewRouteHandler(cms);

// app/api/revalidate/route.ts
import { createRevalidateHandler } from "@usedetach/next";
export const POST = createRevalidateHandler({ secret: process.env.CMS_REVALIDATE_SECRET! });

Also here: getGlobals, getAudiences, resolveTemplate, getVisitorContext, and withCmsVisitor for proxy/middleware — request URL forwarding a Server Component cannot otherwise see.

Requires @usedetach/core. Peer dependencies: next 15 or 16, react 18 or 19.