Storybook CLI (Command Line Interface) is the easiest way to add Storybook to your project.
Go to your project and run:
cd my-app
npx sb init
In addition to init
, the CLI also has other commands:
add
- add an addon and register itinfo
- print out system information for bug reportsmigrate
- run codemods to migrate your code
See the command-line help with -h
for details.
Yarn support
The CLI supports yarn. If you have installed yarn in your system and your project has a yarn.lock
file, it'll detect it and use yarn
to install dependencies.
If you don't want to use yarn
always you can use the --package-manager
option like this:
npx sb init --package-manager=npm
If you would like to force a particular version of yarn, you can use the --package-manager
flag with a value of yarn1
or yarn2
.
PNPM support
The CLI supports pnpm. If you have installed pnpm in your system and your project has a pnpm-lock.yaml
file, it'll detect it and use pnpm
to install dependencies.
If you don't have a lock file and would like to force pnpm to be used, you can use the --package-manager
option like this:
npx sb init --package-manager=pnpm
Flow support
It also supports flow files. By default, jscodeshift, the tool used to transform the source files, uses babel to read the files. To be able to transform any flow annotated file, you need to use the flow parser.
npx sb init --parser flow
For more information visit: storybook.js.org
If the CLI cannot detect your project type, it will ask you. You can also force it to use a particular project type:
npx sb init --type <type>
Where type is one of the project types defined in project_types.ts