11.0.0
Release notes for 11.0.0.
Released: 2026-11-13
Breaking Changes
Tauri desktop app support is retired, together with the Tauri-only find-in-page feature. Versions already published keep the feature. The "Retired Tauri Desktop Modes" guide lists the clean-up steps. (#4758)
The
findInPagesetting is removed fromZudoDocConfig,Settingsand the defaults. RemovefindInPagefrom your config. (#4758)The
@takazudo/export and thezudo- doc/ find- in- page FindInPageInitbody-end island are removed. Remove direct imports of that subpath and any manualFindInPageInitmount in aBodyEndIslandsoverride. Cmd/Ctrl+F is the browser's own find again. (#4758)The
.find-matchand.find-match-activestyles, and the Beacon and E-Ink theme pack overrides for the native find bar, are removed. Matched-keyword search colours, the warning and accent tokens, and the Bauhaus search token settings are unchanged. (#4758)The
@takazudo/zudo-doc-history-serverpeer floor moves from^10.0.0to^11.0.0. Projects that enable document history need history-server 11.x.
Features
New optional
home.imagesetting ({ src, alt?, width?, height?, darkSrc? }) shows a full-colour picture in the home hero, in the box the logo uses, instead of the one-colour logo mask.darkSrcis shown in dark mode by CSS keyed on the colour mode, with no extra script. Paths must be root-absolute site paths; external URLs and malformed values throw aTypeErrorat config resolution. Output withouthome.imageis unchanged. (#4750)New
home.imageLayout("logo","large","banner","backdrop") giveshome.imagemore room: a 560px side box, a full-width banner above the title, or a cropped backdrop behind a readable copy panel. The default"logo"keeps the current output. (#4751)New
@takazudo/export:zudo- doc/ home- hero HomeHerorenders the home hero from plain props, so hosts can preview the exact hero outside the home route. (#4753)Social preview images per locale and per page:
locales.<code>.ogImage(orfalse) and theog_imagefrontmatter field overridemetaTags.ogImage. (#4752)New
coverfrontmatter field shows a 1200×630 cover image on a top-level section's card in the home page site index. (#4754)With
mcp: true, the Worker serves an MCP Server Card (SEP-2127) at<base>/mcp/server-cardand, whenbaseis/, an AI Catalog at/that lists the card under the site name. Both are read-only JSON with CORS, caching and ETag revalidation. At a root base every page links the catalog with. well- known/ ai- catalog. json <link rel="ai-catalog">, and thellms.txtMCP section lists the card.@takazudo/keeps its existing exports and addszudo- doc/ mcp buildMcpServerCard,buildAiCatalog, the discovery URL helpers, and the media-type and path constants. The/tools and their limits are unchanged. (#4769)mcp New optional setting
contentSignals({ search?, aiInput?, aiTrain? } | false, defaultfalse) publishes Content Signals as aContent-Signalline in theUser-agent: *group ofrobots.txt.truepublishesyes,falsepublishesno, an omitted key expresses no preference, and the line stays undernoindex. An unknown key or a non-boolean value is aTypeErrorat config resolution.@takazudo/also exportszudo- doc/ robots renderContentSignalandCONTENT_SIGNAL_KEYS. Output is unchanged whilecontentSignalsis unset. (#4767)Homepage navigation building blocks:
WideSectionHeading(an MDX tag, also exported from@takazudo/),zudo- doc/ content SiteTreeNav variant="described"with category descriptions and document counts, the server-renderedDocCardNav(@takazudo/, an MDX tag) andzudo- doc/ doc- card- nav DocCardGrid layout="auto". The optionalhome.sectionssetting composes one site tree and at most one card section on the home page, in either order, with per-locale heading and description overrides. Withouthome.sectionsthe home page is unchanged. (#4771)
Bug Fixes
The home page and each locale home page emit a canonical link and
og:urlwhensiteUrlis set, using the same URL as the sitemap. (#4767)Pages in a configured non-default locale point their
llms.txtalternate link at that locale's/instead of the default-locale index. (#4767)<locale>/ llms. txt The MCP handler no longer fails every
/request whenmcp siteUrlis not anhttp:orhttps:URL (for exampledocs.example.com:8443without a scheme). Its citation URLs then use the request origin, the same origin the Server Card and AI Catalog advertise. (#4769)SiteTreeNavtree lines now meet their items: the rail starts at the first branch, chevrons sit on the child rail, and the last rail ends at its branch. Sidebar connectors are unchanged. (#4771)