Project

Krdfonts

Kurdish Unicode font library. Browse, preview, download and install with a single command.

KrdFonts project Kurdish fonts have long been scattered across blogs, social media groups, and personal websites — inconsistently named, poorly organized, and impossible to install programmatically. krdfont changes that. The project has three parts: 1.Web Platform — A Next.js 16 application where users can browse 20 font collections, preview any of 972 fonts with live text input and adjustable size, and download individual files. Built with React 19, Tailwind CSS 4, and Framer Motion. Fonts are served as static assets through Vercel's edge CDN with immutable cache headers. 2.CLI Tool — A zero-dependency npm package (npx krdfonts install <font>) that auto-detects your project type (Next.js, Vite, CRA) and places fonts in the correct directory. It also generates ready-to-import @font-face CSS. Published at 3.8 kB compressed. 3.Font Processing Pipeline — A build-time system that scans 213 MB of font files, extracts metadata (weight, style, format), generates a structured JSON manifest, and copies assets to static serving. This architecture reduced the production build from 1 GB to 25 MB — a 97.5% reduction required to deploy on Vercel's serverless infrastructure. All fonts support full Unicode for Kurdish (Sorani & Kurmanji), Arabic, and Persian. Key Technical Highlights (bullet points) 972 fonts across 20 collections, 213 MB of font data Build-time metadata generation — zero fs calls at runtime 97.5% build reduction (1 GB → 25 MB) through architectural refactoring Zero-dependency CLI at 3.8 kB with smart framework detection Static font serving via Vercel CDN with immutable caching font-display: swap + fallback stacks to eliminate invisible text Full RTL support with bidirectional text rendering
case-study.htmlCase Study
Interactive walkthrough of the project process
Open