feat(fonts): add Playfair Display, Noto Sans JP, Roboto, and 4 more to deterministic font database by miguel-heygen · Pull Request #196 · heygen-com/hyperframes

miguel-heygen · 2026-04-02T13:48:42Z

Summary

Expands the deterministic font database from 11 to 18 font families (25 → 42 font faces, 718KB woff2). E2E testing found that Playfair Display, Noto Sans JP, Roboto, and others fell through to dynamic Google Fonts loading, which breaks in Docker/offline renders.

New fonts:

Font	Weights	Use case
Playfair Display	400, 700, 900	Serif/editorial
Noto Sans JP	400, 700	Japanese text
Roboto	400, 700, 900	Android/Material
Open Sans	400, 700	General body text
Lato	400, 700, 900	Clean professional
Poppins	400, 700, 900	Modern headings
Source Code Pro	400, 700	Code blocks

New aliases: Segoe UI → Roboto, Noto Sans Japanese → Noto Sans JP

Part 4 of 5 in a stacked PR series fixing E2E test findings.

Test plan

npx hyperframes render with Playfair Display font — no "Unresolved font families" warning
npx hyperframes render --docker with Noto Sans JP — Japanese characters render correctly
Existing fonts still resolve correctly

miguel-heygen · 2026-04-02T14:00:55Z

feat(engine): add experimental canvas renderer using drawElementImage API #198
fix(templates): resolve all lint errors and warnings in bundled templates #197
feat(fonts): add Playfair Display, Noto Sans JP, Roboto, and 4 more to deterministic font database #196 👈 (View in Graphite)
fix(engine): suppress font-loading 404 noise in render console output #195
fix(cli): read actual composition dimensions in info and fix semver update check #194
feat(lint): add rules for non-deterministic code, missing clip class, overlapping tracks, and rAF detection #193
main

This stack of pull requests is managed by Graphite. Learn more about stacking.

jrusso1020 · 2026-04-02T16:42:27Z

+  "playfair-display": {
+    packageName: "@fontsource/playfair-display",
+    faces: [{ weight: "400" }, { weight: "700" }, { weight: "900" }],
+  },
+  "source-code-pro": {
+    packageName: "@fontsource/source-code-pro",
+    faces: [{ weight: "400" }, { weight: "700" }],
+  },
+  "noto-sans-jp": {
+    packageName: "@fontsource/noto-sans-jp",
+    faces: [{ weight: "400" }, { weight: "700" }],
+  },
+  roboto: {
+    packageName: "@fontsource/roboto",
+    faces: [{ weight: "400" }, { weight: "700" }, { weight: "900" }],
+  },
+  "open-sans": {
+    packageName: "@fontsource/open-sans",
+    faces: [{ weight: "400" }, { weight: "700" }],
+  },
+  lato: {
+    packageName: "@fontsource/lato",
+    faces: [{ weight: "400" }, { weight: "700" }, { weight: "900" }],
+  },
+  poppins: {
+    packageName: "@fontsource/poppins",
+    faces: [{ weight: "400" }, { weight: "700" }, { weight: "900" }],
+  },
 };


I feel like we may need a better way to handle this long term

yep, I think users should download always their fonts to avoid hardcoding fonts like this

vanceingalls

Review feedback — approved

Clean and well-structured. Font selection is solid — Roboto, Open Sans, Lato, Poppins cover the most common web fonts. Noto Sans JP for CJK is excellent. The Segoe UI → Roboto alias is smart for headless Linux/Docker.

Minor: worth noting the size impact of Noto Sans JP faces on CLI distribution if it's significant.

miguel-heygen · 2026-04-02T17:05:09Z

Agreed. The CANONICAL_FONTS map is already getting long, and adding CJK fonts (Noto Sans SC, KR, Arabic, etc.) will make it bigger. A longer-term approach could be:

A separate fonts.json registry that maps family names to fontsource package names + weights
An npx hyperframes fonts add <family> command that downloads and embeds on demand
Runtime font resolution that falls back to Google Fonts API when a font isn't in the embedded database

Happy to scope that as a follow-up issue.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…ssing Address review feedback: instead of silently dropping "Failed to load resource" errors (which could hide real asset failures), keep them in browserConsoleBuffer for diagnostics but don't print to stdout. Real asset 404s are still caught by the file server's own logging. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Address review: filter was too broad and could suppress real asset failures. Now only suppresses 404s matching fonts.googleapis, fonts.gstatic, or .woff2 file extensions. Missing images, scripts, and videos will still surface as [Browser:ERROR] in render output. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…o deterministic font database Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…o deterministic font database (#196) * fix(engine): suppress font-loading 404 noise in render console output Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix(engine): downgrade resource 404s to buffer-only instead of suppressing Address review feedback: instead of silently dropping "Failed to load resource" errors (which could hide real asset failures), keep them in browserConsoleBuffer for diagnostics but don't print to stdout. Real asset 404s are still caught by the file server's own logging. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix(engine): narrow 404 filter to font CDN domains and woff2 files only Address review: filter was too broad and could suppress real asset failures. Now only suppresses 404s matching fonts.googleapis, fonts.gstatic, or .woff2 file extensions. Missing images, scripts, and videos will still surface as [Browser:ERROR] in render output. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat(fonts): add Playfair Display, Noto Sans JP, Roboto, and 4 more to deterministic font database Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

This was referenced Apr 2, 2026

feat(lint): add rules for non-deterministic code, missing clip class, overlapping tracks, and rAF detection #193

Merged

fix(cli): read actual composition dimensions in info and fix semver update check #194

Merged

This was referenced Apr 2, 2026

fix(engine): suppress font-loading 404 noise in render console output #195

Merged

fix(templates): resolve all lint errors and warnings in bundled templates #197

Merged

feat(engine): add experimental canvas renderer using drawElementImage API #198

Closed

miguel-heygen requested review from jrusso1020 and vanceingalls April 2, 2026 16:38

jrusso1020 reviewed Apr 2, 2026

View reviewed changes

jrusso1020 approved these changes Apr 2, 2026

View reviewed changes

miguel-heygen force-pushed the fix/render-suppress-font-404-noise branch from 371a6b7 to 5a3e099 Compare April 2, 2026 16:43

miguel-heygen force-pushed the feat/fonts-expand-deterministic-database branch from 6d9cdae to ab8c4ee Compare April 2, 2026 16:43

miguel-heygen force-pushed the fix/render-suppress-font-404-noise branch from 5a3e099 to f4a4d76 Compare April 2, 2026 16:46

miguel-heygen force-pushed the feat/fonts-expand-deterministic-database branch 2 times, most recently from ce63fc7 to c3b24b6 Compare April 2, 2026 16:47

vanceingalls approved these changes Apr 2, 2026

View reviewed changes

miguel-heygen force-pushed the feat/fonts-expand-deterministic-database branch from c3b24b6 to b95806e Compare April 2, 2026 17:03

miguel-heygen force-pushed the fix/render-suppress-font-404-noise branch from 040c458 to f81757e Compare April 2, 2026 17:03

vanceingalls force-pushed the fix/render-suppress-font-404-noise branch from f81757e to 36582e6 Compare April 2, 2026 21:10

vanceingalls force-pushed the feat/fonts-expand-deterministic-database branch from b95806e to 5ff4a8d Compare April 2, 2026 21:11

miguel-heygen and others added 2 commits April 2, 2026 21:13

fix(engine): suppress font-loading 404 noise in render console output

7fe0c5b

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vanceingalls force-pushed the fix/render-suppress-font-404-noise branch from 36582e6 to e76e312 Compare April 2, 2026 21:13

vanceingalls force-pushed the fix/render-suppress-font-404-noise branch from e76e312 to dc47aa7 Compare April 2, 2026 21:13

feat(fonts): add Playfair Display, Noto Sans JP, Roboto, and 4 more t…

e365e01

…o deterministic font database Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vanceingalls force-pushed the feat/fonts-expand-deterministic-database branch from 5ff4a8d to e365e01 Compare April 2, 2026 21:13

graphite-app Bot changed the base branch from fix/render-suppress-font-404-noise to main April 2, 2026 21:31

vanceingalls merged commit 7294803 into main Apr 2, 2026
22 checks passed

miguel-heygen deleted the feat/fonts-expand-deterministic-database branch April 6, 2026 23:24

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(fonts): add Playfair Display, Noto Sans JP, Roboto, and 4 more to deterministic font database#196

feat(fonts): add Playfair Display, Noto Sans JP, Roboto, and 4 more to deterministic font database#196
vanceingalls merged 4 commits into
mainfrom
feat/fonts-expand-deterministic-database

miguel-heygen commented Apr 2, 2026 •

edited

Loading

Uh oh!

miguel-heygen commented Apr 2, 2026 •

edited

Loading

Uh oh!

jrusso1020 Apr 2, 2026

Uh oh!

miguel-heygen Apr 2, 2026

Uh oh!

vanceingalls left a comment

Uh oh!

miguel-heygen commented Apr 2, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

miguel-heygen commented Apr 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

miguel-heygen commented Apr 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jrusso1020 Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

miguel-heygen Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

vanceingalls left a comment

Choose a reason for hiding this comment

Review feedback — approved

Uh oh!

miguel-heygen commented Apr 2, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

miguel-heygen commented Apr 2, 2026 •

edited

Loading

miguel-heygen commented Apr 2, 2026 •

edited

Loading