Skip to content

feat(docs): add custom webfonts for iPod-themed branding#47

Open
jvgomg wants to merge 2 commits intomainfrom
docs/custom-webfonts-v2
Open

feat(docs): add custom webfonts for iPod-themed branding#47
jvgomg wants to merge 2 commits intomainfrom
docs/custom-webfonts-v2

Conversation

@jvgomg
Copy link
Copy Markdown
Owner

@jvgomg jvgomg commented Mar 21, 2026

Summary

  • Add Source Sans 3 Variable as the body font via Fontsource, replacing Starlight's default system fonts. Source Sans 3 is the closest open-source alternative to Myriad Pro (the font Apple used in iPod-era marketing).
  • Self-host Chicago FLF and ChiKareGo2 pixel fonts for iPod-themed display use.
  • Self-host Apple Garamond Light (freeware ITC Garamond recreation) as a serif display font for hero text and taglines, evoking Apple's 1984–2002 branding.
  • Add Cormorant Light via Fontsource as an open-source serif fallback (SIL OFL).
  • All fonts registered via @font-face and available through CSS custom properties (--sl-font for body, --sl-font-serif for serif display).

Related

  • TASK-184 — Design new landing page for docs site (depends on this PR)
  • doc-009 — Podkit Website Branding

Fonts

Font Role License Size
Source Sans 3 Variable Body text (--sl-font) SIL OFL via Fontsource
Apple Garamond Light Serif display (--sl-font-serif) Freeware 22.7 KB
Cormorant Light Serif fallback (--sl-font-serif) SIL OFL via Fontsource
Chicago FLF Pixel display (available by name) Public Domain 17.7 KB
ChiKareGo2 Pixel display (available by name) CC BY (Giles Booth) 4.2 KB

Test plan

  • Run cd packages/docs-site && bun run build — verify build succeeds
  • Run dev server (bun run dev) and check body text renders in Source Sans 3
  • Verify Apple Garamond, Chicago FLF, and ChiKareGo2 are available in DevTools (apply via inspector to test)
  • Check --sl-font-serif custom property resolves correctly

🤖 Generated with Claude Code

@jvgomg jvgomg force-pushed the docs/custom-webfonts-v2 branch from 55eae4e to a430819 Compare March 21, 2026 22:06
jvgomg and others added 2 commits March 22, 2026 10:42
Add Source Sans 3 Variable as the body font via Fontsource, and
self-host Chicago FLF and ChiKareGo2 pixel fonts for iPod-themed
display use.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add Apple Garamond Light (freeware) as the primary serif display font
and Cormorant Light (SIL OFL) as the open-source fallback. Both are
registered as --sl-font-serif for use in landing page and hero components.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jvgomg jvgomg force-pushed the docs/custom-webfonts-v2 branch from a430819 to 91b0ab1 Compare March 22, 2026 10:42
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