design-token-editor
v0.6.0
Published
A react component to view/edit design token values
Downloads
4,022
Maintainers
Readme
Design token editor
Provide insight into design tokens and edit their values.
This package provides React components to work with design tokens emitted by Style Dictionary builds.
Warning - this package is under active development and public API may still change significantly.
Storybook documents the (public) API.
Who is it for?
In short - anyone benefiting from using design tokens!
Design system maintainers
Design systems that make use of design tokens typically do so to allow users to create
their own themes. Using the TokensTable
component can help you automatically
document the available tokens for a given component.
More complex integration could even make it possible for people to interactively alter the values of design tokens and see how the component reacts/looks like in your storybook documentation, for example!
Theme designers
Theme designers often have the hard task of figuring out which components are available, where and how they are used and the figure out how they can change the look and feel.
When all that's done, they have to write JSON to actually implement their theme, get it built with style-dictionary and finally check the results.
By exposing an editor around the tokens table, theme designers can interactively enter the values to play around with components and see the resulting JSON code which only needs to be copy-pasted into their own build pipeline.
Combine this with interactive documentation, and as a theme designer you may get to experiment and settle on your desired colors in a minimum of time!
Applications exposing themeing controls
White-label products/software benefit massively from using components styled through design tokens, making it even possible for run-time theme editing.
Exposing the design-token-editor in a user-friendly interface helps them configure their themes without having to bother your support staff ;)
Usage
Please see the Storybook documentation.