finds.dev← search

// the find

ahmadawais/WPGulp

★ 1,754 · JavaScript · MIT · updated Dec 2022

An advanced Gulp workflow for WordPress development with extensive documentation. Used by 40,000+ themes and plugins.

WPGulp is a Gulp-based build workflow for WordPress theme and plugin developers, handling Sass compilation, JS bundling, image optimization, BrowserSync live reload, and POT file generation. It's a starter kit you drop into an existing WP project via npx, configure once, and run. Aimed at WordPress developers who want a traditional build pipeline without setting one up from scratch.

The zero-config startup via npx is genuinely convenient — one command scaffolds the whole setup without polluting your global npm. The wpgulp.config.js separation keeps project-specific paths out of the gulpfile, which is the right call. Media query merging during CSS build is a nice touch that most hand-rolled Gulp setups skip. Claims 40k+ plugins and themes use it, which means the sharp edges have been filed down over years of real-world use.

Last commit was December 2022 and the README still recommends Node >= 8 — this is effectively unmaintained at a time when the WordPress ecosystem has largely moved to @wordpress/scripts (webpack-based) for block development. No TypeScript support, no ESM, no PostCSS pipeline beyond autoprefixer — it's firmly 2018-era tooling. Updating it involves re-running npx and manually merging your config, which is a recipe for accidentally overwriting customizations. If you're building anything that touches the block editor, this workflow is the wrong starting point.

View on GitHub → Homepage ↗

// want more like this?

We dig through GitHub every week and send a few repos picked for what you actually care about — each with an honest take like this one.

Get finds in your inbox → Search again →