From 22477c273f7abf1521ed8abfd2b46a796c2890a3 Mon Sep 17 00:00:00 2001 From: universe-ops <177390656+universe-ops@users.noreply.github.com> Date: Mon, 22 Jun 2026 15:47:03 +0300 Subject: [PATCH] docs: fix broken mermaid diagrams (restore startOnLoad) The custom mermaid2 `arguments` block (brand theme + themeVariables) overrode the plugin defaults, which include startOnLoad. Mermaid v10's ESM build only auto-renders
when startOnLoad is true, so initialize() ran but no diagram was drawn (e.g. the Architecture overview on concepts/main-concepts). Re-add startOnLoad: true. Co-Authored-By: Claude Opus 4.8 (1M context) Signed-off-by: Ilya Sadykov <177390656+universe-ops@users.noreply.github.com> --- docs/mkdocs.yml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 10e15ec5..c984cf4b 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -117,6 +117,11 @@ plugins: - mermaid2: version: 10.6.1 arguments: + # startOnLoad MUST be set: supplying a custom `arguments` block + # overrides the plugin's defaults (which include it), and Mermaid v10's + # ESM build only auto-renders
when startOnLoad is + # true. Without it the library loads but no diagram is drawn. + startOnLoad: true theme: base themeVariables: # Aligned with simple-container.com palette (dark scheme).