Decouples the root layout from Next.js-specific implementation details. This way we can consume the root layout using alternative React frameworks, e.g. TanStack.

The root layout consumes the new Router Adapter and Server Adapter, with additional layers of abstraction for font loading and dependency checking.

The framework-agnostic implementation lives in @payloadcms/ui and is exposed at a new @payloadcms/ui/layouts entrypoint. @payloadcms/next/layouts continues to work unchanged — it is now a thin wrapper that injects the Next.js adapters, fonts, and dep-check constraints into the ui implementation, so existing app callers need no changes.

import { RootLayout } from '@payloadcms/ui/layouts'

<RootLayout
  config={config}
  importMap={importMap}
  fonts={[{ className: inter.className, variable: inter.variable }]}
  RouterAdapter={MyRouterAdapter}
  serverAdapter={myServerAdapter}
  serverFunction={serverFunction}
  additionalDependencyChecks={{
    dependencyVersions: {
      'my-framework': { required: false, version: '>=1.0.0' },
    },
  }}
>
  {children}
</RootLayout>

Internally:

• initReq moves to @payloadcms/ui/utilities/initReq and accepts the adapter as an explicit argument rather than reading next/headers directly.
• Universal react / react-dom version checks move to @payloadcms/ui/utilities/checkDependencies. Each framework adapter layers its own constraints through the additionalDependencyChecks prop — the Next.js wrapper passes next: '>=15.0.0'.
• The Next.js wrapper now lives at packages/next/src/adapters/layout.tsx, mirroring the existing router.tsx and server.ts adapter files.
• Language switching now dispatches through the existing serverFunction mechanism via a new switch-language handler in @payloadcms/next/utilities/switchLanguageHandler, rather than as a dedicated switchLanguageServerAction prop. The handler writes the cookie using the server adapter via req.server.setCookie(...).

• To see the specific tasks where the Asana app for GitHub is being used, see below:
  • https://app.asana.com/0/0/1215458044014629