danielcarlyle / html5_template-scss-gulp-starter-rtoero

Front-end styling and design for the latest RTOERO company website. I coded the site, based on designs from Camden Media/108 Idea Space, and then sent code to be added within a custom WordPress theme for the site.

BOOTSTRAP + GULP STARTER TEMPLATE

Note

The docs folder is for demo purposes only.

Changes should be commited to src/ files only.

How to use

The template is built with Sass and Gulp build system with these features:

• Handlebars HTML templates with Panini– Panini is a super simple flat file generator for use with Gulp. It compiles a series of HTML pages using a common layout. These pages can also include HTML partials, external Handlebars helpers, or external data as JSON.
• Sass compilation, prefixing with Autoprefixer, and JavaScript concatenation
• Built-in BrowserSync server - Will automatically reload your page when files are changed. It also live-injects CSS changes when you save a Sass file. This task runs continuously. Defaults to localhost.
• For production builds - CSS compression, JavaScript compression, Image compression and more..

Requirements

To use this template, your computer needs:

• Node.js is used to run the build processes. https://nodejs.org/en/download/
• Test: run node -v in the terminal
• Npm (Node comes with npm installed so you should have a version of npm.) Used to manage development dependencies.
• Test: run npm -v in the terminal
• Gulp – task runner npm install -g gulp
• Test: run gulp -v in the terminal

Installing:

• Clone this repo: git clone https://github.com/johndavemanuel/bootstrap-gulp-starter-template.git
• Navigate into the repo directory: cd bootstrap-gulp-starter-template
• Install all node packages: npm install
• Run gulp development
• Your site is now viewable at this URL: http://localhost:3000
• To create compressed, production-ready assets run gulp production. This will delete everything in the dist folder and recreate all of your complied files. Never make updates directly into the dist folder as these files get overridden each time. Note: The dist folder is not kept in source control.

Folder Structure:

• dist/ - compiled distribution files
• node_modules - front-end dependencies
• src/ - contains all of your core, working files—static assets, pages, templates, etc
• src/assets/ - scss files, JS files, images, and fonts are here
• src/data/ - external data
• src/layouts/ - HTML layouts templates
• src/pages/ - site pages
• src/partials/ - handlebars partials files.
• gulpfile.js - all task definitions
• package.json - handles the front-end dependencies
• .htmllintrc - handles the HTML lint rules
• .sass-lint.yml - handles the SCSS lint rules
• reports - txt generated file for accessibility issues

Gulp Plugins:

• gulp-autoprefixer
• gulp-compile-handlebars
• gulp-concat
• gulp-cssmin
• gulp-html-replace
• gulp-htmllint
• gulp-imagemin
• gulp-pretty-html
• gulp-remove-code
• gulp-remove-logging
• gulp-rename
• gulp-sass
• node-bourbon
• gulp-sass-lint
• gulp-sourcemaps
• gulp-uglify
• gulp-newer
• gulp-accessibility
• gulp-jshint
• gulp-gulp-gh-pages
• gulp-babel
• panini
• run-sequence
• ansi-colors
• fancy-log

Additional Resources:

• Sass: Syntactically Awesome Style Sheets
• Bootstrap
• Handlebars
• Panini
• Gulp