For a full migration guide, please visit the documentation.

BREAKING CHANGES

• Variable fonts are now split into separate packages. #589

// Before
import "@fontsource/roboto-flex/variable.css";

// After
import "@fontsource-variable/roboto-flex";

• Variable font family names have been corrected. #385

// Before
body {
    font-family: "Roboto FlexVariable", sans-serif;
}

// After
body {
    font-family: "Roboto Flex Variable", sans-serif;
}

• Renamed variable font files to remove wghtOnly suffix. #388
• Full Sass integration rewrite. #153 #356 #419 #492 #519
• Remove custom icon classes from Material Icons. #532
• Rename @fontsource/material-icons-rounded to @fontsource/material-icons-round. #363
• Add new license metadata that changes the license property in metadata.json. #156

Features

• Customizable font-display property using CSS variables. #121
• Include LICENSE file in each package. #156
• The entire project has been moved into a CLI tool. #562
• Rewrite custom packager to be included into the CLI. #501

Fixes

• Include subset specific italic files. #289
• Variable fonts now support numbered subsets. #548

Documentation

Brand new website has been released! Please note that it is very rough around the edges and we would appreciate PRs to help improve it! #558

Huge shoutout to jsDelivr for sponsoring the design for the new website and Fly.io for sponsoring the hosting!

4.x Release

Features

• Added unicode.json which contains the unicode subset data for the CSS unicode-range selector. This will be used for the upcoming API. #271

Fixes

• Resolve regressions (#353) caused by Google API tweaks.
• Incorrect CSS output from SCSS mixin for src urls. #416

Documentation

• Updated package changelogs to redirect to the main repository changelog to ensure there are no inconsistences. #269

Features

• Changed weight metadata from a string array to number array. e.g. ["400"] [400] #240

• Removed local font names in CSS selector of src: which should cut down on inconsistencies of OS installed fonts. #240

Fixes

• Stop serving variable fonts in normal packages, which should lead to smaller bundle sizes and resolve duplicated imports of certain fonts. #240

Features

• Added 'category' key to metadata.json. #189

Fixes

• Update dependencies. #187

Documentation

• New website. #186 #188 #191 #192 #193 #194 #195 #196 #197 #198
• Update READMEs with new information. #199
• GitHub Actions Git configs changed to 'fontsource-bot'. #200
• Update dependencies. #207 #209
• Add NPM and GitHub links to each Font Preview page. #210

Miscellaneous

• Add testing and improve local build speeds. #222
• Typescript Migration. #229

Features

• Added default variables to SCSS mixins. #144
• Added $fontDir variable to SCSS mixins. #146
• Added variable font support and $defSubset variable to SCSS mixins. #147

Fixes

• Removed all default variable flags from SCSS mixins till further notice to resolve errors relating to importing multiple fonts. #155
• Resolved incorrect unicodeMap numeric subset names that linked to the wrong files. #167
• Update Material Icons #177
• Apply previous SCSS Generic updates #178
• Update dependencies #168 #169

Documentation

• Changed package.json descriptions to something more mature. #148
• README updates for Sass usage. #173

Features

• Added customisable SASS support through mixins for more flexible user setups. #64 #122

Fixes

• Major refactor to organise the templates and generic packager. #120

BREAKING CHANGES

• Package names have been renamed from fontsource-<font name> to the safer, more authentic scoped format @fontsource/<font name>. That means all packages will need to be reinstalled with yarn add @fontsource/<font name> or npm install @fontsource/<font name> with imports updated to the new package such as import @fontsource/open-sans/400-italic.css. #108

• import @fontsource/<font name>/<weight>.css now only contains normal style variants of fonts. The -normal.css files throughout the respository have been removed. Importing italic variants remain the same via import @fontsource/<font name>/<weight>-italic.css. Please see #88 for more details. #112

Features

• All non-Google fonts now have weight specific files that match 3.0.x as they previously were only importable via subsets. Simply use as normal with import @fontsource/<font name>/<weight>.css. #92 #115

Fixes

• Add publishConfig to package.json templates for scoped packages to successfully publish. #118
• Generate index.css for fonts that do not have weight 400. #119

3.x Release

Features

• Initial variable font support for Google Fonts. Supported fonts can be found here with their package README's explaining installation instructions. #103

Fixes

• Resolve incorrect filename generation for oblique/slnt variable fonts. #106 #109
• Prevent full variant variable CSS files to be generated for fonts that do not have any extra axes. #110

BREAKING CHANGES

• import fontsource-<font name> or index.css no longer defaults to contain ALL weights and styles for a font. It now only contains weight 400 with all styles included. This was changed to prevent fonts, such as Noto Sans JP, to counter-intuitively generate 1MB+ CSS files with the new unicode-range feature. Simply choose the necessary weights and styles from now on with import fontsource-<font name>/<weight>.css or import fontsource-<font name>/<weight>-<style>.css. #37 #42

• TTF/OTF support has been removed due to NPM package size limitations. Browser compatability goes as low as: caniuse #44

Features

• Added unicode-range CSS selector to all fonts. It is no longer necessary for individual subsets to be defined when importing CSS files but backwards compatability remains. Use import fontsource-<font name>/<weight>.css or import fontsource-<font name>/<weight>-<style>.css to leverage the new feature from now on. #37
• Added package.json rebuilder. #43
• Added force rebuild to Google packages. #37
• Added force rebuild to non-Google packages. #42
• Autogenerate FONTLIST.md and added FONTLIST.json. #58
• Copy CHANGELOG.md to every individual package. #41

Fixes

• Adjusted templates.js to add more relevant fields to package.json #37
• Resolved subsets not correctly being identified when packaging files through the generic packager. #45

2.x Release

Features

• Added TTF/OTF support for every package for older browser compatability. #33
• Refactored entire API source from majodev/google-webfonts-helper to fontsource/google-font-metadata for future expandability. #33

Fixes

• Add Yarn resolution to resolve Lerna publish errors. f6e7b1f

Features

• Added metadata.json files to each package that contains useful data that allows Fontsource or external users to leverage to pull information from. #26 #27 #28
• Account for rare possible instance of oblique font-style #26

Fixes

• Correct src: locals() in CSS generation to reflect upstream source accurately. #10 #11
• Resolve incorrect SCSS documentation + general improvements #23
• Ensure no old files remain from a font update #24
• Allow index.css generation for fonts without latin subset #25

• Main release.

These occur when an automatic update is pushed from a source, such as Google, or Fontsource may apply patches. Due to version mismatching and lack of accurate tracking, a specific version for a Fontsource patch cannot be logged into the changelog. Note that Google may push breaking changes on their end to individual fonts which Fontsource cannot predict for.

Minor (0.x.x)

These will always contain changes from Fontsource's end.

5.x Release