PHPackages                             bobmotor/magento-2-gulp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. bobmotor/magento-2-gulp

ActiveMagento2-component[Utility & Helpers](/categories/utility)

bobmotor/magento-2-gulp
=======================

Magento 2 gulp configuration

v1.5.2(3y ago)4228.8k↓33.3%13[6 issues](https://github.com/volodymyr-lisniak/magento-2-gulp/issues)MITJavaScriptCI failing

Since Nov 20Pushed 1y ago5 watchersCompare

[ Source](https://github.com/volodymyr-lisniak/magento-2-gulp)[ Packagist](https://packagist.org/packages/bobmotor/magento-2-gulp)[ Docs](https://github.com/bobmotor/magento-2-gulp)[ RSS](/packages/bobmotor-magento-2-gulp/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)DependenciesVersions (13)Used By (0)

Getting Started
---------------

[](#getting-started)

This build supports gulp `4.x.x`. For gulp `3.x.x` use [~1.4.0](https://github.com/bobmotor/magento-2-gulp/tree/v1.4.1) version.

### Be sure that Node, NPM and Gulp are installed

[](#be-sure-that-node-npm-and-gulp-are-installed)

```
node -v && npm -v && gulp -v
```

Project integration
-------------------

[](#project-integration)

Add repository's path to the `composer.json`

```
"repositories": [
    {
        "type": "github",
        "url": "https://github.com/bobmotor/magento-2-gulp"
    }
],
```

Run

```
composer require --dev bobmotor/magento-2-gulp
```

Rename the following files in your project root directory

- `package.json.example` to `package.json`

Install modules listed as dependencies in `package.json`

```
npm install
```

or

```
yarn
```

Configuration
-------------

[](#configuration)

Make sure that you configure `dev/tools/grunt/configs/local-themes.js` file ([adobe docs](https://developer.adobe.com/commerce/frontend-core/guide/tools/grunt/#configuration-file))

Copy the contents of `local.js.example` into `local.js` in the `dev/tools/gulp/configs/` directory and setup Gulp configuration.

```
module.exports = {
    hostname: 'hostname',
    generic: 'loc',
    useHttps: false,
    useInDocker: false
};
```

### Optionally

[](#optionally)

- If you need to configure `BrowserSync` use the `dev/tools/gulp/configs/bsConfig.js`

```
module.exports = {
    proxy: `${ptotocol}://${localConfig.hostname}.${localConfig.generic}/`,
    host: `${localConfig.hostname}.${localConfig.generic}`,
    tunnel: `${localConfig.hostname}`,
    open: false
};
```

- To configure your desired screen size for the critical path use the `dev/tools/gulp/configs/criticalConfig.js`

```
module.exports = {
    out: 'critical.css',
    url: `${ptotocol}://${localConfig.hostname}.${localConfig.generic}/`,
    width: 1920,
    height: 200,
    forceExclude: [/\[data-role=main-css-loader]/]
};
```

How to use
----------

[](#how-to-use)

In project root dir run `gulp [command] --[theme] --[arguments]`

Avaliable commands:

```
babel                           Compile ES6+ to ES5
clean                           Remove cached files (pub/static/*, var/*)
critical                        Compile critical css
default, help                   Display this help message
exec                            Republishes symlinks to the source files
less                            Compile LESS to CSS
watch-scripts                   Watch for src/*.js files
watch-styles                    Watch for *.less files

```

Options:

```
--[package]                     Package name (optional field). Need to be the first option. Ex.: --blank
--min                           Minify css files
--map                           Add maping to CSS files
--live                          Enable livereload
--bs                            Enable browsersync

```

Examples:

Removes the theme related static files in the `pub/static` and `var` directories, republishes symlinks to the source files to the `pub/static/frontend/ directory` and compiles CSS files using the symlinks published in the `pub/static/frontend/ directory` with source map and minification.

```
gulp clean --luma && gulp exec --luma && gulp less --luma --map --min
```

Compiles CSS files using the symlinks published in the `pub/static/frontend/` directory with source map.

```
gulp less --luma --map
```

Watch styles with `livereload` (`LiveReload` browser extension should be installed)

```
gulp watch-styles --luma --live
```

Creates `critical.css` from `styles-l.css` and `styles-m.css` and put it to `app/design/frontend///web/css`. In `production` mode should be run after `php bin/magento s:s:d` (task uses `pub/static/deployed_version.txt` to create absolute path to the static files)

```
gulp critical --luma
```

Note:

- ES6 files should be placed at `.../web/js/src/*.js`. Compiled files will be in the `.../web/js/*.js`

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance25

Infrequent updates — may be unmaintained

Popularity40

Moderate usage in the ecosystem

Community18

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 83.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~101 days

Recently: every ~249 days

Total

12

Last Release

1256d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fcfdc99160b89d9b7f1a8276ca69b5996c08ff131a93b78a91ca1bf754af6323?d=identicon)[bobmotor](/maintainers/bobmotor)

---

Top Contributors

[![volodymyr-lisniak](https://avatars.githubusercontent.com/u/9715167?v=4)](https://github.com/volodymyr-lisniak "volodymyr-lisniak (31 commits)")[![sprankhub](https://avatars.githubusercontent.com/u/930199?v=4)](https://github.com/sprankhub "sprankhub (3 commits)")[![williamengbjerg](https://avatars.githubusercontent.com/u/54719?v=4)](https://github.com/williamengbjerg "williamengbjerg (2 commits)")[![kayintveen](https://avatars.githubusercontent.com/u/1884283?v=4)](https://github.com/kayintveen "kayintveen (1 commits)")

---

Tags

browsersynccomposercritical-csses6gulplesslivereloadmagento-2magento2npm

### Embed Badge

![Health badge](/badges/bobmotor-magento-2-gulp/health.svg)

```
[![Health](https://phpackages.com/badges/bobmotor-magento-2-gulp/health.svg)](https://phpackages.com/packages/bobmotor-magento-2-gulp)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)