{"id":15441,"library":"gulp-build","title":"Gulp Build for Handlebars Templating","description":"The package `gulp-build` (version 0.5.3) is a Gulp 3 plugin designed to process files by swapping in variables using Handlebars templates. It facilitates building files for different environments by dynamically injecting data like Google Analytics IDs or compiling static HTML. Key features include support for Handlebars helpers, partials, and layouts, which were introduced in version 0.5.0, replacing earlier Underscore template integration. The plugin's current version (0.5.3) dates back to 2014 based on the copyright notice in its README, suggesting a lack of recent development. Its release cadence is effectively halted. It differentiates itself by providing a simple Handlebars-based templating pipeline within a Gulp 3 workflow, though a noted limitation is that partials and layouts must be provided as raw strings rather than file globs. Given its age and the fact that Gulp itself has advanced significantly beyond version 3, this package is effectively abandoned and may not be compatible with modern Gulp setups.","status":"abandoned","version":"0.5.3","language":"javascript","source_language":"en","source_url":"git://github.com/tjeastmond/gulp-build","tags":["javascript","underscore","gulpplugin","build","handlebars","partials","gulp"],"install":[{"cmd":"npm install gulp-build","lang":"bash","label":"npm"},{"cmd":"yarn add gulp-build","lang":"bash","label":"yarn"},{"cmd":"pnpm add gulp-build","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency, as this is a Gulp plugin. Specifically designed for Gulp 3.","package":"gulp","optional":false},{"reason":"Internal templating engine used for processing files.","package":"handlebars","optional":false}],"imports":[{"note":"This package is a CommonJS module and does not support ES modules directly. It is designed for Gulp 3, which often used CommonJS.","wrong":"import build from 'gulp-build';","symbol":"build","correct":"const build = require('gulp-build');"}],"quickstart":{"code":"const gulp = require('gulp');\nconst build = require('gulp-build');\nconst path = require('path');\n\n// Pre-requisites:\n// 1. Create a 'src' directory in your project root.\n// 2. Inside 'src', create 'index.html' with content like:
'\n }],\n layout: '{{title}}\\n{{> body}}\\n'\n};\n\ngulp.task('build-html', function() {\n // Processes HTML files from the 'src' directory\n // and outputs them to a 'dist' directory.\n return gulp.src(path.join(__dirname, 'src', '*.html'))\n .pipe(build({ title: 'My Awesome Website' }, buildOptions))\n .pipe(gulp.dest(path.join(__dirname, 'dist')));\n});\n\n// To run this task, execute `gulp build-html` in your terminal.","lang":"javascript","description":"Demonstrates basic usage of `gulp-build` to process HTML files using Handlebars with dynamic data, partials, and a layout."},"warnings":[{"fix":"Rewrite all existing Underscore templates to Handlebars syntax. Consult Handlebars documentation for syntax and helper migration.","message":"Version 0.5.0 introduced a significant breaking change by migrating the templating engine from Underscore templates to Handlebars. Projects upgrading from versions prior to 0.5.0 will need to rewrite their templates to conform to Handlebars syntax.","severity":"breaking","affected_versions":">=0.5.0"},{"fix":"Ensure your `config.layout` string explicitly includes `{{> body}}` where you want the main content to be inserted.","message":"When using layouts, the `{{> body}}` Handlebars partial is mandatory within your layout string. Omitting this tag will result in the main content of your source files not being injected into the layout, leading to empty or incomplete output files.","severity":"gotcha","affected_versions":">=0.5.0"},{"fix":"Manually read partial and layout files into strings before passing them to the `gulp-build` options. For example, use `fs.readFileSync` to load templates.","message":"The `partials` and `layout` options only accept strings for their template definitions. There is no built-in support for globbing file paths for partials or layouts, meaning all template content must be provided inline or read into strings programmatically.","severity":"gotcha","affected_versions":">=0.5.0"},{"fix":"Evaluate alternative, actively maintained templating plugins for Gulp or migrate to a different build system if Gulp 3 compatibility is not critical.","message":"This package is designed for Gulp 3 and has not been updated since 2014 (version 0.5.3). It is effectively abandoned and may not be compatible with newer versions of Node.js or Gulp (Gulp 4+). Consider using more modern templating solutions or Gulp plugins.","severity":"deprecated","affected_versions":">=0.5.3"}],"env_vars":null,"last_verified":"2026-04-21T00:00:00.000Z","next_check":"2026-07-20T00:00:00.000Z","problems":[{"fix":"Edit your `config.layout` string to include `{{> body}}` at the position where the main file content should be rendered.","cause":"The layout string passed to `gulp-build` does not contain the mandatory `{{> body}}` tag.","error":"Compiled file is missing the main content or appears empty."},{"fix":"Rewrite your templates from Underscore.js syntax to Handlebars syntax. Ensure all helpers, partials, and data references conform to Handlebars specifications.","cause":"Attempting to use `gulp-build` with templates written in Underscore.js syntax after upgrading to version 0.5.0 or later, which switched to Handlebars.","error":"TypeError: Cannot read properties of undefined (reading 'registerHelper') or similar Handlebars errors."}],"ecosystem":"npm"}