Course Welcome

An Intro to Component Libraries and Design Systems

Syllabus

Environment setup

Introduction

Which React Components to Build? An Atomic Design Guide

Which UI Elements Should be Turned Into React Components?

Choose React Dependencies for a Maintainable Component Library

Shared components

How to Host an NPM Package in GitHub for Free

How to Add Storybook to React to Test Component Library Locally

How to Keep React Code Consistent With Prettier and ESLint

Library creation

Build a Custom React Button Component With forwardRef API

Build a Custom Design System With React Styled Components

Validate React Props With PropTypes and TypeScript

Shared component patterns

How to Design Compound Components With React Context

How to Design Custom React Field Components With useUniqueID

How to Extend Styled Component Styles With New Style Props

Advanced patterns

How to Test React Component Libraries With ts-jest

How to Build Tests For React Button Components

How to Build Accessibility Tests For React Field Components

Component testing

The Best Ways to Bundle React Modules Into Packages

Build process

Setting Up Continuous Integration for a React Component Library With GitHub Actions

Deployment and automation

This course will teach you how to create a flexible, private, enterprise-grade component library using React.

Since its introduction in 2013, React has become one of the [most used front-end frameworks](https://2019.stateofjs.com/front-end-frameworks/). Its component-based architecture and flexibility has made it the framework of choice for those needing to share code across multiple teams.

However, the same flexibility that has helped React grow in popularity also creates many challenges when creating shared assets and tooling. Some of the most commonly asked questions include:

- What components should be shared?
- How do I choose which dependencies to include in my library?
- Which component APIs and design patterns allow for the most flexibility?
- How do I document and build my components?
- How should I be testing my library?
- Where do I deploy my components for internal use?

This course will teach you how to create a flexible, private, enterprise-grade
component library using React.

The newline Guide to Building a Company Component Library

How to identify potential shared components in an existing codebase

Importance of choosing your libraries dependencies

How to create an NPM library from scratch with TypeScript and Storybook

Basic and advanced API patterns for shared components

How to build and deploy a modern NPM package to a private NPM registry

While developing our library we need the ability to build, test, and document our components in isolation. 

 is a tool that allows us to develop our components locally while
mimicking a product environment.

In this lesson we will be creating a new Storybook environment in our codebase where we can can document and visually test our components.

To add Storybook to our library we can use the 

. The CLI will look at our dependencies and create a default Storybook configuration for a React and TypeScript codebase.

This command will create and modify several files:

 command to view the newly created Storybook environment:

The initialization process creates several demo components and stories. We need to update these to reference our existing 

First, remove all of the example stories created during the initialization process.

---
title: How to Add Storybook to React to Test Component Library Locally
privateVideoUrl: https://fullstack.wistia.com/medias/5wqnya0oad
---

While developing our library we need the ability to build, test, and document our components in isolation. [Storybook](https://storybook.js.org/) is a tool that allows us to develop our components locally while
mimicking a product environment.

In this lesson we will be creating a new Storybook environment in our codebase where we can can document and visually test our components.

## Initialize Storybook

To add Storybook to our library we can use the `Storybook CLI`. The CLI will look at our dependencies and create a default Storybook configuration for a React and TypeScript codebase.

```bash
npx sb@6.5.7 init
```

This command will create and modify several files:

-   `.storybook`

    -   `main.js` (main configuration file)
    -   `preview.js` (customize the presentation of components)
-   `src/stories`

    -   `*.stories.tsx` (component documentation follows this naming convention)
-   `package.json`

    -   Storybook dependencies are added
    -   `storybook` and `build-storybook` NPM scripts are added

Run the `storybook` command to view the newly created Storybook environment:

```bash
npm run storybook
```

![default storybook instance](https://d2uusema5elisf.cloudfront.net/courses/newline-guide-to-building-a-company-component-library/module_03/lesson_03.02/public/assets/default-storybook.png)

## Story creation

The initialization process creates several demo components and stories. We need to update these to reference our existing `Button` component.

First, remove all of the example stories created during the initialization process.

```bash
rm -rf src/stories/*
```

Next, we will create a new `Introduction.stories.mdx` file which will include the content of our libraries `README.md` file.

```md


import { Meta, Description } from '@storybook/addon-docs/blocks';
import README from '../../README.md';

I'm getting We were not able to detect the right builder for your project. Please select one:It only offers Vite and Webpack 5, but the course uses Rollup later on, correct?

James Lang

Make sure that you're installing the correct version of storybook that matches the course code assets.  In this instance, I believe you should be using storybook@6.5.9 

Learn

The newline Guide to Building Your First GraphQL Server with Node and TypeScript

Teach

Amelia Wattenberger

Author of Fullstack D3

Community

The newline Guide to Building a Company Component Library

Module 1: Introduction

Introduction:

Start Here

Introduction: (2:36)

Course Welcome

Introduction: (1:44)

An Intro to Component Libraries and Design Systems

Introduction: (1:23)

Syllabus

Introduction: (0:49)

Environment setup

Module 2: Shared components

Lesson 1: (2:04)

Which React Components to Build? An Atomic Design Guide

Lesson 2: (4:30)

Which UI Elements Should be Turned Into React Components?

Lesson 3: (2:22)

Choose React Dependencies for a Maintainable Component Library

Module 3: Library creation

Lesson 1: (4:37)

How to Host an NPM Package in GitHub for Free

Lesson 2: (4:46)

How to Add Storybook to React to Test Component Library Locally

Lesson 3: (4:55)

How to Keep React Code Consistent With Prettier and ESLint

Module 4: Shared component patterns

Lesson 1: (7:49)

Build a Custom React Button Component With forwardRef API

Lesson 2: (13:39)

Build a Custom Design System With React Styled Components

Lesson 3: (2:05)

Validate React Props With PropTypes and TypeScript

Module 5: Advanced patterns

Lesson 1: (2:09)

How to Design Compound Components With React Context

Lesson 2: (15:48)

How to Design Custom React Field Components With useUniqueID

Lesson 3: (7:51)

How to Extend Styled Component Styles With New Style Props

Module 6: Component testing

Lesson 1: (2:45)

How to Test React Component Libraries With ts-jest

Lesson 2: (5:13)

How to Build Tests For React Button Components

Lesson 3: (4:52)

How to Build Accessibility Tests For React Field Components

Module 7: Build process

Lesson 1: (2:55)

The Best Ways to Bundle React Modules Into Packages

Module 8: Deployment and automation

Lesson 1: (3:18)

Setting Up Continuous Integration for a React Component Library With GitHub Actions

How to Add Storybook to React to Test Component Library Locally