Skip to content

Fix SVG diagram font rendering on Windows#1055

Merged
maartenba merged 1 commit intomainfrom
svg-fix
Apr 7, 2026
Merged

Fix SVG diagram font rendering on Windows#1055
maartenba merged 1 commit intomainfrom
svg-fix

Conversation

@maartenba
Copy link
Copy Markdown
Member

Summary

  • Add 'Arial', sans-serif fallbacks to all SVG font-family declarations (Helvetica, Roboto, Helvetica-Bold) so text renders as sans-serif on Windows instead of falling back to Times New Roman
  • Replace Heebo font references with Roboto for consistency (only used for "1", "2", "XYZ" labels in token diagrams)

Problem

SVG diagrams use fonts that aren't available on Windows:

  • Helvetica — macOS-only, not bundled with Windows
  • Roboto — loaded as a web font by the site, but SVGs embedded via <img> are sandboxed and can't access the page's @font-face declarations
  • Heebo — not loaded anywhere

Without fallbacks, browsers default to a serif font (Times New Roman), making diagrams look wrong on Windows.

Changes

21 SVG files across BFF and IdentityServer docs updated. No visual change on macOS; on Windows, text now falls back to Arial instead of Times New Roman.

SVG diagrams use fonts (Helvetica, Roboto, Heebo) that are unavailable on
Windows, causing text to render in a serif font. Add 'Arial', sans-serif
fallbacks to all font-family declarations. Replace Heebo with Roboto for
consistency.
@maartenba maartenba self-assigned this Apr 7, 2026
@maartenba maartenba added the documentation Improvements or additions to documentation label Apr 7, 2026
@maartenba maartenba added this to the 2026-Q2 milestone Apr 7, 2026
@maartenba maartenba added the preview Spins up a preview of the Pull Request for review label Apr 7, 2026
@duende-github-bot
Copy link
Copy Markdown

Preview Environment Provisioned

@maartenba maartenba removed the preview Spins up a preview of the Pull Request for review label Apr 7, 2026
Copy link
Copy Markdown
Contributor

@khalidabuhakmeh khalidabuhakmeh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bff_blocs.svg looks a little weird, but we can fix it in another PR.

@maartenba maartenba merged commit a58042f into main Apr 7, 2026
9 checks passed
@maartenba maartenba deleted the svg-fix branch April 7, 2026 13:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants