As has been mentioned in previous section, Gulp is a JavaScript task runner. It helps with performing repetitive tasks like minification, compilation, unit testing, linting, etc. This is possible thanks to extensive Gulp Plugins library.
Gulp tasks are already set up for you. They are stored inside Createx/gulpfile.js
. But in order to have access to them via you Command Line tool you will need to install gulp-cli node package. Gulp CLI stands for Gulp Command Line Interface.
To do that type following line in your terminal:
npm install -g gulp-cli* if you are on Mac make sure to use sudo to install packages globally otherwise you may runt into error.
Gulp CLI commands
- gulp - this main command will fire default gulp task which includes: launching BrowserSync, vendor files concatination, javascript minification, sass compilation and lanching watch task. BrowserSync will create dev server and sync your browser with your code editor. Note: to use other separate tasks explained below you will need to open other Terminal window and leave this one with running server intact.
- gulp concat:js - concatination vendor
.js
files found inside vendor
folder in one vendor.min.js
file which are linked to your HTML document.
- gulp concat:css - concatination vendor
.css
files found inside vendor
folder in one vendor.min.css
file which are linked to your HTML document.
- gulp uglify - minify and uglify main
theme.js
file from src
folder to dist/js/theme.min.js
file which linked to your HTML document.
- gulp pug - compiles
.pug
template files into HTML. Again from src
to dist
folder.
- gulp sass:expanded - compiles
.scss
files into non-minified CSS (css/theme.css). From src
to dist
folder.
- gulp sass:minified - compiles
.scss
files into minified CSS (css/theme.min.css). From src
to dist
folder.
- gulp watch - launches
watch
task. It will watch changes of your .scss / .js / .pug files and automatically compile them into .css / .js / .html.
Next steps
Now you when you are equiped with all necessary tools and dev invironment is all set you are ready to dive into CreateX customization.
Take some time to familiarize yourself with Project structure.