pds-toolkit-react

React Toolkit for the Pantheon Design System

This toolkit provides assets for use within a React project and a Storybook instance to preview the components.

Published Storybook

Toolkit philosophy and scope

The intent of this toolkit is to provide a React-based implementation of the Pantheon Design System (PDS) with a focus on semantics, accessibility, visual design, and user-interface design.

This toolkit should not contain processes or mechanisms used for data manipulation, business logic, or similar. Therefore, processes such as form handling, routing, and language translation should be handled within the application that is consuming the toolkit.

Each component will contain a documentation page within Storybook that provides usage notes, implementation instructions, and expected data structure for that particular component.

Content within components

Content should not live within components with a few exceptions — the Social Links component and the links in the legal section of the SiteFooter component. To maintain consistency between all of our digital properties, these links will originate from the design system.

Implementation instructions

The toolkit consists of a global stylesheet and React components. Both are required for the toolkit to function as intended.

The global stylesheet — pds-core.css — provides the base styles for the toolkit including foundations, utilities, and color variables. This stylesheet should be applied at the root of the application.

The React components are imported and used within the application as needed. Component-specific styles are imported and applied automatically when the component is used.

Components should be imported using named imports. For example:

import { Container, SidebarLayout } from '@pantheon-systems/pds-toolkit-react';

Avoid style conflicts

This toolkit is not intended to be used in conjunction with other CSS frameworks. Doing so may result in unexpected behavior and/or visual conflicts.