Navel Pondering Mantra


    1.1.2 • Public • Published


    Build Status


    A gulp plugin for storing all of your lodash templates in a single cache file.

    this.tmpl = {
      "test/templates/a": function(obj) {
        obj || (obj = {});
        var __t, __p = '', __e = _.escape;
        with (obj) {
          __p += '<div>' +
          __e( a ) +
        return __p
    this.tmpl = {
      "templates/superDiv": function(){ return document.createElement('div'); }


    Install using npm

    npm install gulp-template-store

    Example use

    var gulp = require('gulp'),
      tmplStore = require('gulp-template-store')
      sources = {
        templates: 'src/html/templates/**/*.html'
      destinations = {
        tmpl: './tmp/'
    gulp.task('templates:compile', function() {
      return gulp.src(sources.templates)
          name: 'templates.js',
          variable: 'this.templateCache',
          base: 'src/html/',
          bare: false
          options: {
            interpolate: /{{([\s\S]+?)}}/g

    The featured example will generate a single file named templates.js containing all template files as keyed lodash template functions contained within an object named this.templateCache. All keys under the file will be based to src/html. In addition, the templates will also evaluate Handlebars style interpolation({{}}) as that has been passed in as an option.

    A possible output from say the files src/html/templates/a.html and src/html/templates/b.html would be;

    this.templateCache = {
      "templates/a": [function Function],
      "templates/b": [function Function]

    NOTE:: gulp-template-store aims to be platform agnostic. It has been developed on a UNIX system. Whatever base option is provided, gulp-template-store will interpret them using the current OS path separator by converting any slashes.

    By default, the keys in the resulting store will use forward slashes / (UNIX style). For example; on Windows, your template may be located at \templates\a.html. The output key will be templates/a.

    However, you can override this by setting the unix option to false if you wish for keys to use the platform path separator. Take into consideration that this may affect those working on a different platform.


    • name: {String} - Defines the filename for outputted template file.

    • variable: {String} - Defines the variable that shall be used to define the templates object. By default, this is this.tmpl.

    • base: {String} - Defines the base directory to generate key names from. By default, this is the root of the repo where your gulpfile is located.

    • unix: {Bool} - Defines whether to use forward slashes / in keys. When false, will use platform specific path separator. For Windows, \. Defaults to true.

    • bare: {Bool} - use with caution - Defines whether to use lodash templating or to simply create an object store for mapping file contents. Defaults to false.

      For example,

        this.tmpl = {
          "templates/superDiv": function() { return document.createElement('div'); }
          "templates/log"   : function(msg) { console.log(msg); }
    • options: object - defines an object containing options that will be passed to the lodash template compiler. Supported options are interpolate, imports and variable.


    Contributions are welcome. Feel free to submit a PR or open an issue if there's something you think is missing.



    @jh3y 2015


    npm i gulp-template-store

    DownloadsWeekly Downloads






    Last publish


    • jh3y