Skip to content
The Docs Report
Tuesday, November 17, 2026NewsletterRSS

Fumadocs Adds a Slot for AI Chat and Redesigns Its API Playground

Fumadocs 16.16.0 puts an AI chat panel into its docs layouts, and fumadocs-openapi 12.2.0 moves the API playground into a dialog. Both shipped Oct. 3.

3 min read

FumadocsOpen sourceAIAPI reference

Product photo of a white toy robot on a cobalt blue, teal and violet gradient

Fumadocs layouts can now host an AI chat panel without custom positioning code, according to the Oct. 3 release notes for fumadocs 16.16.0. The same day, fumadocs-openapi 12.2.0 moved its API playground into a dialog.

Layouts accept a chat panel

The Docs, Notebook, Glass and Spacious layouts take a new aiChat option. A team passes its chat component as aiChat.panel, and the layout shows it beside the page on wide screens and floating over the page on smaller ones. The Fumadocs CLI has a matching ai feature that renders the docs layout from a client component at ai/layout.tsx.

Fumadocs does not supply the chat itself. The option is a slot, so the model, the retrieval and the interface stay the team’s own.

Spacious is a roomier layout

The 16.16.0 release adds Spacious, a less compact alternative to the Docs layout. It sets the page in an inset panel beside the sidebar and moves page-level actions to the top. It imports from fumadocs-ui/layouts/spacious and can be customized through npx @fumadocs/cli customize, though only on the Base UI build. Glass now exports as DocsLayout, with GlassLayout kept as an alias.

The API playground becomes a dialog

The fumadocs-openapi 12.2.0 release notes say the playground now opens in a dialog from a “Try in Playground” button on endpoint pages. A URL bar at the top selects the server, edits its variables and fills path parameters. Authentication, parameters and the request body share one editing panel, with descriptions behind an info button. Nested objects and arrays open in their own panel with breadcrumb navigation, and OAuth 2.0 authorization sits in the same panel.

Responses now show status, duration, size and headers next to the code examples, and Cmd or Ctrl plus Enter sends the request. A new usePlayground() hook exposes the form, auth and request state for teams that want to build their own interface. The release removes components.CollapsiblePanel from the playground options, which is a breaking change.

Smaller changes came the day before

The fumadocs-openapi 12.1.1 notes, dated Oct. 2, add response download and make “Send as Basic Auth header” the default for OAuth client authentication, following RFC 6749. Fumadocs 16.15.18, also Oct. 2, added Meilisearch search, usable self-hosted or in the cloud, with browser-side filtering by tag and locale.

These builds sit on the OpenAPI v12 rework that Fumadocs described in a Sept. 20 post. That version splits a headless layer for state and logic from UI components that teams install through the CLI and edit themselves.

Key takeaways

  • Fumadocs 16.16.0 adds an aiChat layout option for Docs, Notebook, Glass and Spacious.
  • A new Spacious layout puts the page in an inset panel beside the sidebar.
  • fumadocs-openapi 12.2.0 moves the playground into a dialog and adds a usePlayground() hook.
  • 12.2.0 removes components.CollapsiblePanel, so custom playgrounds need a check.

The take

We think the aiChat slot is the more useful half of this release, because it handles the layout work and leaves the chat itself to the team. A docs framework that ships its own chatbot makes every site depend on one retrieval setup. A slot lets a team swap in whatever it already runs.

The playground change is a bigger bet. A dialog gives nested request bodies more room, but it moves a familiar control, and readers will have to find it again. We’d test the new dialog on the most complex endpoint in the spec before upgrading, and we’d search any custom playground code for CollapsiblePanel first.