USWDS 3.0.0 Beta 3

What's new in 3.0.0 Beta 3

This release builds on Beta 2 and is up-to-date with USWDS 2.13.1.

This release is the first Sass Module release on the 3.0 Beta Branch.

• Components now use SASS module syntax
• Old import style still works
• ⚠️ Updating shouldn't require any changes from user. @import syntax should still work as expected.

Updated package names

packages/required → packages/uswds-core

What's in this release

• Drop support for IE11 [COMPLETE]
• Reorganize internal directory structure [COMPLETE]
• Use Sass Module Syntax [COMPLETE]
• 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

From Beta 1

None

From Stable

Updated package names
Only affects those using USWDS packages. The required package is not called uswds-core and the global package is now uswds-global.

For example:

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

Required and global SCSS packages have been updated to:

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

Security

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

Internal only: 54 vulnerabilities (2 low, 21 moderate, 31 high) in devDependencies (development dependencies)

Release ZIP SHA-256 hash: c7aea4cbccae675b5a43d8d32c38538ffecc3fa5f12ddf86c117541c4ee7b403