What’s new

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 1.6.3

May 07, 2018

Fixed


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!


Version 1.0.0

February 23, 2017

This is our first official major release. Read about our new release process and how we are updating the workflow to formally follow semantic versioning.

Fixed

Changes

We’ve made a couple of changes to our npm configuration:

The following are changes to our build tools and process that have no direct impact on the code itself:

Kudos

We’d like to thank all the contributors who worked on our current release! We appreciate your service and all the time you spent making the Standards even better. Big kudos to the following folks:

If you have questions about these upcoming changes, please feel free to email our team at uswebdesignstandards@gsa.gov.


Version 0.14.0

December 16, 2016

Fixed

Changed

If you have questions about these upcoming changes, please email our team.

Kudos

We’d like to thank all the contributors who worked on our current release! We appreciate your service and all the time you spent making the Standards even better. Big kudos to the following folks:

And thank you to everyone for your comments and feedback!

Full Changelog


Version 0.13.3

December 01, 2016

Fixed

Changed

If you have questions about these upcoming changes, please email our team.

Full Changelog


Version 0.13.2

December 01, 2016

⚠️ This release has a few known bugs:

We recommend upgrading to v0.13.3 of the Standards. If you are unable to do so, please use the attached uswds-0.13.2patch.css (un-minified) or uswds-0.13.2patch.min.css (minified) and uswds-0.13.2patch.map files on this release.

Changed

  1. The header component has been broken up into more modular pieces, each with their own JavaScript tests (see code changes here). Here is the breakdown of what has been changed:
    • header/mobile is now navigation
    • header/search is now search
    • To support testing, the navigation and search JS modules both export an off() function for removing listeners added by the top-level export.
  2. The utility functions for element classes (addClass(), removeClass(), and toggleClass()) have been replaced with a polyfill for the Element.classList property (see code changes here).
  3. Some of the SCSS files have been reorganized (see code changes here and here). See the deprecation notes (“Upcoming backwards incompatible changes”) below for more info.
  4. Our README now includes more helpful instructions for users on various platforms and fixes some formatting (see code changes here).

Upcoming backwards incompatible changes

We are planning to make the following changes to the Draft U.S. Web Design Standards in future releases. In keeping will semantic versioning conventions, we will never intentionally introduce breaking changes without updating the minor and major versions accordingly. Here are the upcoming changes:

  1. The Standards will no longer require jQuery or include it as part of the package you download. If you are using jQuery for other parts of your site, you will have to download it separately. It won’t come included in the Standards any more. We decided to make this change because we heard from our users that requiring jQuery for the WDS conflicted with other versions of jQuery they were already using.
  2. We have reorganized some of our SCSS “partials”, and will be removing the deprecated paths in a future release. If you import the USWDS into your own Sass or SCSS files, here is what you need to know:
    • We have replaced the SCSS all “entry point” with uswds, and set up an alias for all (_all.scss) to ease the transition for users of previous versions. Upgrade instructions:
      • replace @import 'all'; with @import 'uswds';, or
      • replace @import 'uswds/all'; to @import 'uswds/uswds';
    • We have deprecated the SCSS uswds/defaults partial in favor of uswds/variables, and added !default to all of our variables so that they can be selectively overridden by a previous import. Upgrade instructions:
      • remove @import 'core/defaults'; or @import 'uswds/core/defaults';
      • add @import 'core/variables'; if you don’t import it already
      • move your variable customizations before @import 'core/variables'; for consistency
      • remove any unmodified variable declarations from your customizations to avoid accidentally overriding future changes
    • uswds/core/grid-settings is no longer necessary, as the grid settings are all declared in uswds/variables. Upgrade instructions:
      • remove @import 'core/grid-settings'; or @import 'uswds/core/grid-settings';

If you have questions about these upcoming changes, please email our team.

Full Changelog


Version 0.13.1

October 06, 2016

NEW Page templates and government banners

This release includes the addition of two different page templates and government verification banners.

Upcoming backwards incompatible change

In the near future, the Draft U.S. Web Design Standards will no longer include jQuery as part of its package. Users will be required to include jQuery(v2.2.0+) when using the Standards. If you have questions about this upcoming change, please email our team at uswebdesignstandards@gsa.gov.

Fixed

Changed

Full Changelog


Version 0.12.1

September 09, 2016

This is a patch level release that adds missing images for the mobile version of the new headers component into the src directory. In version 0.12.0 they were added as part of the website/docs assets and not part of the package itself. Please use v0.12.1 in place of v0.12.0!

Full Changelog


Version 0.12.0

September 01, 2016

Updated to 0.12.1: Release 0.12.0 was missing some images for the new Headers component. You may run into issues using 0.12.0 on your project.

Please use version 0.12.1 in place of 0.12.0!

NEW Headers component

This release includes the addition of a headers component, which helps users identify where they are and provides them a quick, organized way to reach the main sections of a website. Check out our documentation to learn more about our most recently added component.

Upcoming backwards incompatible change

In the near future, the Draft U.S. Web Design Standards will no longer include jQuery as part of its package. Users will be required to include jQuery(v2.2.0+) when using the Standards. If you have questions about this upcoming change, please email our team at uswebdesignstandards@gsa.gov.

Fixed

Changed

Kudos

We’d like to thank all the contributors who worked on our current release! We appreciate your service and all the time you spent making the Standards even better. Big kudos to the following folks:

And thank you to everyone for your comments and feedback!

Full Changelog


Version 0.11.1

August 18, 2016

Fixed

Changed

Kudos

We’d like to thank all the contributors who worked on our current release! We appreciate your service and all the time you spent making the Standards even better. Big kudos to the following folks:

And thank you to everyone for your comments and feedback!

Full Changelog


Version 0.11.0

August 04, 2016

Accordion backwards-compatible changes

In this release, we’ve refactored the accordion code so that it is easier to use, less specific, and more concise. The accordion functionality from previous releases will still work and there are instructions on how to make the upgrade when it best suits the needs of your project.

Fixed

Changed

Kudos

We’d like to thank all the contributors who worked on our current release! We appreciate your service and all the time you spent making the Standards even better. Big kudos to the following folks:

And thank you to everyone for your comments and feedback!

Full Changelog


Version 0.10.0

July 21, 2016

We have been made aware that we didn’t explicitly outline a backwards-incompatible change for the accordion component in v0.9.4, and we’d like to apologize for any inconvenience this may have caused you or your team. In the release notes for 0.9.4, we’ve added directions on how to update your accordions with these changes when you make this upgrade.

Backwards-incompatible changes version

In this release, we’ve made a specific backwards-incompatible change to the the structure of the scss files. Prior to this release, users could update their project specific scss variables by changing the values in _variables.scss. This release removes that file and from the core import and will require users to manually add their application-specific Sass files.

Fixed

Changed

Kudos

We’d like to thank all the contributors who worked on our current release! We appreciate your service and all the time you spent making the Standards even better. Big kudos to the following folks:

And thank you to everyone for your comments and feedback!

Full Changelog


Version 0.9.6

July 14, 2016

Fixed

Changed

We love outside contributions!

The continued success of the Standards relies on contributions from folks like you. To make a contribution, file an issue in our repo (and do let us know if you have any questions).

View the full changelog here.