Skip to content

feat(providers): add npm provider#322

Merged
danielroe merged 5 commits intounjs:mainfrom
LouisLau-art:feat/npm-provider
Feb 13, 2026
Merged

feat(providers): add npm provider#322
danielroe merged 5 commits intounjs:mainfrom
LouisLau-art:feat/npm-provider

Conversation

@LouisLau-art
Copy link
Copy Markdown
Contributor

@LouisLau-art LouisLau-art commented Jan 23, 2026

resolves #188
closes #189

This PR adds a new npm provider that resolves fonts from npm packages via CDN (default: jsDelivr).

Features

  • Resolve fonts from any npm package containing CSS (e.g., @fontsource/*).
  • Automatically fix relative URLs in CSS to absolute CDN URLs.
  • Supports custom package, version, and file path.

Usage

import { createUnifont, providers } from 'unifont'

const unifont = await createUnifont([providers.npm()])

// Resolve from default convention (@fontsource/font-name)
await unifont.resolveFont('Roboto')

// Resolve from specific package
await unifont.resolveFont('Custom Font', {
  options: {
    npm: {
      package: 'my-font-pkg',
      version: '1.0.0',
      file: 'dist/style.css'
    }
  }
})

@danielroe danielroe merged commit f1b8f21 into unjs:main Feb 13, 2026
4 checks passed
@florian-lefebvre
Copy link
Copy Markdown
Collaborator

Awesome! It would be great if you could update the readme to document this provider, like others

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.

add 'npm' provider

3 participants