Goal

Offer a fast, Grunt based, data driven malleable static build system. Use it for any project architecture that makes html/css/js.

Overview

This project seed is cache heavy, smart loading, and mobile first out of the box. Jade & Stylus are the preprocessor defaults, but swap it for whatever you want, no limits. Want more than 1 preprocessor, it's ready. Add tasks, take care of business.

Required

Node.js and NPM
Grunt

Optional (but handy)

Quickstart

npm i -g bolt-cli: very small simple tool to install bolt into directories
bolt new my_site: my_site should be replaced with your project name
cd bolt-test && npm i: install bolt dependencies
grunt: spin it up!
See the Wiki

npm i
grunt

Build Features

Dev builds are extremely legible, source mapped, and ready for debugging with your tools grunt
Production builds squish the crap out [images,css,html,js,svg] grunt prod
Dev and Prod builds have their own output directory, they don't share a dist/ folder. No need for one build to squash the other.
Very fast, with a jit plugin for really fast task running
Concise Grunt main file
Grunt tasks are individual, short, easy as hell to read, and a breeze to create
DRY Configuration file keeps project assets and options centralized
BrowserSync dev server syncs all your clicks, scrolls, and more during development
BrowserSync live reload and hot css pushes for really rad fast front end crafting
BrowserSync Weinre remote inspect built in
Externally accessible server
Proper Jade inheritance compilation, so 1 file changed doesn't require the whole project to compile
Data driven front end development with YAML and/or JSON
Auto generated HTML5 appcache for production builds
Autoprefixed Stylus
Git tagging and releasing grunt bump
Easily create custom build notifications
Customize your crunched files comment banner
Ready to run custom shell commands
Image crunching
Sublime project file for easy project editing and standards establishment
CLI for easy setup of new projects bolt new my_app

Bolt Commands

grunt: dev server, no crunching, source maps, live reload, fast
grunt --dont-open: dev time, but don't open it in a browser for me
grunt prod: prod server, turbo crunching, no maps, ready to test before tagging or pushing
grunt compile: all the features of prod, but no server, just the crunched output
grunt serve --target=dev or grunt serve --target=prod: serve previous builds

Bolt Extras

YAML data files are fed directly into your static site template system as JSON
Mobile first
Flexboxgrid library preloaded
Extensable Jade page structure
Great Stylus base
Tons of mobile header and icons, tested and ready
HTML5 manifest.json
404 page
Robots.txt
Pretty much a progressive web app starter

Interesting Bolt Branches

koa: a server rendering seed
isomorphic: client side and static seed
remote-data: fetch remote data from an api and build a static site from it
webpack: webpack starter

argyleink/Bolt