react-native-storybook-loader

react-native-storybook-loader

A component for dynamically import stories into react-native-storybook.

Purpose

While using storybook for React Native, I repeatedly found myself manually creating this file, so I added an automated way to do it.

Installation

yarn add react-native-storybook-loader -D

Or

npm install react-native-storybook-loader --save-dev

Quick Start

Create a React Native project using react-native-cli

react-native init AwesomeProject

Add react-native-storybook to the project using getstorybook

cd AwesomeProject
getstorybook

Install react-native-storybook-loader

yarn install react-native-storybook-loader -D

Update index.android.js and index.ios.js files in the ./storybook directory to point to the storyLoader.js

import { AppRegistry } from 'react-native';
import { getStorybookUI, configure } from '@kadira/react-native-storybook';
import { loadStories } from './storyLoader';

// import stories
configure(loadStories, module);

const StorybookUI = getStorybookUI({port: 7007, host: 'localhost'});
AppRegistry.registerComponent('ReactNative', () => StorybookUI);

Add the rnstl cli to the scripts tag of the package.json

{
  "scripts": {
    "prestorybook":"rnstl"
  }
}

Configuration

Story loading is controlled by the react-native-storybook-loader section of the project's package.json.

Options

Setting	Description	Default	Notes
searchDir	This is the directory, relative to the project root, to search for files in.	Project root
outputFile	This is the output file that will be written. It is relative to the project directory.	./storybook/storyLoader.js
pattern	This is the pattern of files to look at. It can be a specific file, or any valid glob	./storybook/stories/index.js	This is the default storybook file, and chosen for this component to be able to be dropped in to a new project and work, only requiring and update to the index.android.js and index.ios.js files.

Example:

{
  "name": "AwesomeProject",
  ...
  "scripts": {
    ...
    "prestorybook":"rnstl"
  },
  "config": {
    "react-native-storybook-loader": {
      "searchDir": "./src",
      "pattern": "**/*.stories.js",
      "outputFile": "./storybook/storyLoader.js"
    }
  }
}

This configuration will search src recursively for files that end with .stories.js.

Support

Please log issues

Contributing

Coming Soon