Composition allows you to embed components from any Storybook inside your local Storybook. It’s made for teams who adopt Storybook in multiple projects but can’t ensure that the projects have the same tech stack or share the same repo.
You can compose any Storybook published online or running locally no matter the view layer, tech stack, or dependencies.
storybook/main.js file add a
refs field with information about the reference Storybook. Pass in a URL to a statically built Storybook.
You can also compose Storybook that are running locally. For instance, if you have a React Storybook and a Angular Storybook running on different ports:
This composes the React and Angular Storybooks into your current Storybook. When either code base changes, hot-module-reload will work perfectly. That enables you to develop both frameworks in sync.
You can also compose Storybooks based on the current development environment. For instance if the project you're working has already a published Storybook, but also includes a version with cutting edge features not yet released you can adjust the composition based on that. For instance:
💡 Note: Same as with the majority of fields available within
refs field can also be a function and accept a
config parameter that contains Storybook's configuration object. See the related webpack documentation.
So far we've covered how we can use composition with local or published Storybooks. One thing worth mentioning as your Storybook will grow in time with your own stories, or through composition with other Storybooks, is that you can optimize the deployment process by including the following command in your workflow:
Using this command will generate a
stories.json file in the default build directory (
storybook-static) with information regarding your Storybook. Here's how it might look:
Once you add a reference to a Storybook deployed using this method, almost immediately you'll see all the stories and other relevant information displayed in the UI.
If required, you can also add additional arguments to this command. You can use the following to generate the
stories.json file to a custom directory:
Once the command executes it will look for a built Storybook in the
my-built-storybook-directory and create the
stories.json file in
If you need to use arguments, you'll need to use both of them, or the command will not be executed properly.