Skip to content

Update World Pro font and align typography with UI Kit 5.0 - #76

Open
karlosbalej wants to merge 6 commits into
worldcoin:mainfrom
karlosbalej:fix/font-line-height
Open

Update World Pro font and align typography with UI Kit 5.0#76
karlosbalej wants to merge 6 commits into
worldcoin:mainfrom
karlosbalej:fix/font-line-height

Conversation

@karlosbalej

@karlosbalej karlosbalej commented Sep 9, 2026

Copy link
Copy Markdown

Summary

Update World Pro MVP with the supplied font revision and align all 16 typography tokens with the live text styles in UI Kit 5.0. The live styles and styled specimens agree; some handwritten labels on the Figma sheet have outdated weights.

Twelve tokens needed corrections:

  • h1–h5 weight: 500 → 450; line height: 120% → 110% (latest Figma revision).
  • l1–l3 weight: 550 → 500.
  • b1/b2 tracking: 0 → −0.5%.
  • b3 line height: 120% → 130%.
  • c1 tracking: 0 → +0.3%.

Regenerate iOS and Android defaults/resources and web outputs. Preserve the existing TTF paths, add WOFF2/WOFF, and use WOFF2 with the actual 300–800 weight range in the web example. Add docs/typography.md with the complete Figma mapping and rendering caveats.

Add a standalone iOS comparison app with an all-16-styles gallery comparing the previous release font/tokens with the updated font and Figma-aligned tokens. Each specimen shows size, weight, tracking, and line height. A separate b1 tab retains four identical paragraphs using the same current token to isolate the font change. The previous font is bundled only in the example. Exclude generated Next.js exports from root formatting checks.

Compatibility and rendering

  • The font's PostScript name changes from WorldProMVPLH-Regular to WorldProMVP-Regular. Generated references are updated; consumers hardcoding the old name must update their font lookup or web font-face declaration.
  • Token values match Figma; rendered iOS line-height parity is not established. The existing DEBUG preview and comparison use native font metrics for spacing, while Figma uses font size. The public library supplies descriptors and leaves tracking/line-height application to consumers. Clarify this in the API documentation without changing consumer rendering behavior.
  • In the iPad Pro 11-inch comparison on iOS 26.5 at standard text size, the Figma-aligned b1 block measures 534.4 pt with the previous font and 589.7 pt with the updated font. Review consuming apps' fixed-height layouts. The reported original line-height defect has not been confirmed resolved.
  • The supplied font removes U+1F3C6 (trophy), widens eight arrow glyphs, changes some symbol outlines, and adjusts kerning after 7 before certain punctuation. No affected symbol usage was found in rendered source strings in this repo.

Validation

  • Verified all 16 Figma styles against source and generated web JSON/CSS, Swift, and Kotlin values: family, size, numeric weight, tracking, and line height.
  • Passed formatting, lint, TypeScript, and token generation.
  • Passed both web production build modes and the iOS comparison build after typography alignment; launched and visually checked the updated native b1 comparison and the all-styles gallery; verified all 16 gallery baseline values against v0.2.9.
  • Earlier font validation also passed the full iOS SPM build, all 18 web button specimens' geometry/overflow checks, asset byte comparisons, and npm package contents inspection.
  • Android compilation/rendering, larger Dynamic Type settings, and consuming app screens remain unverified. Java and the Android SDK are unavailable locally.

@karlosbalej karlosbalej changed the title Update World Pro font assets and add an iOS b1 comparison Update World Pro font and align typography with UI Kit 5.0 Sep 9, 2026
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