Design Tokens with variables CSS

Add your Themes using variables css and use them in your components.

create components with variables css, based on the theme you want to use.

Step by step

- [ ] install addon npm or yarn
- [ ] add .storybook/main.(js,ts)
- [ ] config your themes in .storybook/preview.(js,ts)

Link example

| host | Desc | Links |
|--|--|--|
| code and preview | Simple example | Link |
| code and preview | Example with custom panel storybook variables | Link |
---

Image example

Requirements

- Storybook@>=6.0.0

This addon should work well with any framework: If you find the case the addon not works, please open an issue.

Getting started

$3

``sh
npm install --save-dev @outlinestudio/designtokenscss


yarn add -D @outlinestudio/designtokenscss

`js
module.exports = {
addons: ["@outlinestudio/designtokenscss"],
};
`

$3

`js
export const parameters = {
designTokensCss: {
label: 'Themes',
persistData: true,
themes: [
{
"name": "Theme One",
"miniLogo": "",
"tokens": {
## add all yours css variables here
"--yours-primary": "#c8c615",
"--yours-primary-text": "#faf9e8",
"--yours-primary-container": "#b4b213",
"--yours-primary-light": "#e9e8a1",
"--yours-primary-dark": "#62610a",
"--yours-primary-hover": "#969510"
## add all yours css variables here
}
},
{
"name": "Theme Two",
"miniLogo": "https://javisperez.github.io/tailwindcolorshades/img/icons/favicon-16x16.png",
"tokens": {
## add all yours css variables here
"--yours-primary": "#c8c615",
"--yours-primary-text": "#faf9e8",
"--yours-primary-container": "#b4b213",
"--yours-primary-light": "#e9e8a1",
"--yours-primary-dark": "#62610a",
"--yours-primary-hover": "#969510"
## add all yours css variables here
}
},
]
}
`

$3

| Parameter | type | obs |
| ----------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| label | string | parameter text setting in select default |
| persistData | boolean | set persistData to save theme selected in localStorage load start |
| themes | [ThemeType\[\]](https://github.com/raulmelo/addon-variablecss-theme/blob/main/src/utils/types.ts) | Array with themes and yours properties css variable |

#### Themes

| Parameter | type | obs |
| --------- | --------------- | ------------------------------------ |
| name | string | Name theme |
| miniLogo | string optional | Mini logo theme show in select |
| tokens | Object | Declare name and value css variables |

Exemplo config with themes

#### example config

$3

You can change panel default in storybook, all custom accept in css variables through file .storybook/manager-head.html`.
adding in styles tag with yours variable custom with params.
Example with storybook theme custom panel

example:

Example optional