PHPackages                             inpsyde/composer-assets-compiler - 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. inpsyde/composer-assets-compiler

ActiveComposer-plugin[Utility & Helpers](/categories/utility)

inpsyde/composer-assets-compiler
================================

Composer plugin that installs and compile frontend dependencies for installed Composer packages based on configuration.

3.0.1(2y ago)25278.4k↑14.2%2[2 PRs](https://github.com/inpsyde/composer-asset-compiler/pulls)1MITPHPPHP >= 7.2 < 8.3CI passing

Since Aug 10Pushed 3mo ago8 watchersCompare

[ Source](https://github.com/inpsyde/composer-asset-compiler)[ Packagist](https://packagist.org/packages/inpsyde/composer-assets-compiler)[ RSS](/packages/inpsyde-composer-assets-compiler/feed)WikiDiscussions v3.x Synced 1mo ago

READMEChangelog (10)Dependencies (7)Versions (35)Used By (1)

Composer Asset Compiler
=======================

[](#composer-asset-compiler)

[![PHP Static Analysis](https://github.com/inpsyde/composer-asset-compiler/actions/workflows/php-static-analysis.yml/badge.svg)](https://github.com/inpsyde/composer-asset-compiler/actions/workflows/php-static-analysis.yml)[![PHP Unit Tests](https://github.com/inpsyde/composer-asset-compiler/actions/workflows/php-unit-tests.yml/badge.svg)](https://github.com/inpsyde/composer-asset-compiler/actions/workflows/php-unit-tests.yml)

---

What is this
------------

[](#what-is-this)

A Composer plugin that automatically "compiles" frontend assets (js, css, etc.) for packages installed via Composer.

A quick example
---------------

[](#a-quick-example)

Let's assume we have a website project having a `composer.json` that looks like this:

```
{
    "name": "acme/my-project",
    "require": {
        "acme/foo": "^1",
        "acme/bar": "^2",
        "inpsyde/composer-assets-compiler": "^3"
    },
    "extra": {
        "composer-asset-compiler": { "auto-run": true }
    }
}
```

And then suppose that `acme/foo`'s `composer.json` looks like this:

```
{
    "name": "acme/foo",
    "extra": {
        "composer-asset-compiler": "gulp"
    }
}
```

and `acme/bar`'s `composer.json` looks like this:

```
{
    "name": "acme/bar",
    "extra": {
        "composer-asset-compiler": "build"
    }
}
```

When we'll install the project with Composer, the following happens:

1. Composer installs the three required packages
2. Immediately after that, the plugin executes and:
    1. the plugin looks for all installed packages (including transitive dependencies) that have a `composer-asset-compiler` configuration, finding `"acme/foo"`and `"acme/bar"`
    2. moves to `"acme/foo"` installation folder, and executes `npm install && npm run gulp`
    3. moves to `"acme/bar"` installation folder, and executes `npm install && npm run build`

At the end of the process, we have a project with the dependencies installed, and their assets processed.

The example above is the simplest use case, but the plugin has many possible configurations and advanced use cases.

Documentation
-------------

[](#documentation)

- [Introduction](docs/001-Introduction.md)
- [Compiling Assets](docs/002-Compiling_Assets.md)
- [Script](docs/003-Script.md)
- [Dependencies](docs/004-Dependencies.md)
- [Package Manager](docs/005-Package_Manager.md)
- [Pre-compilation](docs/006-Pre-compilation.md)
- [Hash and Lock](docs/007-Hash_and_Lock.md)
- [Execution Mode](docs/008-Execution_Mode.md)
- [Configuration File](docs/009-Configuration_File.md)
- [Packages Configuration in Root](docs/010-Packages_Configuration_in_Root.md)
- [Verbosity](docs/011-Verbosity.md)
- [Isolated Cache](docs/012-Isolated_Cache.md)
- [Parallel Assets Processing](docs/013-Parallel_Assets_Processing.md)
- [Configuration Cheat-Sheet](docs/014-Configuration-Cheat-Sheet.md)
- [CLI Parameters](docs/015-CLI-Parameters.md)
- [Environment Variables](docs/016-Environment_Variables.md)

Copyright and License
---------------------

[](#copyright-and-license)

Good news, this library is free for everyone! Since it's released under the MIT License you can use it free of charge on your personal or commercial website.

###  Health Score

55

—

FairBetter than 98% of packages

Maintenance55

Moderate activity, may be stable

Popularity44

Moderate usage in the ecosystem

Community25

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 85.2% 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 ~58 days

Recently: every ~81 days

Total

29

Last Release

483d ago

Major Versions

2.5.0 → 3.0.0-beta.22021-12-29

2.5.2 → 3.0.0-beta.72022-05-11

3.0.1 → v4.x-dev2024-03-03

v1.x-dev → v2.x-dev2024-03-07

2.5.3 → v3.x-dev2025-01-21

PHP version history (2 changes)1.0.0PHP >= 7.2

3.0.0PHP >= 7.2 < 8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2208282?v=4)[Giuseppe Mazzapica](/maintainers/gmazzap)[@gmazzap](https://github.com/gmazzap)

![](https://www.gravatar.com/avatar/003585053f7d5d2127d31d5a4e79ba309acc075154f5752de8f429ac42c54dbe?d=identicon)[Syde](/maintainers/Syde)

![](https://www.gravatar.com/avatar/572cb5d91b21cc9879823e849607ffe88365365391d5fd01ee4efb6a3c24df1f?d=identicon)[Chrico](/maintainers/Chrico)

---

Top Contributors

[![gmazzap](https://avatars.githubusercontent.com/u/2208282?v=4)](https://github.com/gmazzap "gmazzap (208 commits)")[![Chrico](https://avatars.githubusercontent.com/u/3417446?v=4)](https://github.com/Chrico "Chrico (15 commits)")[![shvlv](https://avatars.githubusercontent.com/u/3157352?v=4)](https://github.com/shvlv "shvlv (6 commits)")[![tyrann0us](https://avatars.githubusercontent.com/u/8144115?v=4)](https://github.com/tyrann0us "tyrann0us (5 commits)")[![widoz](https://avatars.githubusercontent.com/u/1917784?v=4)](https://github.com/widoz "widoz (2 commits)")[![dnaber-de](https://avatars.githubusercontent.com/u/1133205?v=4)](https://github.com/dnaber-de "dnaber-de (1 commits)")[![daniloalvess](https://avatars.githubusercontent.com/u/6590844?v=4)](https://github.com/daniloalvess "daniloalvess (1 commits)")[![overclokk](https://avatars.githubusercontent.com/u/4604932?v=4)](https://github.com/overclokk "overclokk (1 commits)")[![sabali33](https://avatars.githubusercontent.com/u/645717?v=4)](https://github.com/sabali33 "sabali33 (1 commits)")[![bueltge](https://avatars.githubusercontent.com/u/133425?v=4)](https://github.com/bueltge "bueltge (1 commits)")[![somtijds](https://avatars.githubusercontent.com/u/3629600?v=4)](https://github.com/somtijds "somtijds (1 commits)")[![Biont](https://avatars.githubusercontent.com/u/4208996?v=4)](https://github.com/Biont "Biont (1 commits)")[![AlexP11223](https://avatars.githubusercontent.com/u/5680466?v=4)](https://github.com/AlexP11223 "AlexP11223 (1 commits)")

---

Tags

assetscomposercomposer-pluginfront-endfront-end-developmentnpmwebpackyarn

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/inpsyde-composer-assets-compiler/health.svg)

```
[![Health](https://phpackages.com/badges/inpsyde-composer-assets-compiler/health.svg)](https://phpackages.com/packages/inpsyde-composer-assets-compiler)
```

###  Alternatives

[vaimo/composer-patches

Applies a patch from a local or remote file to any package that is part of a given composer project. Patches can be defined both on project and on package level. Optional support for patch versioning, sequencing, custom patch applier configuration and patch command for testing/troubleshooting added patches.

2994.3M16](/packages/vaimo-composer-patches)[mglaman/composer-drupal-lenient

1317.4M15](/packages/mglaman-composer-drupal-lenient)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5341.9M446](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2122.6M172](/packages/drupal-core-project-message)[olvlvl/composer-attribute-collector

A convenient and near zero-cost way to retrieve targets of PHP 8 attributes

184108.8k8](/packages/olvlvl-composer-attribute-collector)[lullabot/drainpipe

An automated build tool to allow projects to have a set standardized operations scripts.

41716.4k2](/packages/lullabot-drainpipe)

PHPackages © 2026

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