1.0.3 • Published 8 years ago
sugarcss v1.0.3
Sugar (v1.0.3)
The goal of Sugar is certainly not to tells you how to organize your project. It's just like a sugar in the coffee, you choose the coffee, Sugar enhance it with a nice touch!
Visit Website for full documentation
Write less, do more!
Sugar has a lots of cool mixins to help you write cleaner scss:
.my-cool-element {
@include s-font(12px helvetica bold underline uppercase nowrap right);
}
This will give:
.my-cool-element {
font-size : 12px;
font-family : helvetica;
font-weight : bold;
text-decoration : underline;
text-transform : uppercase;
white-space : nowrap;
text-align : right;
}
Quick start
Importing sugar
@import "sugar/sugar"
Configure your sugar :
@include sugar((
typo : (
font-size : 13px
// etc...
),
colors : (
orange : #f2bc2b
// your colors here...
),
transition : (
// your transitions settings here...
)
// and many more settings by packages
// like font-awesome, modular-scale,
// animate.css, BEM, etc...
));
Helper classes (if wanted) :
@include sugar(classes);
.pull-left, .pull-right
.m-t-{size}, .m-b-{size}, .m-l-{size}, .m-r-{size}, .m-s-{size}
.p-t-{size}, .p-b-{size}, .p-l-{size}, .p-r-{size}, .p-s-{size}
.text-left, .text-right, .text-center, .text-justify, .text-uppercase, .text-lowercase, .text-capitalize
.c-{color}, .bkg-{color}
// and many more
Take advantage of all the powerful sugar mixins, functions, etc...
.h1 {
@include s-vertical-rhythme((
s-font : 30px helvetica uppercase,
margin-botton : 20px
));
}
.my-font-element {
@include s-font(12px s-color(orange, light) uppercase underline nowrap);
}
.popover {
// an orange bubble with an arrow top 20px
@include s-bubble(top s-color(orange) 20px);
}
// and many more mixins and functions...
Cool packages out of the box
Sugar comes with some nice packages like font-awesome, animate.css, etc... out of the box. These packages are optimized to generate only the css you need!
- Font Awesome
- Sassdash
- CSSGram
- modular-scale
- animate.css
- ...
You can choose or not to use the embeded packages. Nothing stop you to install them by yourself and use the versions you want...
A not limited list of mixins
- s-font
- s-animation
- s-background
- s-bubble
- s-clearfix
- s-columns
- s-corner (s-border-radius)
- s-filter
- s-fit
- s-font
- s-font-face
- s-icon
- s-list / s-list-item
- s-long-shadow
- s-media
- s-position
- s-placeholder
- s-ratio
- s-show-rhythme
- s-selection
- s-size
- s-text-hidden
- s-text-truncate
- s-transform
- s-transition
- s-translate
- s-vertical-rhythme
- s-visually-hidden
- ...
A not limited list of functions
- s-color
- s-is
- s-setting
- s-size
- s-px
- s-rem
- s-em
- s-percent
- s-sqrt
- s-pow
- s-sin
- s-cos
- and many more...
That's not finished...
Sugar offer you a lot of features and advanced settings that you can discover on the full website.
Visit Website for full documentation
Tested with
Generator | Version | |
---|---|---|
Sass | 3.4.18 | |
Gulp | 3.9.0 | |
NPM | 2.5.1 | |
Libsass | 3.3.3 | |
Grunt | 0.4.4 |