docs layout issue

[Streakwind]

To Reproduce

someone else had made an issue about this, though deleting the package-lock did not work, nor did adding compiler options. #1605

the error message is basically Type '{ children: ReactNode[]; themeSwitch?: { enabled?: boolean | undefined; component?: ReactNode; mode?: "light-dark" | "light-dark-system" | undefined; } | undefined; ... 6 more ...; tree: Root; }' is not assignable to type 'IntrinsicAttributes & DocsLayoutProps'. Property 'children' does not exist on type 'IntrinsicAttributes & DocsLayoutProps'.

Current vs. Expected behavior

> npm run build 

> web@0.0.0 build
> next build

   ▲ Next.js 15.5.7

   Creating an optimized production build ...
[MDX] updated map file in 12.451399999999921ms
 ✓ Compiled successfully in 14.8s
   Linting and checking validity of types  ...Failed to compile.

./src/app/docs/layout.tsx:8:6
Type error: Type '{ children: ReactNode; themeSwitch?: { enabled?: boolean | undefined; component?: ReactNode; mode?: "light-dark" | "light-dark-system" | undefined; } | undefined; ... 6 more ...; tree: Root; }' is not assignable to type 'IntrinsicAttributes & DocsLayoutProps'.
  Property 'children' does not exist on type 'IntrinsicAttributes & DocsLayoutProps'.

   6 | export default function Layout({ children }: { children: ReactNode }) {
   7 |   return (
>  8 |     <DocsLayout tree={source.pageTree} {...baseOptions}>
     |      ^
   9 |       {children}
  10 |     </DocsLayout>
  11 |   );
Next.js build worker exited with code: 1 and signal: null

Provide environment information

os is windows, versions:

  "dependencies": {
    "fumadocs-core": "15.6.5",
    "fumadocs-mdx": "11.7.0",
    "fumadocs-ui": "15.6.5",
    "next": "^15.5.7",
    "react": "^19.1.0",
    "react-dom": "^19.1.0"
  },
  "devDependencies": {
    "@tailwindcss/postcss": "^4.1.11",
    "@types/mdx": "^2.0.13",
    "@types/node": "24.0.15",
    "@types/react": "^19.1.8",
    "@types/react-dom": "^19.1.6",
    "eslint": "^8",
    "eslint-config-next": "15.4.2",
    "postcss": "^8.5.6",
    "tailwindcss": "^4.1.11",
    "typescript": "^5.8.3"
  }

Which area(s) are affected? (Select all that apply)

TypeScript (built-in types)

Additional context

I used create fumadocs so I'm quite surprised this happened.

[fuma-nama]

You are still on 15, migrating to Fumadocs 16 would probably work. For older versions I think it would work too, but cannot help much as there could be changes from upstream libraries.

[Streakwind]

I made a new website with create fumadocs-app so now it's 16, but I get the same error.

> npm run build 

> web@0.0.0 build
> next build

   ▲ Next.js 16.0.7 (Turbopack)

   Creating an optimized production build ...
[MDX] generated files in 12.21400000000017ms
 ✓ Compiled successfully in 4.0s
   Running TypeScript  .Failed to compile.

./src/app/docs/layout.tsx:7:6
Type error: Type '{ children: ReactNode; themeSwitch?: { enabled?: boolean | undefined; component?: ReactNode; mode?: "light-dark" | "light-dark-system" | undefined; } | undefined; ... 5 more ...; tree: Root; }' is not assignable to type 'IntrinsicAttributes & DocsLayoutProps'.
  Property 'children' does not exist on type 'IntrinsicAttributes & DocsLayoutProps'.

   5 | export default function Layout({ children }: LayoutProps<'/docs'>) {
   6 |   return (
>  7 |     <DocsLayout tree={source.pageTree} {...baseOptions()}>
     |      ^
   8 |       {children}
   9 |     </DocsLayout>
  10 |   );
Next.js build worker exited with code: 1 and signal: null

here is my package.json

{
  "name": "web",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "build": "next build",
    "dev": "next dev",
    "start": "next start",
    "types:check": "fumadocs-mdx && tsc --noEmit",
    "postinstall": "fumadocs-mdx",
    "lint": "eslint"
  },
  "dependencies": {
    "fumadocs-core": "16.2.3",
    "fumadocs-mdx": "14.1.0",
    "fumadocs-ui": "16.2.3",
    "lucide-react": "^0.552.0",
    "next": "^16.0.7",
    "react": "^19.2.0",
    "react-dom": "^19.2.0"
  },
  "devDependencies": {
    "@eslint/eslintrc": "^3.3.3",
    "@tailwindcss/postcss": "^4.1.16",
    "@types/mdx": "^2.0.13",
    "@types/node": "^24.10.0",
    "@types/react": "^19.2.2",
    "@types/react-dom": "^19.2.2",
    "baseline-browser-mapping": "^2.9.4",
    "eslint": "^9.39.1",
    "eslint-config-next": "16.0.1",
    "postcss": "^8.5.6",
    "tailwindcss": "^4.1.16",
    "typescript": "^5.9.3"
  }
}