Ontario Design System React Component Library

Package moved to @ongov namespace

This npm package has moved to a new namespace, the @ontario-digital-service/ontario-design-system-component-library-react has moved to @ongov/ontario-design-system-component-library-react. Package names are not changing - just the namespace.

Please make sure to update your projects to the new versions of the packages under @ongov so you will continue to receive updates. Packages under @ontario-digital-service will no longer be updated.

• Introduction
• Installation and usage
• Support

Introduction

This library was generated using Stencil's React output target dependency. It is based off the Ontario Design System Component Library built using Stencil. For more information, find it on NPM.

Installation and usage

To find documentation on individual web components in this component library, please download and refer to our component documentation.

To use the Ontario Design System React component library, follow these steps:

1. Install the NPM package.

   npm install --save @ontario-digital-service/ontario-design-system-component-library-react

2. Import the desired components from the component library.

   import { OntarioButton } from '@ontario-digital-service/ontario-design-system-component-library-react';
   import { OntarioBlockquote } from '@ontario-digital-service/ontario-design-system-component-library-react';

Usage

You can now use the React components in your component and template files.

<OntarioButton type="primary">Click me!</OntarioButton>

<OntarioBlockquote
	attribution="Survey respondent"
	quote="Access to high-quality child care is an issue that impacts our entire society."
></OntarioBlockquote>

Local assets

Along with the components, the local assets (logos, fonts, etc.) need to be copied into your project so that they are available for bundling upon building your React application.

The assets in the NPM package are located at @ontario-digital-service/ontario-design-system-component-library-react/dist/assets, and should be copied to your public assets folder.

In a standard React application this can be done in a number of ways. One way is to use the copyfiles NPM package, which you can with any operating system:

copyfiles -E -f "node_modules/@ontario-digital-service/ontario-design-system-component-library-react/dist/assets/*" src/assets

Another way is to add scripts to copy the assets in your package.json file. For example:

"prebuild": "npm run copy:assets",
"copy:images": "copyfiles -E -f \"node_modules/@ontario-digital-service/ontario-design-system-component-library-react/dist/component-library/assets/images/**\" src/assets",
"copy:favicons": "copyfiles -E -f \"node_modules/@ontario-digital-service/ontario-design-system-component-library-react/dist/component-library/assets/favicons/**\" src/assets/favicons",
"copy:fonts": "copyfiles -E -u 6 \"node_modules/@ontario-digital-service/ontario-design-system-component-library-react/dist/component-library/assets/fonts/**/*\" src/assets/fonts",
"copy:assets": "npm run copy:images && npm run copy:favicons && npm run copy:fonts"

Support

Contact us at [email protected] for assistance with this package.