USWDS 3.0.0 Beta 1

What's new in 3.0.0 Beta 1

This release is up-to-date with USWDS 2.12.2 and incorporates more of our new directory structure and some of the Pattern Lab → Storybook migration.

What's in this release

• Drop support for IE11 [IN PROGRESS]
• Reorganize internal directory structure [IN PROGRESS]
• Use Sass Module Syntax [Coming in a later release]
• Publish component packages [Coming in a later release]

Updating from stable

Install on your project with npm install --save uswds@beta

If you're using includePaths in sass, you'll need to update the path from ./node_modules/uswds/dist/scss to /node_modules/uswds/dist/scss/stylesheets.

Example using USWDS-Gulp:

// OLD
.pipe(
  sass({
    includePaths: [
      `sass/styles.scss`,
      `${uswds}/scss`,
      `${uswds}/scss/packages`,
    ],
  })
)

// NEW
.pipe(
  sass({
    includePaths: [
      `sass/styles.scss`,
      `${uswds}/scss/stylesheets`,
      `${uswds}/scss/stylesheets/packages`,
    ],
  })
)

⚠️ Breaking changes

Updated package names
Only affects those using USWDS packages. The required and global partials are now prefixed with uswds-.

For example:

@import 'packages/required';
@import 'packages/global';

Required and global SCSS packages have been updated to:

@import 'packages/uswds-required';
@import 'packages/uswds-global';

Security

0 vulnerabilities in regular dependencies (dependencies for USWDS projects installed with npm install uswds)

Internal only: 93 vulnerabilities (26 moderate, 65 high, 2 critical) in devDependencies (development dependencies)

Release ZIP SHA-256 hash: 4226f63ef09f7064bff4e169b3bda8d94f1da2ce866592302bca7b84bf91018f