Google Fonts loader — 32 curated web fonts with on-demand loading, CSS font-family mappings, and deduplication. No framework dependency.
npm install @arraypress/google-fontsimport { getFontFamily, loadFont, needsLoading, getFontList, FONTS } from '@arraypress/google-fonts';
// Get CSS font-family value
getFontFamily('inter'); // '"Inter", sans-serif'
getFontFamily('system'); // ''
// Load a font (injects <link> into <head>, deduplicates)
loadFont('inter');
loadFont('inter'); // no-op, already loaded
// Check if a font needs remote loading
needsLoading('inter'); // true
needsLoading('system'); // false
// Get all fonts for a picker UI
const fonts = getFontList();
// [{ key: 'geist', label: 'Geist', family: '"Geist", sans-serif', category: 'sans-serif' }, ...]| Key | Family | Category |
|---|---|---|
system |
(browser default) | — |
geist |
Geist | sans-serif |
serif |
Playfair Display | serif |
mono |
JetBrains Mono | monospace |
poppins |
Poppins | sans-serif |
inter |
Inter | sans-serif |
dm-sans |
DM Sans | sans-serif |
space-grotesk |
Space Grotesk | sans-serif |
outfit |
Outfit | sans-serif |
plus-jakarta |
Plus Jakarta Sans | sans-serif |
sora |
Sora | sans-serif |
cabinet-grotesk |
Cabinet Grotesk | sans-serif |
montserrat |
Montserrat | sans-serif |
raleway |
Raleway | sans-serif |
lato |
Lato | sans-serif |
open-sans |
Open Sans | sans-serif |
roboto |
Roboto | sans-serif |
nunito |
Nunito | sans-serif |
work-sans |
Work Sans | sans-serif |
rubik |
Rubik | sans-serif |
manrope |
Manrope | sans-serif |
figtree |
Figtree | sans-serif |
onest |
Onest | sans-serif |
lexend |
Lexend | sans-serif |
urbanist |
Urbanist | sans-serif |
quicksand |
Quicksand | sans-serif |
archivo |
Archivo | sans-serif |
barlow |
Barlow | sans-serif |
bricolage-grotesque |
Bricolage Grotesque | sans-serif |
instrument-sans |
Instrument Sans | sans-serif |
crimson-pro |
Crimson Pro | serif |
CSS font-family values for each font key.
Google Fonts API family strings for loading.
All available font keys.
Get the CSS font-family value for a font key. Returns empty string if not found.
Load a Google Font by key. Injects a <link> tag into <head>. Deduplicates. SSR safe.
Check if a font key needs remote loading from Google Fonts.
Get font metadata for a picker UI. Returns all fonts except system.
MIT