Skip to main content

Introduction to storybook

Storybook is being leveraged to mock out visual React components. The latest version of the design system can be found at this URL.

To run storybook, use this command:

npm run storybook

UI categories​

Storybook is broken into several categories:

  • Button: These are the button elements that appear in the project in various forms. They primarily are the Button component in the project but can also be icons.
  • Cards: These are the main container elements in the project. Each item represents a live component in their current form in the project.
  • Primitives: These are the basic styling of base HTML components.
  • Nav: This is the main navigation bar for the project. There are two states, when there is no user logged in and when a user is logged in.
  • Footer: This represents the various footers for the project.
  • Homepage: This is the main component for the project homepage and shows the home page in its current form.
  • Miscellaneous: These are components that currently don't fit neatly into the above categories.

Making changes to storybook​

This section details how to make changes to Storybook, mainly creating new categories or UI elements.

Adding a new category​

To add a new category, a new file needs to be added to /stories. Please follow the naming convention of *Previous File Number + 1*-*Name of Story Capitalized*-stories.js when creating a new file. In the file ensure you have this code in the file:

export default {
    title: "*Name of category*"
};

Adding a new UI element​

To add a new UI element to to an existing category, add the following code to that category's file:

export const *Name of UI Element* = () => (

);