Turn a set of web fonts into one json file
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib Adding maxBuffer to child process Jan 6, 2014
test Update mime types. Mar 11, 2013
.gitignore v not much, but a working example. Mar 10, 2013
Gruntfile.js Added first unit tests. Mar 10, 2013
package.json Bump v number. Dec 8, 2013



Turn a set of web font files into JSON.

You probably want to run in using the associated grunt plugin: https://github.com/ahume/grunt-webfontjson


Sometimes you want more control over when and how web fonts are loaded in to your page. Sometimes you want to cache them in localStorage or indexedDB, decide exactly which point they are applied to the page, etc… That's difficult when you simply download a font file.


The package comes with an executable command, webfontjson

npm install -g webfontjson
webfontjson /path/to/config.json

Everything else is configured in a configuration file. Here's an example:

	"filename": "/my-project/json-fonts/MyriadPro.otf.json",
	"callback": "fontsLoadedCallback",
	"fonts": [
			"font-family": "WebFont-MyriadPro",
			"font-weight": "normal",
			"file": "/Library/Fonts/MyriadPro-Regular.otf",
			"format": "otf"
			"font-family": "WebFont-MyriadPro",
			"font-weight": "bold",
			"font-style": "italic",
			"file": "/Library/Fonts/MyriadPro-Bold.otf",
			"format": "otf"

The config is an array of files to create. It contains fields for the filename, the name of a callback function to wrap the JSON in, and a list of fonts to include in the file.

Each font in the list can contain the following values for a particular @font-face rule.

  • font-family (required)
  • format (required)
  • file (required)
  • font-weight
  • font-style
  • font-stretch
  • unicode-range
  • font-variant
  • font-feature-settings

For each font, the appropriate @font-face rule will be created and wrapped in a JSON wrapper for delivery into a web browser.