Back to integrations
Add your integration
  • ⭐️ Popular
  • 🧩 Essentials
  • 🛠 Code
  • ⚡️ Data & state
  • ✅ Test
  • 💅 Style
  • 🎨 Design
  • ⚙️ Appearance
  • 🗄 Organize
How to install addons Create an addon
A storybook addon which helps you to test how your REM sized components behave.
npm install storybook-addon-rem
Last updated over 1 year ago
Downloads per week
Readme View on GitHub

Storybook Addon REM

Storybook REM preview

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 🚀


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,


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 );

Storybook addon REM development

run the build:watch process:

npm build:watch

open a second terminal. Go to examples/basic:

cd example/basic/

this is a plain storybook setup where this addon has been integrated. Install dependencies with

npm i

then start storybook with

npm run storybook

Notice: This storybook instance requires a lower node version than 18. If needed: Install NVM and switch to a lower version of nodejs e.g. v16.19.0 also known as lts/gallium:

nvm i lts/gallium
nvm use lts/gallium


  • Integrate Storybook events
  • Update icon(s)


  • Code structure greatly inspired by storybook-dark-mode. I learned and adapted a lot ❤️
  • Kudos to @storybook/a11y repository for showing how to implement a storybook toolbar with a tooltip.
Join the community
6,611 developers and counting
WhyWhy StorybookComponent-driven UI
CommunityAddonsGet involvedBlog
ShowcaseExploreProjectsComponent glossary
Open source software

Maintained by
Special thanks to Netlify and CircleCI