Props Builder
Table of Contents
Build your own CSS props a.k.a Design Tokens, with ease.
This package is mainly used for our own CSS props components, but also available to any one that wants to build there own CSS props.
Installation
npm install @fylgja/props-builder
How to use
This is a Javascript function and is used in combination with your own Javascript build file.
First create an javascript file, for example build.js
import the props builder in your build js;
import { propsBuilder } from "@fylgja/props-builder";
and call it with at least a filename and some props;
const spacers = {
"size-1": "0.5em",
"size-2": "1em",
"size-3": "1.5em",
};
propsBuilder({
filename: "spacers.css",
props: spacers
});
Now you have a css file with your own spacers;
/* File: spacers.css */
:root {
--size-1: 0.5em;
--size-2: 1em;
--size-3: 1.5em;
}
Tweak the build options
Lets say you want a different parent class, or you want a prefix, you can do so, by using the available options.
Each option is visible if your using an IDE that supports JSDoc or/and Typescript.
But here are the options, just in case if you don't have an editor with those super powers.
Option | Type | default |
---|---|---|
props | { [key: string|number]: string|number } | ... |
filename | string | ... |
selector | string | ":root" |
prefix | string | "" |
generationSyntax | string | Note 1 |
jsonColorKeys | string[] | Note 2 |
Note 1 If empty the default is based on the file extension
Note 2 If empty default color map is used