npmpackage.info

Gathering detailed insights and metrics for @react-theming/storybook-addon

Other packages similar to @react-theming/storybook-addon

@procore/storybook-addon

4.4.2

Procore Storybook Configuration

Gathering detailed insights and metrics for @react-theming/storybook-addon

@react-theming/storybook-addon - 1.1.10 | npmpackage.info

@react-theming/storybook-addon

Develop themable components with Emotion/Styled Components/Material-UI with help of Storybook & React Theming

1.1.10

207

MIT

JavaScript

916.89 kB

2.9

Installations

npm install @react-theming/storybook-addon

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Node Version

16.14.2

NPM Version

8.5.0 Pull Requests

Open

3

Total

37

Closed

3

Merged

31

Issues

Open

0

Total

48

Closed

48

Releases

New Features

1.1.1

Updated on Mar 21, 2021

Dependencies update

1.1.0

Updated on Mar 13, 2021

v1.0.3

1.0.3

Updated on Jul 19, 2020

0.2.0

Updated on Dec 22, 2016

Init project

0.1.0

Updated on Nov 22, 2016

View All 5 releases

Languages

JavaScript

HTML

Shell

JavaScript (95.47%)

HTML (4.46%)

Shell (0.07%)

Developer

react-theming

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

207 Stars

399 Commits

37 Forks

3 Watchers

7 Branches

31 Contributors

Updated on Feb 20, 2025

Maintainers

View All 31 Contributors

Package Meta Information

Latest Version

1.1.10

Package Id

@react-theming/storybook-addon@1.1.10

Unpacked Size

916.89 kB

Size

311.93 kB

File Count

NPM Version

8.5.0

Node Version

16.14.2

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Storybook Addon @ React Theming

Storybook addon for Styled Components, Emotion, Material-UI and any other theming solution. Allows to develop themed components in isolation.

1npm i --save-dev @react-theming/storybook-addon

Demo

example

Features :dizzy:

Universal - can be used with any styling library
Switching between themes from addon panel.
Change a color and see how it affects to your components
Easily copy-paste paths of nesting theme props into your code
Auto changes background
Supports dark Storybook theme
Keep selected theme on stories updates

Usage

specify addon in .storybook/main.js

1// .storybook/main.js
2
3module.exports = {
4  stories: ['../src/**/*.stories.js'],
5  addons: ['@react-theming/storybook-addon'],
6};

or in .storybook/addons.js for older versions of Storybook

1import '@react-theming/storybook-addon/register';
2

Then you'll need to add a decorator with a ThemeProvider of your library. This project is not related to any particular styling solutions, instead, you can use any of theme providers you're using in your project.

1import ThemeProvider from 'library-of-your-choice';
2import { withThemes } from '@react-theming/storybook-addon';
3import { theme } from '../src/theme';
4
5// create decorator
6const themingDecorator = withThemes(ThemeProvider, [theme]);

ThemeProvider should accept a theme via theme props. This is usually the case for the most common styling libraries like Styled Components, Emotion, Material-UI.

In case of non standard ThemeProvider you can pass providerFn function in options:

1const providerFn = ({ theme, children }) => {
2  return <ThemeProvider theme={muTheme}>{children}</ThemeProvider>;
3};
4
5const themingDecorator = withThemes(null, [theme], { providerFn });

Use your output of the selected value

1// .storybook/preview.js
2
3import { ThemeProvider } from 'styled-components';
4import { addDecorator } from '@storybook/react';
5import { withThemes } from '@react-theming/storybook-addon';
6
7import { theme } from '../src/theme';
8

Example getCustomFieldSnippet

1const selectedValue = {
2  name: "accent5",
3  namespace: ["palette", "colors"],
4  type: "color",
5  value: "#ac924d"
6}
7
8
9const getCustomFieldSnippet = selectedValue => {
10  const { namespace, name } = selectedValue;
11  const path = namespace.join('.');
12  const fullPath = `${path}.${name}`;
13  const themeProp = `\${({ theme }) => theme.${fullPath}}`;
14  return themeProp;
15};
16
17// The snippet Func function takes the SelectedValue parameter and returns a string
18addDecorator(withThemes(ThemeProvider, [theme], { getCustomFieldSnippet }));
19

Example getCustomValueSnippet

By default, the addon outputs colors in HEX format, if you need some kind of add-in, then pass the colorSnippet parameter.

1const getCustomValueSnippet = ({value, name, type}) => {
2  // Here is your code
3  return value
4};
5
6// The colorSnipept function accepts an object consisting of { value : HEX, name: string, type: color}
7addDecorator(withThemes(ThemeProvider, [theme], { getCustomValueSnippet }));
8

BACKGROUND COLOR

This addon has ability to auto change background color when it detect a dark theme. By default it checks if the theme name contains 'dark'.

You can customize this behavior by passing onThemeSwitch function:

1export const onThemeSwitch = context => {
2  const { theme } = context;
3  const background = theme.name === 'Dark theme' ? '#2c2f33' : 'white';
4  const parameters = {
5    backgrounds: {
6      default: background,
7    },
8    // Pass backgrounds: null to disable background switching at all
9  };
10  return {
11    parameters,
12  };
13};
14
15const themingDecorator = withThemes(null, [theme], { onThemeSwitch });

This way you can have own checks of what the theme is selected and pass what ever color you need.

!important: The addon change background color on each theme selecting. In some scenarios you might want to disable this behavior e.g. if you already using addon-backgrounds. You can disable background switching by passing backgrounds: null in parameters.

Below the use cases for most popular styling libraries:

Using with Emotion

1// .storybook/preview.js
2
3import { ThemeProvider } from '@emotion/react';
4import { addDecorator } from '@storybook/react';
5import { withThemes } from '@react-theming/storybook-addon';
6
7import { theme } from '../src/theme';
8
9// pass ThemeProvider and array of your themes to decorator
10addDecorator(withThemes(ThemeProvider, [theme]));

💅 Using with Styled Components

1// .storybook/preview.js
2
3import { ThemeProvider } from 'styled-components';
4import { addDecorator } from '@storybook/react';
5import { withThemes } from '@react-theming/storybook-addon';
6
7import { theme } from '../src/theme';
8
9// pass ThemeProvider and array of your themes to decorator
10addDecorator(withThemes(ThemeProvider, [theme]));

Using with Material-UI

1// theme.js
2import { red } from '@material-ui/core/colors';
3
4// A custom theme for this app
5const theme = {
6  palette: {
7    primary: {
8      main: '#556cd6',
9    },
10    secondary: {
11      main: '#19857b',
12    },
13    error: {
14      main: red.A400,
15    },
16    background: {
17      default: '#fff',
18    },
19  },
20};
21
22export default theme;

1// .storybook/preview.js
2
3import { ThemeProvider } from '@material-ui/core';
4import { createMuiTheme } from '@material-ui/core/styles';
5import { addDecorator } from '@storybook/react';
6import { withThemes } from '@react-theming/storybook-addon';
7
8import theme from '../src/theme';
9
10const providerFn = ({ theme, children }) => {
11  const muTheme = createMuiTheme(theme);
12  return <ThemeProvider theme={muTheme}>{children}</ThemeProvider>;
13};
14
15// pass ThemeProvider and array of your themes to decorator
16addDecorator(withThemes(null, [theme], { providerFn }));

1// index.js
2
3import React from 'react';
4import ReactDOM from 'react-dom';
5import { ThemeProvider } from '@material-ui/core/styles';
6import { createMuiTheme } from '@material-ui/core/styles';
7import App from './App';
8import theme from './theme';
9
10ReactDOM.render(
11  <ThemeProvider theme={createMuiTheme(theme)}>
12    <App />
13  </ThemeProvider>,
14  document.querySelector('#root'),
15);
16

There is an example app with CRA, Material-UI and Storybook Addon Demo Source

Credits

Created with ❤︎ to React and Storybook by Oleg Proskurin [React Theming]

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

7

SAST

Determines if the project uses static code analysis.

2

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Signed-Releases

Determines if the project cryptographically signs release artifacts.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

89 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-whgm-jr23-g3j9
Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw
Warn: Project is vulnerable to: GHSA-qwcr-r2fm-qrc7
Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-x9w5-v3q2-3rhw
Warn: Project is vulnerable to: GHSA-w8qv-6jwh-64r5
Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-3wcq-x3mq-6r9p
Warn: Project is vulnerable to: GHSA-434g-2637-qmqr
Warn: Project is vulnerable to: GHSA-49q7-c7j4-3p7m
Warn: Project is vulnerable to: GHSA-977x-g7h5-7qgw
Warn: Project is vulnerable to: GHSA-f7q4-pwc6-w24p
Warn: Project is vulnerable to: GHSA-fc9h-whq2-v747
Warn: Project is vulnerable to: GHSA-vjh7-7g9h-fjfh
Warn: Project is vulnerable to: GHSA-rv95-896h-c2vc
Warn: Project is vulnerable to: GHSA-qw6h-vgh9-j6wx
Warn: Project is vulnerable to: GHSA-jchw-25xp-jwwc
Warn: Project is vulnerable to: GHSA-cxjh-pqwp-8mfp
Warn: Project is vulnerable to: GHSA-pfrx-2q88-qq97
Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj
Warn: Project is vulnerable to: GHSA-pfq8-rq6v-vf5m
Warn: Project is vulnerable to: GHSA-rc47-6667-2j5j
Warn: Project is vulnerable to: GHSA-c7qv-q95q-8v27
Warn: Project is vulnerable to: GHSA-78xj-cgh5-2h22
Warn: Project is vulnerable to: GHSA-2p57-rm9w-gvfp
Warn: Project is vulnerable to: GHSA-7r28-3m3f-r2pr
Warn: Project is vulnerable to: GHSA-r8j5-h5cx-65gg
Warn: Project is vulnerable to: GHSA-896r-f27r-55mw
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-76p3-8jx3-jpfq
Warn: Project is vulnerable to: GHSA-3rfm-jhwj-7488
Warn: Project is vulnerable to: GHSA-hhq3-ff78-jv3g
Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
Warn: Project is vulnerable to: GHSA-mwcw-c2x4-8c55
Warn: Project is vulnerable to: GHSA-5rrq-pxf6-6jx5
Warn: Project is vulnerable to: GHSA-8fr3-hfg3-gpgp
Warn: Project is vulnerable to: GHSA-gf8q-jrpm-jvxq
Warn: Project is vulnerable to: GHSA-2r2c-g63r-vccr
Warn: Project is vulnerable to: GHSA-cfm4-qjh2-4765
Warn: Project is vulnerable to: GHSA-x4jg-mjrx-434g
Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p
Warn: Project is vulnerable to: GHSA-px4h-xg32-q955
Warn: Project is vulnerable to: GHSA-rp65-9cf3-cjxr
Warn: Project is vulnerable to: GHSA-3j8f-xvm3-ffx4
Warn: Project is vulnerable to: GHSA-4p35-cfcx-8653
Warn: Project is vulnerable to: GHSA-7f3x-x4pr-wqhj
Warn: Project is vulnerable to: GHSA-jpp7-7chh-cf67
Warn: Project is vulnerable to: GHSA-q6wq-5p59-983w
Warn: Project is vulnerable to: GHSA-j9fq-vwqv-2fm2
Warn: Project is vulnerable to: GHSA-pqw5-jmp5-px4v
Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j
Warn: Project is vulnerable to: GHSA-rhx6-c78j-4q9w
Warn: Project is vulnerable to: GHSA-h7cp-r72f-jxh6
Warn: Project is vulnerable to: GHSA-v62p-rq8g-8h59
Warn: Project is vulnerable to: GHSA-7fh5-64p2-3v2j
Warn: Project is vulnerable to: GHSA-x7hr-w5r2-h6wg
Warn: Project is vulnerable to: GHSA-5q6m-3h65-w53x
Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg
Warn: Project is vulnerable to: GHSA-h9rv-jmmf-4pgx
Warn: Project is vulnerable to: GHSA-hxcc-f52p-wc94
Warn: Project is vulnerable to: GHSA-76p7-773f-r4q5
Warn: Project is vulnerable to: GHSA-cm22-4g7w-348p
Warn: Project is vulnerable to: GHSA-g4rg-993r-mgx7
Warn: Project is vulnerable to: GHSA-c9g6-9335-x697
Warn: Project is vulnerable to: GHSA-vx3p-948g-6vhq
Warn: Project is vulnerable to: GHSA-w5hq-hm5m-4548
Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36
Warn: Project is vulnerable to: GHSA-4wf5-vphf-c2xc
Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
Warn: Project is vulnerable to: GHSA-w5p7-h5w8-2hfq
Warn: Project is vulnerable to: GHSA-7p7h-4mm5-852v
Warn: Project is vulnerable to: GHSA-fhg7-m89q-25r3
Warn: Project is vulnerable to: GHSA-hc6q-2mpp-qw7j
Warn: Project is vulnerable to: GHSA-4vvj-4cpr-p986
Warn: Project is vulnerable to: GHSA-wr3j-pwj9-hqq6
Warn: Project is vulnerable to: GHSA-4v9v-hfq4-rm2v
Warn: Project is vulnerable to: GHSA-9jgg-88mc-972h
Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7
Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q
Warn: Project is vulnerable to: GHSA-6fc8-4gx4-v693
Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp

Score

2.9

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to @react-theming/storybook-addon

Other packages similar to @react-theming/storybook-addon

@react-theming/storybook-addon

Installations

Developer Guide

Yes

CommonJS

16.14.2

8.5.0

Pull Requests

3

37

3

31

Issues

0

48

48

Releases

Languages

Developer

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

Storybook Addon @ React Theming

Features :dizzy:

Usage

Use your output of the selected value

Example getCustomFieldSnippet

Example getCustomValueSnippet

Using with Emotion

💅 Using with Styled Components

Using with Material-UI

Credits

10

10

10

7

2

0

0

0

0

0

0

0

0

0

2.9

/10