USWDS - Feature: SASS/CSS Documentation Update

[hammad-awan]

Is your feature request related to a problem? Please describe.

I'm trying to use the uswds styles in an angular project and I am having problems getting it to work correctly using the css @layer keyword. I am able to wrap it in a layer, but the layer precedence does not take affect correctly. If I specify the following in the styles.scss file:

@forward "uswds-theme";

@layer uswds, layer2, layer3;

The layer precedence should be in reverse order, i.e., layer3, layer2, then uswds styles should apply that order.

However, because of the forward which needs to appear first in styles.scss which wraps uswds styles in the uswds layer the latter is seen as the highest precedence.

Describe the solution you'd like

Provide documentation on how to do this.

Describe alternatives you've considered

No response

Additional context

No response

Code of Conduct

• I agree to follow this project's Code of Conduct.
• I checked the current issues for duplicate feature requests.