@lullabot/storybook-drupal-addon v2.0.6

Drupal Storybook Addon

A library for best-practice Drupal integration addons in Storybook:

• Easy-to-use locale configuration
• Simple drop-down menu
• URL-linkable state for sharing

Addon authors

As an addon author, you can use this library by adding it as a dependency and adding the following to your /preset.js file:

function config(entry = []) {
  return [
    ...entry,
    require.resolve('@lullabot/storybook-drupal-addon/preview'), // <-- library's preview preset
    require.resolve('./dist/esm/preset/preview'), // <-- your addon's preview preset (if present)
  ];
}

function managerEntries(entry = []) {
  return [
    ...entry,
    require.resolve('@lullabot/storybook-drupal-addon/manager'),
    require.resolve('./dist/esm/preset/manager'), // <-- your addon's manager (if present)
  ];
}

module.exports = {config, managerEntries};

The currently selected theme is available in the drupalTheme global, so you can access it in a decorator using the following snippet:

import { MyProvider } from 'your-drupal-library';
import { useGlobals } from '@storybook/client-api';

const myDecorator = (story, context) => {
  const [{drupalTheme}] = useGlobals();
  return <MyProvider theme={drupalTheme}>;
};

End users

End users configure the supportedDrupalThemes and drupalTheme parameters in .storybook/preview.js.

supportedDrupalThemes is an object where the keys are the machine name of the Drupal themes and the values are the plain text name of that Drupal theme you want to use. This is what will appear in the dropdown in the toolbar.

export const parameters = {
  drupalTheme: 'umami',
  supportedDrupalThemes: {
    umami: {title: 'Umami'},
    bartik: {title: 'Bartik'},
    claro: {title: 'Claro'},
    seven: {title: 'Seven'},
  }
};