A functional CSS system for building user interfaces π°
Documentation | CLI | Reference
This repo is subject to lots of changes as it's in prime experimental mode. See going from 0.0.0 to 1.0.0.
Get started here.
Coming soon
Learn more here.
Example preons.yaml.
Read the docs here.
The preonize
function is currently an scss
function. It allows Preons to generate lots of rules at multiple breakpoints without having to hardcode each CSS class.
It has 4 parameters.
@include preonize(
<class name>, # The prefix name of the class eg. 'h' for height
<css property>, # The css property assigned to the class 'height'
<sass map rules>, # Sass map of rules eg. (1: 1rem, 2: 2rem)
<breakpoints> # Breakpoints
);
Thus, we can reuse different sass-maps for several rules. Here's an example use:
@include preonize(
"h",
width,
map-collection(scaled, percentaged, discrete, special-sizes),
$breakpoints
);
Look up the reference here or peruse them below.
Read the roadmap here.
This project uses SemVer for versioning and Intuit's Auto to generate releases on the fly. For the versions available, see the tags on this repository.
- Intuit's Auto for making releases easier
- Adam Moore & Tachyons for creating their wonderful library
Thank you for your desire to contribute. All you have to do is create a PR. Note the following conventions:
- This project uses Angular commit conventions. As it's in version experimental, prefix your commits with
fix:
.
You are free to modify and do as you choose to this library however, it uses GPLv2.1 to keep it free for all into the future. Of course, you can commercialize your product where this library is part of a larger piece of work and is merely a dependency.
Here's a really helpful video explanation of GPL licences in general.
https://www.youtube.com/watch?v=JlIrSMzF8T4
Thanks goes to these wonderful people (emoji key):
Gemma Black π π» |
Pierre Grimaud π |
FΓ‘bio Rosado π» |
Codacy Badger π |
This project follows the all-contributors specification. Contributions of any kind welcome!