About USWDS

Release notes

The Design System is an ever-evolving product. We’ve been listening to your feedback and using it as a basis for improvements and additions.

Here you’ll find our release notes — summaries of bug fixes, new features, and other updates introduced in each release.

Have suggestions for a new feature or bug fix? Open an issue in our repo.

Version 2.0.0 Beta 4

November 14, 2018

Note: Items with a ⚠️ icon are potentially breaking changes

Internal

Bug fixes

Improvements

This is a big one with lots of potentially breaking changes. See the pull request and the v2 documentation for a more complete record of the changes and the final palette names.

⚠️ If you’ve experimented with using palettes for your utility classes, you will need to update to the new names or you will get Palette not found in the registry errors when you compile.

The .usa-prose component allows developers to style unclassed elements within a scoped container. However, this could result in unpredictable behavior (like style specificity errors) if other components are inside in a usa-prose container. Now, usa-prose only affects direct children (using the > selector). See the pull request for more details and context.

⚠️ Make sure any content you want styled with usa-prose is a direct child of usa-prose — this could mean adding usa-prose to grid-col or section elements previously styled simply by being inside usa-prose.

Documentation


Version 2.0.0 Beta 3

October 29, 2018

Bug Fixes

Improvements

Documentation


Version 1.6.9

October 15, 2018

Updated

Fixed


Version 2.0.0 Beta 2

October 15, 2018

Internal

Additions

Updates

Bug fixes

Improvements

Documentation


Version 2.0.0-beta

October 01, 2018

USWDS 2.0 is a major rewrite of the entire project. The most notable changes are summarized below, followed by more specific changes to relevant components.

New ✨

CSS applied to classes not HTML

$theme-content-styles will add base typography styles inside .usa-prose class, as global elements applied to base HTML, or none at all.

Element styles added to scoping

New or updated elements and classes

*All former elements will need to use these classes to display properly.

By component

This list highlights key changes by component between v1.x.x and v2.0.0.

Typography

Grids

Buttons

Tags

Tables

Alerts

Accordions

Forms

Form controls

Form templates

Side navigation

Headers

Footers


Version 1.6.8

August 06, 2018

Added

Fixed


Version 1.6.7

July 23, 2018

Fixed

Changed


Version 1.6.6

June 13, 2018

Fixed


Version 1.6.5

June 13, 2018

Fixed


Version 1.6.4

June 04, 2018

Fixed

Fix margin bug on h6-level headings (#2531)


Version 1.6.3

May 07, 2018

Fixed


Version 2.0.0-alpha

August 13, 2018

Added

Fixed


CSS applied to classes not HTML

$theme-content-styles will add base typography styles inside .usa-prose class, as global elements applied to base HTML, or none at all.

Element styles added to scoping

New or updated elements and classes

*All former elements will need to use these classes to display properly.


Version 1.6.2

April 23, 2018

Fixed


Version 1.6.1

March 26, 2018

Fixed


Version 1.6.0

March 12, 2018

Changed

Fixed


Version 1.5.0

February 26, 2018

Added

Changed

Fixed


Version 1.4.6

February 12, 2018

Removed

Fixed


Version 1.4.5

January 23, 2018

Changed


Version 1.4.4

December 18, 2017

Fixed


Version 1.4.3

November 20, 2017

Changed

Removed

Fixed


Version 1.4.2

November 02, 2017

Changed

Removed

Fixed


Version 1.4.1

October 06, 2017

Header Fixes

Documentation Updates

Fixed bug with headless Chrome tests


Version 1.4.0

September 29, 2017

Accessibility improvements

Visual changes

Other changes

New features for core development


Version 1.3.1

August 22, 2017

Bug Fixes


Version 1.3.0

July 21, 2017

New Features

Bug Fixes

Kudos

Thanks @colinalford for submitting a pull request to add grid offsets to the Standards!

Thanks @JJFranko for help figuring out the root cause behind #1993!


Version 1.2.1

June 07, 2017


Version 1.2.0

June 06, 2017

This release marks a complete rewrite of our JavaScript to make interactive components more friendly with third-party frameworks such as React and Angular.

:warning: If you’re upgrading from a previous version and you use the Standards JS modules in a custom bundle, please read the migration guide. (If you’re using the static JS or don’t understand what any of this means, then you can safely skip the guide.)

New features

Bug fixes

Other changes


Version 1.2.0 release candidate 1

May 24, 2017

This release marks a complete rewrite of our JavaScript to make interactive components more friendly with third-party frameworks such as React and Angular.

You can install this pre-release with npm:

npm install --save uswds@1.2.0-rc1

Please let us know if you run into any troubles!

:warning: If you’re upgrading from a previous version and you use the Standards JS modules in a custom bundle, please read the migration guide. (If you’re using the static JS or don’t understand what any of this means, then you can safely skip the guide.)

New features

Bug fixes

Other changes


Version 1.1.0

April 27, 2017

New features

Bug fixes

Other changes

Kudos


Version 1.1.0 pre-release

April 17, 2017

This is a v1.1.0 preview release. See #1796 for changes since v1.0.0.

You can install this pre-release with npm:

npm install --save uswds@1.1.0-pre

Please let us know if you run into any troubles!