super hash powers for express view rendering


taters is an automatic resource hashing middleware for express. Injects resource fingerprints into static resource urls. Optionally inject a prefix for CDN deployments.

    <link href="/css/style.css">
    <script src="/js/index.js"></script> 
    <link href="/static/1db360/css/style.css">
    <script src="/static/e9038a/js/index.js"></script> 

And taters will add the appropriate cache expiry headers.

var express = require('express');
var taters = require('taters');
var app = express();
app.set('view engine', 'hbs'); // or jade or whatevs 
app.set('views', __dirname + '/views');
// taters will setup itself on the app 
// you can now serve static content with the regular static middleware 
// no need to set a longer cachetime or anything since taters does that for us 
app.use(express.static(__dirname + '/public'));
// render your views as before 
// tater will replace script, link, img urls with fingerprinted ones 
app.get('/', function(reqresnext) {

Taters accepts some options to configure behavior

cacheBooleanfalsetrue will cache url hashes to be cached
prefixStringprefix all changed url with this path
middlewareFunctionoptional function called wieh /static/ middleware is encountered

middleware is an optional function which will be called when /static/ middleware is encountered. You can do things like set longer expiries, better cache headers, etc...

By default, taters middleware sets an expiry of 1 year. This lets browsers, proxies, and CDNs cache the resource for a long time since the hash changes when the resource changes.

You can detect incoming taters requests by checking if req.internalTatersRequest is true. This is helpful to bypass authentication and tweak logging.

Taters makes it very easy to use a CDN in production. Simply set the prefix option to the domain of your CDN and your resources will be served via CDN.