# React Storybook [![Build Status](https://travis-ci.org/storybooks/react-storybook.svg?branch=master)](https://travis-ci.org/storybooks/react-storybook) [![npm version](https://badge.fury.io/js/%40kadira%2Fstorybook.svg)](https://badge.fury.io/js/%40kadira%2Fstorybook) [![Storybook Slack](https://storybooks-slackin.herokuapp.com/badge.svg)](https://storybooks-slackin.herokuapp.com/)

React Storybook is a UI development environment for your React components. With it, you can visualize different states of your UI components and develop them interactively.

![React Storybook Screenshot](docs/demo.gif)

React Storybook runs outside of your app. So you can develop UI components in isolation without worrying about app specific dependencies and requirements.

## Getting Started

```js
npm i -g getstorybook
cd my-react-app
getstorybook
```

For more information visit: https://getstorybook.io

---

React Storybook also comes with a lot of [addons](https://getstorybook.io/docs/addons/introduction) and a great API to customize as you wish. You can also build a [static version](https://getstorybook.io/docs/basics/exporting-storybook) of your storybook and deploy it anywhere you want.

Here are some featured storybooks that you can reference to see how Storybook works:

  * [React Button](http://kadira-samples.github.io/react-button) - [source](https://github.com/kadira-samples/react-button)
  * [Demo of React Dates](http://airbnb.io/react-dates/) - [source](https://github.com/airbnb/react-dates)
  * [Demo of React Native Web](http://necolas.github.io/react-native-web/storybook/) - [source](https://github.com/necolas/react-native-web)

## Docs

* [Basics](https://getstorybook.io/docs/basics/introduction)
* [Configurations](https://getstorybook.io/docs/configurations/default-config)
* [Addons](https://getstorybook.io/docs/addons/introduction)