@chanzuckerberg/[email protected]

17.0.0 (2025-11-25)

Storybook

Note

For each item below, expand the section to learn more about mitigation notes, tips, and tricks on how to migrate to v17

⚠ BREAKING CHANGES

move to reference-based font declarations (#2312)

• EDS no longer provides built-in font files for the theme
• Instead, if you need to use custom fonts for the default theme (Common Theme (Light)), you must import them from your project, or a font file provider like Adobe, Google, etc.

To fix build errors, remove any imports of font.css from your project, as this file is no longer provided:

-import "@chanzuckerberg/eds/fonts.css";

Add in new imports to reference the font files used:

+<!-- Example Handling for font-family-1 as a local file --> 
+<link rel="stylesheet" href="https://local-domain.org/fonts.css">
+
+<!-- Example Handling for font-family-2 as an adobe font -->
+<link rel="stylesheet" href="https://use.typekit.net/<example>.css">
+
+<!-- Example Handling for font-family-3 as a google font-->
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=<test-font-family...>" rel="stylesheet">

WARNING: When using theming, make sure the font names used in the tokens exactly matches the names returned from the font provider, or defined in a local fonts.css file import.

This has been added to the project README.

Features

• move to reference-based font declarations (#2312) (9554808)
• update base theme to use common theme (light) (#2310) (0722431)

Bug Fixes

• Button: update token usages to match design (#2316) (0523295)
• Checkbox: update token usages to match design (#2315) (6ac87de)
• Radio: update token usages to match design (c954381)
• update input field styles to match design (#2318) (cde73b0)
• update notification components to match designs (#2317) (d505b71)