Gulp-atomicscss NPM

gulp-atomicscss

atomicscss plugin for gulp

Usage

First, install gulp-atomicscss as a development dependency:

npm install --save-dev gulp-atomiccsss

Class Attribute

Write class names as emmet css abbreviations.

<emmet>
class="dib" => .dib { display: inline-block; }

Use colors

<emmet>-c<hex>
class="c-cf00" => .c-cf00 { color: #f00; }

Use SCSS variables

<emmet>-v<var name>
class="c-vColor1" => .c-vColor1 { color: $Color1; }

Multi-part settings

<emmet>-<val>-<val>-<val>
class="m-10px-5px-0px-5px" => .m-10px-5px-0px-5px { margin: 10px 5px 0px 5px; }

Using a dot ‘.’

<emmet>-p<num>
<emmet>-<num>p<num>
class="fz-p5em" => .fz-p5em { font-size: .5em; }
class="fz-2p5em" => .fz-2p5em { font-size: 2.5em; }

Percentages

<emmet>-x<num>
class="w-x50" => .w-x50 { width: 50%; }
class="w-x12p5" => .w-x12p5 { width: 12.5%; }

Pseudo classes

<emmet>-pse-<pseudo>
class="c-pse-hover-cf00" => .c-pse-hover-cf00:hover { color: #f00; }

Molecules - groups atomic classes together for re-use

_<className> <emmet> <emmet> <emmet>
class="_link1 c-cf00 dib lh-25px" =>

._link1 { 
  color: #f00; 
  display: inline-block; 
  line-height: 25px; }

class="_color c-cf00 _link dib lh-25px" =>

._color { 
  color: #f00; } 
._link1 { 
  display: inline-block; 
  line-height: 25px; }

Escaping SCSS generation

-<Classname>
-ignoreThis =>

Getting Started with a Sample Project

Create a folder called files, and create a file in it called index.html

<!doctype html>
<html>
<head>
    <link rel="stylesheet" href="../css/style.css">
</head>
<body>
    <div class="dib">Hello World</div>
</body>
</html>

Create a Folder called scss and create a file in it called style.scss:

@import "atomic";

Create the following file gulpfile.js:

var gulp = require('gulp'),
    atomic = require('gulp-atomicscss'),
    concat = require('gulp-concat'),
    sass = require ('gulp-sass');

gulp.task('atomic', function() {
    return gulp.src('files/*.html')
        .pipe(concat('_atomic.scss'))
        .pipe(atomic())
	.pipe(gulp.dest('scss/'));
});

gulp.task('sass', ['atomic'], function () {	
    gulp.src('scss/*.scss')
        .pipe(sass())
        .pipe(gulp.dest('css/'));
});

gulp.task('default', ['sass']);

gulp.task('watch', function() {
    gulp.watch(['files/*.html', 'scss/*.scss'], function(event) {
        gulp.start('default');
    });
});

For this gulpfile to work you will need to use the following commands:

npm install gulp
npm install gulp-atomicscss
npm install gulp-concat
npm install gulp-sass

You should now have the following directory structure:

files/
 |- index.html
scss
 |- style.scss
node-modules
 |- < . . . >
gulpfile.js

now run the command gulp, and the following files will be created:

css/
 |- style.css
scss/_atomic.scss

The file _atomic.scss should contain the following:

.dib { display: inline-block; }

The file style.css should contain the following:

.dib {
    display: inline-block; }

License

MIT License

gulpplugin scss

through2 gulp-util lodash

@infinitebrahmanuniverse/nolb-gulp-a @everything-registry/sub-chunk-1804

12 years ago

12 years ago

12 years ago

12 years ago