Gulp plugin that replaces @version@ placeholders in static file references with the version from package.json (or a custom JSON file) for cache-busting. Version 0.2.0 is the latest stable release. Unlike hash-based tools like gulp-rev-append, this plugin reads no file contents, making it faster for projects where all assets are bundled and change with every version bump. Supports multiple file extensions (html, js, css, etc.) and three append modes: version string, timestamp, or short GUID. The plugin is not actively maintained and relies on a deprecated template pattern (?v=@version@) rather than modern content-hashing or file-renaming approaches.
npm install gulp-version-appendNo compatibility data collected yet for this library.
Verified import paths — ran on the pinned version, not inferred.
Registers a Gulp task that replaces @version@ placeholders in HTML files with the version from package.json, then minifies the HTML.
Ensure your HTML templates use the exact placeholder format: e.g., <script src="/js/app.js?v=@version@"></script>
Use gulp v3 or wrap the task in a callback: gulp.task('html', (cb) => { ... cb(); })Use `const versionAppend = require('gulp-version-append');` not `require('gulp-version-append').default`Place version.json at the root of your project or provide an absolute path.
Run `npm install gulp-version-append --save-dev` or ensure import is correct.
Use `const versionAppend = require('gulp-version-append');` directly.Wrap the task: `gulp.task('html', function(cb) { ... cb(); })` or return the stream.Create a package.json with a 'version' field or specify `versionFile` option.