title |
---|
Types of addons |
Each Storybook addon is classified into two general categories, UI-based or Presets. Each type of addons feature is documented here. Use this as a reference when creating your addon.
UI-based addons allow you to customize Storybook's UI with the following elements.
Panel addons allow you to add your own UI in Storybook's addon panel. This is the most common type of addon in the ecosystem. For example, the official @storybook/actions
and @storybook/a11y
use this pattern.
Use this boilerplate code to add a new Panel
to Storybook's UI:
<CodeSnippets paths={[ 'common/storybook-addon-panel-example.js.mdx', ]} />
Toolbar addons allow you to add your own custom tools in Storybook's Toolbar. For example, the official @storybook/backgrounds
and the @storybook/addon-outline
use this pattern.
Use this boilerplate code to add a new button
to Storybook's Toolbar:
<CodeSnippets paths={[ 'common/storybook-addon-toolbar-example.js.mdx', ]} />
The icon
element used in the example loads the icons from the @storybook/components
package. See here for the list of available icons that you can use.
Tab addons allow you to create your own custom tabs in Storybook. For example, the official @storybook/addon-docs uses this pattern.
Use this boilerplate code to add a new Tab
to Storybook's UI:
<CodeSnippets paths={[ 'common/storybook-addon-tab-example.js.mdx', ]} />
Learn how to write your own addon that includes these UI elements here.
Storybook preset addons are grouped collections of babel
, webpack
, and addons
configurations to integrate Storybook and other technologies. For example the official preset-create-react-app.
Use this boilerplate code while writing your own preset addon.
<CodeSnippets paths={[ 'common/storybook-preset-full-config-object.js.mdx', ]} />
- Types of addons for other types of addons
- Writing addons for the basics of addon development
- Presets for preset development
- Integration catalog for requirements and available recipes
- API reference to learn about the available APIs