node package manager


{{css}} NPM version

Handlebars helper for adding stylesheets based on config settings.

This helper can optionally manage:

  • minification
  • revisioning / cache-busting
  • copying files to dest directory (e.g. assets/css/)
  • deleting files prior to each build


  <link rel="stylesheet" href="{{@path}}">

Results in something like:

<link rel="stylesheet" href="../../../assets/css/">
<link rel="stylesheet" href="../../../assets/css/42772.banner.min.css">
<link rel="stylesheet" href="../../../assets/css/39528.body.min.css">
<link rel="stylesheet" href="../../../assets/css/73095.button.min.css">
<link rel="stylesheet" href="../../../assets/css/1dd65.callouts.min.css">
<link rel="stylesheet" href="../../../assets/css/efcde.examples.min.css">
<link rel="stylesheet" href="../../../assets/css/9eaf6.footer.min.css">


Install with npm

npm i handlebars-helper-css --save-dev

Install with bower

bower install handlebars-helper-css --save-dev

Register the helper

The easiest way to register the helper with Assemble is to add the module to devDependencies and keywords in your project's package.json:

  "devDependencies": {
    "handlebars-helper-css": "*"
  "keywords": [

Alternatively, to register the helper explicitly in the Gruntfile:

  assemble: {
    options: {
      // the 'handlebars-helper-css' npm module must also be listed in 
      // devDependencies for assemble to automatically resolve the helper 
      helpers: ['handlebars-helper-css', 'foo/*.js']
    files: {
      'dist/': ['src/templates/*.hbs']


Jon Schlinkert

License and Copyright

Copyright (c) 2014 Jon Schlinkert, contributors. Licensed under the MIT License