Atomizer
Meet Atomizer!
Atomizer generates a simple static CSS stylesheet from the Atomizer classes you define in your project or predeclared configured styles - it's up to you.
Atomizer is not opinionated, brings no CSS of its own and integrates nicely with your favorite task runner.
Testimonials
-
We released Atomizer almost 10 years ago and to this day it is used on massive web sites by huge front-end teams. If your project calls for an Atomic CSS library, make sure to give it a try.
Thierry Koblentz Atomizer Co-Creator
-
Initially I did not like the concept, I had experience in using Bootstrap UI Library and BEM methodology to manage CSS. It took 5 - 6 months to realize that Atomizer was the best and true CSS framework which solves many problems we were facing. Thierry Koblentz helped me a lot to understand the concept and the reason behind their decisions to build Atomizer.
Jitendra Vyas UX Engineer, VWO
-
Atomizer is a well-designed library which solves lots CSS management challenges of large scale applications. It helps to promote good html structure, clean and reusable CSS and rapid development process.
Roderick Hsiao Software Engineer, Tinder
-
Atomic CSS tickles me: https://acss.io. It's a DSL that you write in class names. Atomizer makes the browser understand the subset you use. There's potential to take this much further
Max Heiber @maxheiber
-
#CSS is painful. Style with class. Meet #Atomizer a tool that helps you create #AtomicCSS rules
Peter Hecker @phecker65
-
Naming selectors in CSS is hard! Thankfully Atomizer saves you the trouble from writing CSS altogether!
Pankaj Parashar @pankajparashar
Colors
<div class="Bgc(#0280ae) C(#fff)">
Lorem ipsum
</div>hex color.
<div class="Bgc(#0280ae.5) C(#fff)">
Lorem ipsum
</div>Variables
Variables are useful for theming but they can also be used to share a common value across style declarations. In this example, brandColor is responsible for setting the text color, background color and border color, while columnWidth dictates the width of the first box and the left offset of its sibling.
module.exports = {
custom: {
brandColor: '#0280ae',
columnWidth: '20px',
},
};<div class="Pos(a) Bgc(brandColor) W(columnWidth) H(90px)"></div>
<div class="C(brandColor) BdB Bdc(brandColor) Mstart(columnWidth) P(10px)">
Lorem ipsum
</div>CSS custom properties (variables) can also be referenced as class values. Note that values are not managed by Atomizer, and must be defined independently.
/* external style sheet */
:root {
--primary-color: #400090
}<div class="C(--primary-color)">Hello World</div>Contextual selectors
Atomizer syntax allows you to style elements depending on their ancestors or siblings.
In this example, two identical sets of boxes are styled differently depending on the class applied to their parent element.
<div>
<div class="W(50%) foo_W(100%)"></div>
<div class="W(50%) foo_W(100%)"></div>
</div>
<hr>
<div class="foo">
<div class="W(50%) foo_W(100%)"></div>
<div class="W(50%) foo_W(100%)"></div>
</div>Pseudo-classes
Create styles that rely on pseudo-classes.
In this example, the foreground and background color change when users hover over the box.
<div class="Bgc(#0280ae):h C(#0280ae) C(#fff):h">
Lorem ipsum
</div>You can also combine descendant selectors with pseudo-classes. In this example, the nested box is revealed when a user hovers over its parent:
<div class="foo">
<p class="Op(0) foo:h>Op(1)">Lorem ipsum</p>
</div>Lorem ipsum
Grids
What do you prefer? Floats? Flexbox? CSS Grids? Atomizer supports it all.
<!-- floats -->
<div class="Row">
<div class="Fl(start) W(1/2)"></div>
<div class="Fl(start) W(1/2)"></div>
</div>
<!-- table -->
<div class="D(tb) W(100%)" role="presentation">
<div class="D(tbc)"></div>
<div class="D(tbc)"></div>
</div>
<!-- flexbox -->
<div class="D(f)">
<div class="Flxg(1)"></div>
<div class="Flxg(1)"></div>
</div>
<!-- grids -->
<div class="D(g) Gtc(twoColEvenGrid)">
<div></div>
<div></div>
</div>Responsive Design
Define your responsive breakpoints in configuration using standard media query syntax. Then, reference those breakpoints in your Atomizer classes or configuration.
Classes mapped to a single breakpoint
Reference your breakpoints in your classnames using a double-dash suffix (eg, --sm).
In this example, the four boxes are styled as inline-block, with a width of 25% when the viewport is more than 700px wide.
module.exports = {
custom: {
breakPoints: {
sm: '@media screen and (min-width:700px)',
},
},
};<div class="D(ib)--sm W(25%)--sm"></div>
<div class="D(ib)--sm W(25%)--sm"></div>
<div class="D(ib)--sm W(25%)--sm"></div>
<div class="D(ib)--sm W(25%)--sm"></div>Classes mapped to multiple breakpoints
Classes may have different values associated with different breakpoints; meaning the same class applies different styles depending on media queries.
module.exports = {
custom: {
rwdFontSize: {
xs: '12px',
sm: '22px',
md: '32px',
lg: '42px',
},
},
};<div class="Fz(rwdFontSize)">Responsive font-size</div>Helpers
Atomizer offers a selection of helper classes for common styling, such as "clearfix" to clear floats (Cf), Bd to help with setting borders, Ell to truncate text with ellipsis, Hidden to visually hide text, and more.
For example LineClamp(), which takes two parameters:
<p class="Fz(12px) Lh(1.5) LineClamp(3,54px)">
Lorem ipsum dolor sit amet, id oratio graeco nostrum sit, latine eligendi scribentur mea ex. Tota dolorem voluptua eos at. Ei nec reque viderer facilis. Aliquip necessitatibus ex pri, pertinax atomorum ei sea. Ea omittam appetere posidonium per, te meliore volutpat duo, dolorem ponderum interpretaris sea ut.
</p>Lorem ipsum dolor sit amet, id oratio graeco nostrum sit, latine eligendi scribentur mea ex. Tota dolorem voluptua eos at. Ei nec reque viderer facilis. Aliquip necessitatibus ex pri, pertinax atomorum ei sea. Ea omittam appetere posidonium per, te meliore volutpat duo, dolorem ponderum interpretaris sea ut.
Easily Integratable
Atomizers can be easily integrated into some of the most popular web frameworks. Here are some of the guides you can choose from.