@storybook/addon-essentials
Advanced tools
The @storybook/addon-essentials package is a collection of essential Storybook addons that are recommended for all Storybook users. It includes a set of addons that provide a wide range of functionality, such as controls for live-editing props, actions for logging interactions, viewport customization for responsive design testing, backgrounds to alter the canvas background, toolbars to add global toolbars, and more. It simplifies the setup process by including these addons by default.
Controls
Controls allow you to interact with your component's arguments dynamically, without needing to code. It's like a playground for your components.
"addons": ["@storybook/addon-essentials"]Actions
Actions help you to display data received by event handlers in Storybook's UI. It's useful for debugging events.
"addons": ["@storybook/addon-essentials"]Viewport
Viewport lets you adjust the size of the iframe to check how your stories look on different screen sizes.
"addons": ["@storybook/addon-essentials"]Backgrounds
Backgrounds can be used to change the background color or image behind your stories. This is useful for visualizing components on different backgrounds.
"addons": ["@storybook/addon-essentials"]Toolbars & globals
Toolbars and globals allow you to add your own toolbar items and use them to control global types and values in your stories.
"addons": ["@storybook/addon-essentials"]This package allows you to add knobs to your stories in Storybook. Similar to Controls, knobs let you edit props dynamically using a UI. However, @storybook/addon-essentials' Controls are the successor to Knobs and are recommended for new development.
This package is included in @storybook/addon-essentials and can be used standalone. It allows you to log interactions and events that happen in the UI components being developed.
Also part of @storybook/addon-essentials, this standalone addon allows you to view your components in different sizes and layouts in Storybook, simulating how they would look on different devices.
This is another addon that is part of the essentials package. It lets you define a set of backgrounds that can be applied to the Storybook canvas, allowing you to test components in different environments.
This addon is included in the essentials package and provides the ability to create custom toolbars in Storybook. It's useful for creating global context changes for your components.
Storybook Essentials is a curated collection of addons to bring out the best of Storybook.
Each addon is documented and maintained by the core team and will be upgraded alongside Storybook as the platform evolves. We will also do our best to maintain framework support for all of the officially supported frameworks.
Storybook essentials includes the following addons. Addons can be disabled and re-configured as described below:
You can add Essentials to your project with:
npm install --save-dev @storybook/addon-essentials
And then add the following line to your .storybook/main.js:
export default {
addons: ['@storybook/addon-essentials'],
};
Essentials is "zero config." That means that comes with a recommended configuration out of the box.
If you want to reconfigure an addon, simply install that addon per that addon's installation instructions and configure it as normal. Essentials scans your project's main.js on startup and if detects one of its addons is already configured in the addons field, it will skip that addon's configuration entirely.
You can disable any of Essential's addons using the following configuration scheme in .storybook/main.js:
export default {
addons: [{
name: '@storybook/addon-essentials',
options: {
<addon-key>: false,
}
}]
};
Valid addon keys include: actions, backgrounds, controls, docs, viewport, toolbars.
8.4.0
Storybook 8.4 comes with a ton of exciting new features designed to give you the best experience developing, testing, and debugging tests in the browser!
@vitest/browser v2.1.2 - #29407, thanks @strozw!es-toolkit - #29259, thanks @JReinhold!@storybook/addon-links by default - #29177, thanks @tobiasdiez!.gitignore updated via CLI ends with a newline - #29124, thanks @3w36zj6!yarn detection - #29448, thanks @ndelangen!chalk to picocolors - #28262, thanks @43081j!export { X } parsing - #29344, thanks @vctqs1!prettier an optional peer dependency - #29223, thanks @JReinhold!express to polka - #29230, thanks @43081j!qs to picoquery - #28315, thanks @43081j!handlebars usage - #29208, thanks @ndelangen!file-system-cache - #29256, thanks @ndelangen!fs-extra with the native APIs - #29126, thanks @ziebam!lodash with es-toolkit - #28981, thanks @ndelangen!esbuild, broadening version range - #29254, thanks @ndelangen!renderers/react's dependencies - #29298, thanks @ndelangen!svelte2tsx - support runes - #29423, thanks @JReinhold!util dependency - #29310, thanks @JReinhold!react in manager - #29197, thanks @ndelangen!optimizeDeps - #29179, thanks @tobiasdiez!FAQs
Curated addons to bring out the best of Storybook
The npm package @storybook/addon-essentials receives a total of 4,208,063 weekly downloads. As such, @storybook/addon-essentials popularity was classified as popular.
We found that @storybook/addon-essentials demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
An advanced npm supply chain attack is leveraging Ethereum smart contracts for decentralized, persistent malware control, evading traditional defenses.
Security News
Research
Attackers are impersonating Sindre Sorhus on npm with a fake 'chalk-node' package containing a malicious backdoor to compromise developers' projects.
Security News
The npm package for the LottieFiles Player web component was hit with a supply chain attack after a software engineer's npmjs credentials were compromised.