Project structure

Folder / File name Description
Around Folder contains all template source and production files.
Around / src This folder holds all template source files like .pug, .scss, .js that are then processed (compiled / minified) to dist folder.
Around / dist Folder contains all template distribution files like .html, .css, .js that have been processed (compiled / minified) from src folder using Node.js and Gulp.
Around / dist / vendor This folder contains all vendor plugins' .js / .css files.
Around / package.json File contains meta data about your app or module. Most importantly, it includes the list of dependencies to install from npm when running npm install.
Around / gulpfile.js Configuration file for Gulp library. It contains all tasks you want to perform with Gulp. Learn more about it from Working with Gulp section or official Gulp documentation.
Around / src / js This folder contains main theme.js and components subfolder with all modules. theme.js is processed (compiled / minified) into 2 files: dist/js/theme.js and dist/js/theme.min.js. The latter is linked to all .html documents.
Around / src / scss This folder contains all project sass files that are compiled and minified to styles in dist/css/ folder.
Around / src / templates This folder contains all pug files that are compiled into HTML in dist, dist/components and dist/docs folders.

Whether you work with Node.js and Gulp or not you can still take advantage of preprocessors for HTML and CSS.
In this case you might want to learn how to use Pug and Sass.

Top