1.4 KiB
1.4 KiB
0004 Self-hosted Yekan Bakh variable font
Status: Superseded by 0007 · Area: design · Date: 2026-10-04 · Decided by: user
Context
The Lumina Design System replaced Vazirmatn with Yekan Bakh, a licensed variable font (weights 100–1000) that ships with the app, plus Yekan Bakh FaNum, which draws Latin digits as Persian.
Decision
- Serve both faces from island:
packages/island/src/fonts/yekan-bakh-vf.woff2andyekan-bakh-fa-num-vf.woff2. Never load them from a public CDN. - Each app loads them with
next/font/local(weight: '100 1000',display: 'swap', a Tahoma fallback), withvariable: '--font-yekan-bakh'and'--font-yekan-bakh-fa-num', on<html lang="fa" dir="rtl">, never<body>: island's--font-sansand--font-fanumresolve on:root, so variables set lower fall back to Tahoma silently. - Use
font-sanseverywhere and write Persian digits. Usefont-fanumonly where typed Latin digits can't be reformatted.
Alternatives
- Vazirmatn from Google Fonts (the design system's first choice): a third-party request on the critical path.
- Static weight files: the design system ships only the variable files, and one file per weight means more requests.
Consequences
- No third-party font request; one preloaded file covers every weight.
- The font is licensed: keep the repo private, and check that the licence covers web embedding in every app before release.
- Upgrading the font is a file swap in island.