Skip to content

docs(site): restore the lost blog posts and the Mermaid page - #3549

Merged
diegomura merged 1 commit into
masterfrom
diegomura/restore-lost-docs
Aug 27, 2026
Merged

docs(site): restore the lost blog posts and the Mermaid page#3549
diegomura merged 1 commit into
masterfrom
diegomura/restore-lost-docs

Conversation

@diegomura

Copy link
Copy Markdown
Owner

Four finished pages were written during the site rebuild but never committed, so they went with the squash. They only survived in Conductor's working-tree checkpoints; this restores them as they were.

Blog

  • How react-pdf renders text — the six-pass textkit walkthrough, with the four interactive labs
  • Dropping the pdfkit fork — the retrospective on @react-pdf/pdfkit and the upstream PRs that ended it
  • Large documents in the browser — why a big render freezes the tab, and the web worker setup that fixes it

Docs

  • v4/addons/mermaid — the @react-pdf/mermaid reference, back in the Addons nav next to Math

What had to change to make them build

components/text-lab comes back with the text post: the prose is written around <RunsStrip>, <GlyphLab>, <LineBreakLab> and <LineBoxLab>, and MDX throws on an undefined component, so the page does not render without them. They are wired into the blog page's component map. They import fontkit and @react-pdf/textkit, which the site was already resolving transitively — now declared, at the versions already in yarn.lock, so the lockfile is untouched.

The Mermaid page called <Usage name="addons/mermaid" />, an API that no longer exists pointing at snippet files that never did. Its three examples are plain code blocks now, matching the Math page beside it.

Verified with a production next build from a clean --frozen-lockfile install: all five routes prerender and serve 200, including the three new blog entries and the Mermaid page.

Not restored, for the record: the _dummy-*.mdx scaffolding, and v4/advanced/large-documents.mdx, a stub that only linked out to a dev.to post — the blog entry above replaces it.

🤖 Generated with Claude Code

Three finished blog posts and the Mermaid addon page were written but never
committed, so they were lost when the site branch was squashed: the textkit
walkthrough, the pdfkit fork retrospective, the web worker post, and the
`@react-pdf/mermaid` reference.

The textkit post is the reason `components/text-lab` comes back with it: the
prose leans on four interactive labs, and without them the page does not
render. They need fontkit and textkit, which the site already resolved
transitively and now declares.

The Mermaid page called a `<Usage name>` component that no longer exists, and
the snippet files it pointed at never did; its three examples are plain code
blocks now, like the Math page next to it.
@changeset-bot

changeset-bot Bot commented Aug 27, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: e2837e8

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel

vercel Bot commented Aug 27, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
react-pdf Ready Ready Preview Aug 27, 2026 11:32pm

@diegomura
diegomura merged commit 56f4099 into master Aug 27, 2026
17 checks passed
@diegomura
diegomura deleted the diegomura/restore-lost-docs branch August 27, 2026 23:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant