mirror of
https://github.com/storybookjs/storybook.git
synced 2025-04-05 06:01:22 +08:00
42 lines
2.5 KiB
Markdown
42 lines
2.5 KiB
Markdown
---
|
||
title: 'Introduction to addons'
|
||
---
|
||
|
||
Addons extend Storybook with features and integrations that are not built into the core. Most Storybook features are implemented as addons. For instance: [documentation](../writing-docs/introduction.md), [accessibility testing](https://github.com/storybookjs/storybook/tree/master/addons/a11y), [interactive controls](../essentials/controls.md), among others.
|
||
The [addon API](./addons-api.md) makes it easy for you to configure and customize Storybook in new ways. There are countless addons made by the community that unlock time-saving workflows.
|
||
|
||
Browse our [addon catalog](/addons) to install an existing addon or as inspiration for your own addon.
|
||
|
||
## Storybook basics
|
||
|
||
Before writing your first addon, let’s take a look at the basics of Storybook’s architecture. While Storybook presents a unified user interface, under the hood it’s divided down the middle into **Manager** and **Preview**.
|
||
|
||
The **Manager** is the UI responsible for rendering the:
|
||
|
||
- 🔍 Search
|
||
- 🧭 Navigation
|
||
- 🔗 Toolbars
|
||
- 📦 Addons
|
||
|
||
The **Preview** area is an `iframe` where your stories are rendered.
|
||
|
||
|
||
|
||
Because both elements run in their own separate `iframes`, they use a communication channel to keep in synch. For example when you select a story in the Manager a event is dispatched across the channel notifying the Preview to render the story.
|
||
|
||
## Anatomy of an addon
|
||
|
||
Storybook addons allow you to extend what's already possible with Storybook, everything from the [user interface](./addon-types.md) to the [API](./addons-api.md). Each one classified into two broader categories.
|
||
|
||
### UI-based addons
|
||
|
||
[UI-based addons](./addon-types.md#ui-based-addons) focus on customizing Storybook's user interface to extend your development workflow. Examples of UI-based addons include: [Controls](../essentials/controls.md), [Docs](../writing-docs/introduction.md) and [Accessibility](https://github.com/storybookjs/storybook/tree/master/addons/a11y).
|
||
|
||
[Learn how to write an addon »](./writing-addons)
|
||
|
||
### Preset addons
|
||
|
||
[Preset addons](./addon-types.md#preset-addons) help you integrate Storybook with other technologies and libraries. Examples of preset addons are: [preset-scss](https://github.com/storybookjs/presets/tree/master/packages/preset-scss) and [preset-create-react-app](https://github.com/storybookjs/presets/tree/master/packages/preset-create-react-app).
|
||
|
||
[Learn how to write a preset addon »](./writing-presets)
|