JavaScript your Embedded CoffeeScript Templates!
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Compiles Embedded CoffeeScript templates (.eco) into JavaScript functions.

Getting Started

This plugin requires Grunt >=0.4.0

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-eco --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile.js with this line of JavaScript:


This plugin was designed to work with Grunt 0.4.x and Grunt 1.x. If you're still using grunt v0.3.x it's strongly recommended that you upgrade, but in case you can't please use v0.3.1.

eco task

Run this task with the grunt eco command.

Task targets, files and options may be specified according to the grunt Configuring tasks guide.



Type: Boolean Default: false

Defines if compiled function will be wrapped in AMD define function.


Type: String Default: empty

Defines substing which gets removed from JSTpath of output template.


Type: Boolean Default: true

Defines if task will warn about empty files on console.


Type: Boolean Default: true

Defines if compiled function is prepended by code checking/defining presence of JST object on window.

please note when amd is set to true the jstGlobalCheck is ignored.


preserve_dirs and base_path options are not supported anymore! See examples how task's paths are configured now.


Two most common ways of compiling all globbed paths into single file:

eco: {
  app: {
    files: {
      'path/to/templates.js': ['src/templates/**/*.eco']
eco: {
  app: {
    src: ['src/templates/**/*.eco'],
    dest: 'path/to/templates.js'

If you need to compile .eco templates into individual files in some sort of destination folder, you can dynamiccally build path object:

eco: {
  app: {
    files: [{
      expand: true,
      src: ['src/templates/**/*.eco'],
      dest: 'path/to/templates',
      ext: '.js'

If you ommit dest key, templates will be compiled right next to your .eco files.

To configure eco task simply define options object:

eco: {
  app: {
    options: {
      amd: true
    files: {
      'path/to/templates.js': ['src/templates/**/*.eco']


This grunt plugin is based on and heavily inspired by grunt-contrib-stylus.


To start, just clone project and then run npm install in project root.

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Always lint and test your code by running grunt in project's root.

Create new GIT branch (git checkout -b my_feature) when sending pull request.

Release History

  • Jun 06, 2016 v0.1.3 - Grunt 1.0 compatibility
  • Jun 20, 2014 v0.1.2 - Bubble up task failure
  • Jun 16, 2013 v0.1.0 - Refactoring, tests, AMD support
  • Mar 04, 2013 v0.0.2 - Grunt 0.4 compatibility
  • Nov 18, 2012 v0.0.1 - Initial commit


Copyright (c) 2012 Gregor Martynus Licensed under the MIT license.