toolness / webmaker-landing-pages

Webmaker landing pages, built with Grunt and Metalsmith.

Webmaker Landing Pages

TL;DR

1. git clone https://github.com/mozilla/webmaker-landing-pages/
2. npm install
3. grunt dev (this will build the site & launch the local server on port 9006)

Dev Dependencies

• Node.js >= 0.8.0 & npm
• bower (via npm install -g bower)
• grunt (via npm install -g grunt-cli)

Local Dev

• npm install
• To run server: grunt dev (launch browser, http://localhost:9006/)
• [WIP] Lint before committing. Read-only with grunt validate, or take your chances on grunt.

Grunt Tasks

• grunt Cleans and verifies code. Allegedly. Needs testing.
• grunt validate Read-only version of above. Also needs testing.
• grunt build Builds the static site in /build/.
• grunt dev Builds the site, watches the folder, and launches the server.

To Deploy

• grunt build
• Sync /build to the S3 bucket of your choice.

TODO, a potentially incomplete list (see bugzilla [landingpages][techdebt])

• Test linting and whatnot
• Implement partials for signup forms
• Implement "server-side" makeapi nunjucks rendering of sample makes
• Localisation? (a girl can dream!)
• Refactor grunt watch &/or grunt connect:server to run a little cooler
• Re-figure travis deploys
• Decide whether or not to commit compiled site
• Set up server to run in a .server/ directory without usemin