Gathering detailed insights and metrics for wp-gulp
Gathering detailed insights and metrics for wp-gulp
An advanced Gulp workflow for WordPress development with extensive documentation. Used by 40,000+ themes and plugins.
Installations
npm install wp-gulpDeveloper Guide
BETA
Typescript
No
Module System
N/A
Node Version
9.7.1
NPM Version
5.7.1
Releases
20
Languages
1
JavaScript
JavaScript (100%)
Developer
Download Statistics
Total Downloads
0
Last Day
0
Last Week
0
Last Month
0
Last Year
0
GitHub Statistics
MIT License
1,765 Stars
268 Commits
302 Forks
88 Watchers
8 Branches
22 Contributors
Updated on Jun 07, 2025
Maintainers
1
Package Meta Information
Latest Version
1.0.4
Package Id
wp-gulp@1.0.4
Unpacked Size
46.83 kB
Size
16.13 kB
File Count
8
NPM Version
5.7.1
Node Version
9.7.1
Total Downloads
Cumulative downloads
Total Downloads
NaN
Last Day
0%
NaN
Compared to previous day
Last Week
0%
NaN
Compared to previous week
Last Month
0%
NaN
Compared to previous month
Last Year
0%
NaN
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
🙌 — If 500 people signup here, I will build a video series for WPGulp.
|
WP Gulp 🎯 Use Gulp with WordPress. An advanced & heavily documented Gulp WordPress boilerplate to help you kick start a build-workflow for your WordPress plugins and themes. Gulp WordPress! | |
| A FOSS (Free & Open Source Software) project. Maintained by @AhmadAwais. |
|
WPGulp — WordPress Gulp Workflow
Use Gulp with WordPress. An advanced but portable Gulp workflow for WordPress. Start using Gulp with your WordPress plugins and themes.
Read: Introducing WPGulp: An Easy to Use WordPress Gulp Boilerplate
Table of Contents
- WPGulp — WordPress Gulp Workflow
ⓦ What Can WPGulp Do?
- Live reloads browser with BrowserSync
- CSS: Sass to CSS conversion, error catching, Autoprefixing, Sourcemaps, CSS minification, and Merging Media Queries
- JS: Concatenates & uglifies Vendor and Custom JS files
- Images: Minifies PNG, JPEG, GIF and SVG images
- Watches files for changes in CSS or JS
- Watches files for changes in PHP
- Corrects the line endings
- InjectCSS instead of browser page reload
- Generates .pot file for i18n and l10n
🎗 Getting Started?
→ Step #1. Download the Required Files
- Download
gulpfile.js,package.json, and.gitignorefiles inside the root folder of your WordPress plugin or WordPress theme - If you have cURL installed then you can run the following command to download all three files in one go (just make sure you open the root folder of your WordPress plugin or WordPress theme and download these files in the root):
1curl -O https://raw.githubusercontent.com/ahmadawais/WPGulp/master/package.json && curl -O https://raw.githubusercontent.com/ahmadawais/WPGulp/master/gulpfile.js && curl -O https://raw.githubusercontent.com/ahmadawais/WPGulp/master/.gitignore
→ STEP #2: Editing the Project Variables
Configure the project variables E.g. paths, translation data, etc. in gulpfile.js. Project variables can be found in the following two comments
1// START Editing Project Variables. 2{PROJECT VARIABLES} 3// STOP Editing Project Variables.
→ STEP #3: Installing NodeJS, NPM and Gulp
You need to have NodeJS & NPM installed. If it is installed, skip to installing Gulp. Otherwise, download NodeJS and install it. After installing NodeJS, you can verify the install of both NodeJS and Node Package Manager by typing the following commands. This step needs to be followed only once if you don't have NodeJS installed. No need to repeat it ever again.
1node -v 2# Results into v4.2.6 3 4npm -v 5# Results into 3.9.0
NodeJS and NPM are installed, now we need to install Gulp globally. To do that, run the following command
1# For MAC OS X; run the following command with super user. 2sudo npm install --global gulp 3 4# For Linux; run the following command. 5npm install --global gulp
→ STEP #4: Installing Node Dependencies
We are in the root folder of our WordPress plugin or WordPress theme at the moment, let's install the Node Dependencies. In the terminal run this command and wait for it to download all the NodeJS dependencies. It's a one-time process and can take about 5 minutes depending on the internet speed of your connection.
1# For MAC OS X run the following command with super user. 2sudo npm install 3 4# For Linux run the following command. 5npm install
→ STEP #5: Just run Gulp
Once the NodeJS dependencies are downloaded just run the following command to get up and running with WPGulp
1# To start gulp 2gulp 3 4# To stop gulp press CTRL (⌃) + C
→ Optional Step #6: Images and Translation
To optimize images and generate WP POT translation file, you can run the following commands
1# To optimize images 2gulp images 3 4# To generate WP POT translation file. 5gulp translate
How to Update?
- Delete old files and download the latest
gulpfile.js,package.json, and.gitignorefiles in the root of your WP project. - Open your WordPress project (plugin/theme) root folder in the terminal and run
1# For MAC OS X run the following command with super user. 2sudo npm install 3# For Linux run the following command. 4npm install
Wait for the new dependencies to be downloaded.
Once the download is complete type gulp and boom!
Project Dependencies
- Built with
Mac OS Xbut tested and works well withLinuxas well asWindows. - You must have Git and NodeJS, and Gulp installed globally.
WPGulpTheme
Check out a basic WordPress theme implementation with WPGulp called WPGulpTheme. This theme demonstrates the architecture followed by default within WPGulp, which is most definitely optional.
To do
It's hard to maintain a FOSS free and open source software project on my own. Which is why there is a backlog and an incomplete to-do list.
- Build WPGulp ✔︎
- Write an introductory blog post about WPGulp ✔︎
- Improve documentation with more easy to follow details ✔︎
- Find sponsorship to produce free of cost video tutorials for WPGulp ⓦ
- Write about the new WPGulp tasks,
gulp imagesto optimize images andgulp translateto generate WP POT translation file.
Contribute
I am looking for WordPress ⓦ developers to contribute. I am open to all kinds of new NodeJS packages and workflows. I can always host custom, opinionated workflows in the form of a separate branch and WPGulp. Just make sure you follow the WordPress Coding Standards.
Changelog
Version 1.0.3
- FIX: Required
gulp-wp-pot - FIX: Required
gulp-sort - IMPROVEMENT: Better docs for Translation variables
Version 1.0.2
- NEW: Documentation update
README.md - TASK: Image optimization
gulp images - TASK: WP POT Translation file generation
gulp translate
Version 1.0.1
- BrowserSync
- LineEndings
Version 1.0.0
- First version
- CSS, JS, PHP and Watch Routines
License
Released under GNU GPLv2.0 or later license. Copyright Ahmad Awais
🙌 — If 500 people signup here, I will build a video series for WPGulp.
🙌 WPCOUPLE PARTNERS:
This open source project is maintained by the help of awesome businesses listed below. What? Read more about it →
No vulnerabilities found.
Reason
no binaries found in the repo
Reason
license file detected
Details
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: MIT License: LICENSE:0
Reason
0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0
Reason
Found 2/30 approved changesets -- score normalized to 0
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
security policy file not detected
Details
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
branch protection not enabled on development/release branches
Details
- Warn: branch protection not enabled for branch 'master'
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
- Warn: 0 commits out of 2 are checked with a SAST tool
Reason
24 existing vulnerabilities detected
Details
- Warn: Project is vulnerable to: GHSA-6chw-6frg-f759
- Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw
- Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw
- Warn: Project is vulnerable to: GHSA-pp7h-53gx-mx7r
- Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
- Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
- Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
- Warn: Project is vulnerable to: GHSA-qgfr-5hqp-vrw9
- Warn: Project is vulnerable to: GHSA-3gx7-xhv7-5mx3
- Warn: Project is vulnerable to: GHSA-pfrx-2q88-qq97
- Warn: Project is vulnerable to: GHSA-rc47-6667-2j5j
- Warn: Project is vulnerable to: GHSA-qqgx-2p2h-9c37
- Warn: Project is vulnerable to: GHSA-2pr6-76vf-7546
- Warn: Project is vulnerable to: GHSA-8j8c-7jfh-h6hx
- Warn: Project is vulnerable to: GHSA-4xc9-xhrj-v574
- Warn: Project is vulnerable to: GHSA-x5rq-j2xg-h7qm
- Warn: Project is vulnerable to: GHSA-jf85-cpcp-j695
- Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw
- Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9
- Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm
- Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
- Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m
- Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h
- Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Score
1.7
/10
Last Scanned on 2025-07-14
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More