Install Storybook

sb init is not made for empty projects

Storybook needs to be installed into a project that is already set up with a framework. It will not work on an empty project. There are many ways to bootstrap an app in a given framework, including:

Storybook will look into your project's dependencies during its install process and provide you with the best configuration available.

The command above will make the following changes to your local environment:

  • πŸ“¦ Install the required dependencies.
  • πŸ›  Setup the necessary scripts to run and build Storybook.
  • πŸ›  Add the default Storybook configuration.
  • πŸ“ Add some boilerplate stories to get you started.

Depending on your framework, first, build your app and then check that everything worked by running:

It will start Storybook locally and output the address. Depending on your system configuration, it will automatically open the address in a new browser tab, and you'll be greeted by a welcome screen.

Storybook welcome screen

There are some noteworthy items here:

  • A collection of useful links for more in-depth configuration and customization options you have at your disposal.
  • A second set of links for you to expand your Storybook knowledge and get involved with the ever-growing Storybook community.
  • A few example stories to get you started.


Below are some of the most common installation issues and instructions on how to solve them.

If all else fails, try asking for help

Now that you installed Storybook successfully, let’s take a look at a story that was written for us.

What's a story?
Learn how to save component examples as stories
Add Storybook to your project in less than a minute to build components faster and easier.
Learn Storybook with in-depth tutorials that teaches Storybook best practices. Follow along with code samples.
The MIT License (MIT). Website design by @domyen and the awesome Storybook community.
Get news, free tutorials, and Storybook tips emailed to you.

Maintained by
Continuous integration by
Hosting by