express-asset-versions

Simple versioning for assets in express.js

Usage no npm install needed!

<script type="module">
  import expressAssetVersions from 'https://cdn.skypack.dev/express-asset-versions';
</script>

README

express-asset-versions NPM version

An express.js middleware and helper to prepend your static assets with a version string.

Usage

Setup

$ npm install express-asset-versions

var express = require('express')
  , assets = require('express-asset-versions')
  , app = express();

var assetPath = path.join(__dirname, 'public');
app.use('/public', express.static(assetPath));
app.use(assets('/public', assetPath));

app.listen(3000);

Templates

// EJS
<link rel="stylesheet" href="<%= asset('css/stylesheet.css') %>" />
// Jade
link(rel='stylesheet', href=asset('css/stylesheet.css'))
// Swig
<link rel="stylesheet" href="{{ asset('css/stylesheet.css') }}" />

// Result:
<link rel="stylesheet" href="/public/css/stylesheet.css?1f05a21474" />

The asset() helper takes an optional second parameter to define a file used in production (NODE_ENV=production):

<link rel="stylesheet" href="<%= asset('css/stylesheet.css', 'css/stylesheet.min.css') %>" />

// Result:
<link rel="stylesheet" href="/public/css/stylesheet.css?1f05a21474" />     // NODE_ENV=development
<link rel="stylesheet" href="/public/css/stylesheet.min.css?73d57ce89a" /> // NODE_ENV=production