README.md

Foundation Grunt Boilerplate

This template is a launch pad for responsive websites. It fulfills the following requirements:

• Foundation as Bower dependency to facilitate updates
• Grunt to handle the build process
  • compile SASS to CSS (grunt-contrib-sass)
  • minify JS (grunt-contrib-uglify)
  • assemble HTML snippets into layouts (assemble)
  • watch changes and livereload (grunt-contrib-watch, grunt-contrib-connect)

Prerequisites

• Node.js
• npm (comes with Node.js)

Updating

Node.js

sudo npm cache clean -f
sudo npm install -g n
sudo n stable

(see http://davidwalsh.name/upgrade-nodejs)

npm

sudo npm install -g npm

Installation

sudo ./init.sh

• installs Node modules (e.g., grunt-cli, bower, ...)
• installs Bower dependencies and copies the relevant ones to src/

Usage

• grunt dev - makes a build and starts a livereload server (http://localhost:4000)
• grunt prod - makes a production ready build (minifies JS & CSS)
• edit "package.json" or "bower.json" if you want to update Node modules or the Foundation version and run then sudo ./init.sh

Settings

• Google Analytics - Within 'src/data/data.json' you can define the tracking ID
• Add additional variables in data.json (e.g., phone numbers as "office_phone": "1234") to reuse them easily within the HTML snippets {{office_number}}, see http://assemble.io/docs/Data.htm