HTML5 boilerplate (H5BP) inspired server config for node.js
HTML5 boilerplate (H5BP) server config for node.js.
h5bp for node.js follows the guidelines of the Apache version:
- secures backup and hidden files.
- optionally redirects
yoursite.tldor vice versa.
- offers a simple cache busting mechanism.
- normalize content types.
- optionally enables CORS.
- sets correct cache expires depending of the type of resource.
- and some others...
It also focuses on offering additional features such as on-the-fly script concatenation using CommonJS or AMD.
- refactoring code and tests.
- responsive images: #13.
npm install --save h5bp
var h5bp = require'h5bp';var app = h5bpcreateServer root: __dirname + '/public' ;applisten3000;
app is an instance of an
express application. You can add additional middlewares or routes if you like.
var express = require'express'h5bp = require'h5bp';var app = express;appuseh5bp root: __dirname + '/public' ;// in order to serve files, you should add the two following middlewaresappuseexpresscompress;appuseexpressstatic__dirname + '/public';applisten3000;
If you want to split your application source files but only serve one file, you can use the on-the-fly concatenation. If you are familiar with node.js, you can use the CommonJS style. You can also use the AMD style.
appuseh5bproot: __dirname + '/public'scripts:files: 'app.js'processor: 'commonjs' // can also be "amd";
At the first request hit to
/app.js, the server will compile, cache and serve the file. Any subsequent request will
serve the cached file without any performance impact.
So, this feature is meant to be used with the cache busting mechanism in order to ensure the client always has the latest resource version. If you restart your server, the cache will be flushed.
Note that the next release will provide a development mode where the server will simply disable its cache and always serve the latest version of the file.
There are several options you can pass to the middleware.
Tells the filesystem path to the root directory of static resources. This options is mandatory if you serve static files.
Forces www if
true, forces non-www if
false, does nothing if not defined. By default, this is disabled.
Enables CORS for everything. By default this is disabled.
Tells which scripts to concatenate.
This is an object with the following properties:
This is an array of files to concatenate. Their path is relative to the
root option. Their URL will be absolute.
For example, if you set files to
['scripts/app.js'] and root to
- The path will be:
- The served URL will be:
Tells which processor to use for scripts concatenation.
For now, it can be one of the following values:
commonjs: will concatenate files using the CommonJS method (
amd: will concatenate files using the AMD method (
h5bp.createServer function takes the same options, plus additional ones.
callback is optional. It is a custom middleware that you can register directly if you want to.
Tells which type of server you want to use.
It can be one of the following values:
express: uses express, this is the default value.
connect: uses connect.
Tells if you want to log server requests or not. This can also be an object containing logger options.
Tells if you want to serve
gzipped content or not. By default this is
If you are using
h5bp as a middleware, we strongly encourage you to use the
compress middleware provided by
express / connect.