Please add better docs and examples

[Farnsi]

As a css-in-js newbie, i have really no idea how to use this lib when i read only the website.

After study the code and the examples it got clearer. But big waste of time, if everybody has to do that.

You should add a sentence for which benefit this lib is absolute needed and superior to other solutions. E.g. why should i use this and not the things inlcuded in styled-components like theming? smaller virtual DOM updates for a newbie like me, how, what perfomance gain could i expect?

Example from Webpage: What are tokens? Why i need and define tokens? Confusing example "Create themeable CSS Snipptes": What is gradientStartColor variable? is it mistyped startColor?

Describe the api: Which parameters has createVar? How to access them? with .val, with .toStyle(...)? createGlobalTheme with scope without scope "", difference?

[elektronik2k5]

As a veteran css-in-js user, I must agree and am missing first and foremost one crucial detail: what problem does this package solve? Thanks!