Storybook Addon REM

A storybook addon which helps you to test how your REM sized components behave.

Why and when to use REM

Aleksandr Hovhannisyan wrote an awesome article about rems for font size. Check it out if you want to learn more about this CSS unit.

Getting started

Install the addon:

npm i storybook-addon-rem --dev

Add following content to .storybook/main.(js|mjs|cjs):

module.exports = {
  addons: ['storybook-addon-rem']
};

Add some css rem declerations to your component styling, e.g.:

.your-component-button {
  font-size: 1rem;
}

Run your storybook instance. You should be able to see and use this addon in the toolbar 🚀

Configuration

Custom sizes

If you want to pass custom sizes you can do this by adding something like this in the .storybook/preview.(js|mjs|cjs) file:

export const parameters = {
  // ...
  rem: {
    // ...
    sizes: [
      { value: 6, title: 'Tiny' },
      { value: 12, title: 'Standard' },
      { value: 72, title: 'Huge' },
    ]
  },
}

Default paddings

By default storybook-rem-addon removes storybooks rem paddings on the canvas and docs pages. If you want to keep the rem padding you can configure this in the .storybook/preview.(js|mjs|cjs) file:

export const parameters = {
  // ...
  rem: {
    // ...
    canvasRemPadding: true,
    docsRemPadding: true,
  }
};

Events

You can listen for the rem-update event via the addons channel:

const channel = api.getChannel();

// On mount
useEffect(() => {
  channel.addListener( 'rem-update', onRemUpdate );

  return () => {

    // On unmount
    channel.removeListener( 'rem-update', onRemUpdate );
  };
});

const onRemUpdate = ( data ) => {
  console.log( data.title, data.value );
}