Skip to content

docs: render the README sequence diagram as SVG for npm - #22

Merged
Karnaukhov-kh merged 1 commit into
mainfrom
docs/npm-diagram
Oct 20, 2026
Merged

Karnaukhov-kh merged 1 commit into
mainfrom
docs/npm-diagram

Conversation

@Karnaukhov-kh

Copy link
Copy Markdown
Member

npm doesn't render Mermaid code blocks, so the package page on npm showed the diagram source in "How Iterward works" instead of the diagram.

This PR makes the following changes:

  • Replaces the Mermaid block in packages/iterward/README.md with a <picture> element, the same pattern the logo uses.
  • Adds light and dark SVG files rendered with mermaid-cli 11.4.2. The SVG files use plain text elements, not foreignObject, so they display as images.
  • Keeps the Mermaid source in assets/how-iterward-works.mmd for regeneration.

The image URLs point to main on raw.githubusercontent.com, so the diagram appears on npm after this PR merges and the next release publishes.

npm doesn't render Mermaid code blocks, so the package page showed the
diagram source. Replace the block with light and dark SVG files rendered
by mermaid-cli, and keep the Mermaid source in assets/ to regenerate them.
@Karnaukhov-kh
Karnaukhov-kh merged commit 2d6d26a into main Oct 20, 2026
1 check passed
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