Preset Web Fonts

Easily use web fonts from Google Fonts and other providers.

Installation

import { defineConfig, presetWebFonts, presetWind3 } from 'unocss'

export default defineConfig({
  presets: [
    presetWind3(),
    presetWebFonts({
      provider: 'google',
      fonts: {
        sans: 'Roboto',
        mono: 'Fira Code',
      },
    }),
  ],
})

Providers

• google - Google Fonts (default)
• bunny - Privacy-friendly alternative
• fontshare - Quality fonts by ITF
• fontsource - Self-hosted open source fonts
• coollabs - Privacy-friendly drop-in replacement
• none - Treat as system font

Font Configuration

fonts: {
  // Simple
  sans: 'Roboto',
  
  // Multiple (fallback)
  mono: ['Fira Code', 'Fira Mono:400,700'],
  
  // Detailed
  lato: [
    {
      name: 'Lato',
      weights: ['400', '700'],
      italic: true,
    },
    {
      name: 'sans-serif',
      provider: 'none',
    },
  ],
}

Usage

<p class="font-sans">Roboto</p>
<code class="font-mono">Fira Code</code>

Local Fonts

Self-host fonts:

import { createLocalFontProcessor } from '@unocss/preset-web-fonts/local'

presetWebFonts({
  provider: 'none',
  fonts: { sans: 'Roboto' },
  processors: createLocalFontProcessor({
    cacheDir: 'node_modules/.cache/unocss/fonts',
    fontAssetsDir: 'public/assets/fonts',
    fontServeBaseUrl: '/assets/fonts',
  })
})

<!-- Source references:

• https://unocss.dev/presets/web-fonts

-->