All the files you edit go into src and compiles into build

NPM is required to be installed.

Run npm install after clone to download gulp and other required modules.

gulp - builds everything into build folder

gulp build - cleans and builds everything into build folder

gulp clean - cleans build folder

gulp css - compile scss to css

gulp js - compile js with browserify

gulp assemble - generate all pages

gulp watch - look for changes in src/pages|scss|js

└── src
  ├── assets
  │    ├── js
  │    │   ├── libs
  │    │   ├── partials
  │    │   └── main.js
  │    └── scss
  │        ├── base
  │        ├── libs
  │        ├── partials
  │        ├── utils
  │        ├── main.scss
  ├── data
  │   └── *.{json,yml}
  ├── helpers
  │   └── *.js
  └── views
      ├── partials
      │   └── *.{hbs,html,php}
      ├── layouts
      │   └── default.{hbs,html,php}
      └── pages
          └── index.{hbs,html,php}

All the files in pages folder are used to generate static pages.

These files in pages should contain the core content of the page.

The layout files will contain the major layout and are referenced to by front matter(more on that below)

Pages can also load partials anywhere in the page

Pages can use YAML front matter as shown below or call a variable from a data.json file in the data folder, for things like the layout.

---
layout: 'default'
title: 'site'
arr:
- {"a":"b"}
---

this.arr.[0] // {"a","b"}

{{>nav }}

with current front matter
{{>nav this}}

with custom variable
{{>nav key="value"}}

with global data variable
{{>nav site}}

with custom json
{{#parseJSON '{
  "a": "b",
  "c": "d"
}'}}
{{> nav }}
{{/parseJSON}}

{{#parseJSON '{"name": "John", "age": "1"}'}}
    {{> partial title="TITLE" desc=../site.desc person=this}}
{{/parseJSON}}

All scss goes into "src/assets/scss/"

All scss goes into "src/assets/scss/libs"

The "_global.scss" file contains some utility classes

Using Browserify for JS

All js goes into "src/assets/js/app" Refrence js in the main.js file located in "src/assets/js/"

All libraries goes into "src/assets/js/libs"

If you do any js templating put that into "src/assets/js/templates/"