NHS.UK React Components

• NHS.UK React Components
  • Coming from 0.x?
  • Installation
  • Usage
    • Storybook
  • Maintainers
    • Preparing Releases

NHS.UK Frontend ported to React

Coming from 0.x?

If you're coming from versions of the library prior to 1.0.0, please give this wiki page a brief read, as there a number of changes between 0.x release and the 1.0 release.

Installation

You can install this package using either yarn or npm.

npm install --save nhsuk-react-components
# Or
yarn add nhsuk-react-components

Usage

import React, { PureComponent } from 'react';

// You can import components from the global module
import { Button } from 'nhsuk-react-components';

// Or you can import components directly
import Button from 'nhsuk-react-components/lib/components/button';

class GetStartedButton extends PureComponent {
  render() {
    return <Button>Click Me!</Button>;
  }
}

Storybook

A storybook containing all of the components and their usage can be found here.

Maintainers

We're currently looking for new maintainers! If you have knowledge of React and would be willing to help maintain this library, you can email me (Thomas Judd-Cooper) here.

• Thomas Judd-Cooper (GitHub)
• Sam Brown (GitHub)
• Luke Pearson (GitHub)

Preparing Releases

Releases run in CI using github actions.

To prepare a release create a new release TAG in github with your release version.

NPM_TOKEN should be stored in the repositories secrets in GitHub

• Create a new release with a tag like major.minor.patch against main.
• If the change is a beta then select pre-release as true, this will make the tag point at beta. Otherwise the tag will be latest.