Lazy-load the Mermaid code block - #4468
Merged
Merged
Conversation
🦋 Changeset detectedLatest commit: e545766 The changes in this PR will be included in the next version bump. This PR includes changesets to release 1 package
Not sure what this means? Click here to learn what changesets are. Click here if you're a maintainer who wants to add another changeset to this PR |
Contributor
|
The latest updates on your projects. Learn more about Argos notifications ↗︎
|
nolannbiron
marked this pull request as ready for review
August 5, 2026 14:54
peterwhite
approved these changes
Aug 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
CodeBlockonly rendersMermaidCodeBlockwhen the block's syntax ismermaid, but the import was static. Next inlines every'use client'module reachable from a route's server graph into that route's client entry (next-flight-client-entry-loaderemitsimport(/* webpackMode: "eager" */ …)), so a runtime conditional in a server component doesn't split anything — the diagram viewer's dependencies shipped on every page that has any code block at all.Moving the boundary into a
'use client'wrapper puts them in an on-demand chunk instead.ssr: trueis kept so real diagram blocks still server-render their skeleton.Verified on a production build of this branch:
@panzoom/panzoomand the Mermaid wrapper no longer appear in the route's entry chunks.Initial client JS for the docs route:
nolann/perf-shiki-split(base)The byte saving is deliberately small — the Mermaid engine itself was already behind
import('mermaid'). What changes is that pages with code blocks but no diagram stop loading the viewer's wrapper and its dependencies at all.