@namchee/astro-subfont

Astro Fontsubs

Astro integration of subfont library. Generate optimized font subset for your Astro site.

Prerequisites

1. Astro 4.x

Installation

You can install this package through astro add

# Using pnpm
pnpm astro add @namchee/astro-subfont

# Using npm
npx astro add @namchee/astro-subfont

# Using yarn
yarn astro add @namchee/astro-subfont

# Using bun
bunx astro add @namchee/astro-subfont

Additionaly, you can also install this package manually

# Using pnpm
pnpm install -D @namchee/astro-subfont

# Using npm
npm install -D @namchee/astro-subfont

# Using yarn
yarn add -D @namchee/astro-subfont

# Using bun
bun add -D @namchee/astro-subfont

After installation, you can integrate this integration in your Astro config

import { defineConfig } from 'astro/config';

import { subset } from '@namchee/astro-subfont';

export default defineConfig({
  integrations: [
    subset(),
  ]
})

Configuration

This integration can be configured by passing a configuration object with the following properties:

Name	Type	Default	Description
whitelist	string	''	Additional characters to be included in font subsets. Use this option if you find some characters are missing after subset.
optimizeVariableFonts	boolean	true	Allow optimization of variable font features, such as weights and axes. Experimental.
inline	boolean	false	Inline the optimized fonts directly in the @font-face declaration.
dynamic	boolean	false	Analyze webfonts usage dynamically by running headless browsers.
debug	boolean	false	Enable verbose output to stdout.

Acknowledgements

All credits goes to Munter for the awesome subfont library.