# css-library

The purpose of the CSS Library is to replace the current VA.gov style library (Formation) with styles and tokens based on [USWDS version 3](https://github.com/uswds/uswds). 

## Generate all files

To generate all tokens, stylesheets, and assets, run `yarn build`

## Stylesheets

To generate stylesheets, run `yarn build:stylesheets`

## Design Tokens

To generate all token files, run `yarn build:tokens`

The tokens generated by this library will be available in several different formats so that various tools and environments can use them.

### Adding a new token

1. Add the token name and value to the appropriate file in the `tokens/` directory. 
   - The token should be added to the appropriate category and should follow the existing naming convention.
   - For example: 

   ```json
   "vads-button-color-background-dark": {
     "*": { "value": "#000000" }
   }
   ```
2. Generate the token files by running `yarn build:tokens` in the `css-library` directory:
   - This should update the token files in the `dist/` directory.
   - Review the output in the `dist/` directory to ensure the token was generated correctly.
   
3. Commit all changes to the repository including the generated token files in the `dist/` directory.