QPP-Style React

This directory contains react implementations of the components for QPP.

Github Branch and Pull Request process

1. Create branch off main and create a Pull Request into main for the feature.

   Example Branch Name: feature/QPPXX-XXXX_make_icon_better

2. Once merged into main, create release branch from main.
3. Name the new branch release/x.xx.x
4. Run the version bump:

cd qpp-style/react
npm version --no-git-tag-version patch

Example Commit Message:

x.xx.x release

5. Create a pull request against main with the PR Title: x.xx.x release Example PR
6. Enter the change in the description of the pull request i.e.:

   Added new svg for Icon Name

Generate an NPM token with Publish permissions

1. If you do not already have an access token, sign in to npmjs.com and navigate to access tokens.
2. Click generate new token.
3. Select publish under type.
4. Copy the npm token and set its value as the environment variable: NPM_TOKEN

export NPM_TOKEN={npm_token}

Publish the react qpp-style npm package (used by both react and angular)

cd qpp-style/react
npm i
npm publish

7. Once published successfully, merge into main.

The Side Nav contains multiple item array types: divider, container, linkBack, linkHome, practiceDetails, individualDetails, linkDrawer, custom, chart, and switchLink.

| Item Array Type | Description | |-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | divider | element that is located above and below the practice container. | | container | gets Dynamic Content of multiple items and contains the linkDrawer item. Level One and Level Two content are located in this container. | | linkBack | that links the user back to a URL. This uses a chevron Left icon. | | linkHome | tag element which sends the user back to the “Account Home” page /user/submissions. This uses the home icon SVG and is located at the top of the side nav. | | practiceDetails | element with the class name practice-container. Inside this container is the element which includes the Practice Name and the element which is the Practice Tin. The Practice Tin shows either the CPC+ ID, PCF ID, APM Entity ID, VG ID, or Practice Tin. | | individualDetails | element with the class name “individual-container”. This parent element contains two other elements which are the Individual Name and the Individual NPI. | | linkDrawer | This is the most complex item type. This item displays the Level One and Level Two elements which contain navigation links depending on each page as well as specific SVG icons. Depending on the page there can be multiple links to the user can access quickly using the side nav. | | custom | This option is for sanitized HTML content. This custom HTML will be cleaned of any potentially harmful elements that could compromise the security of the web app. | | chart | This option uses the ScoreChart component to display Chart Data on the Side Nav. This data includes categories from Quality Measures, Advancing Care Info, Promoting Interoperability, Improvement Activities, and Cost. | | switchLink | This is an implementation of the “Switch Practice” button for the Side Nav. Clicking 'Switch Practice' will take the user back to the TIN list for the part of the application they are viewing. |