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 &amp; Helpers](/categories/utility)
4. /
5. inpsyde/composer-assets-compiler

ActiveComposer-plugin[Utility &amp; 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(3y ago)24296.8k↓30.8%3[3 issues](https://github.com/inpsyde/composer-asset-compiler/issues)[3 PRs](https://github.com/inpsyde/composer-asset-compiler/pulls)1MITPHPPHP &gt;= 7.2 &lt; 8.3CI failing

Since Aug 10Pushed 2w 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 3d ago

READMEChangelog (10)Dependencies (7)Versions (36)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

57

—

FairBetter than 98% of packages

Maintenance61

Regular maintenance activity

Popularity44

Moderate usage in the ecosystem

Community26

Small or concentrated contributor base

Maturity82

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 84.6% 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 ~76 days

Recently: every ~209 days

Total

29

Last Release

17d 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-dev2026-06-17

PHP version history (3 changes)1.0.0PHP &gt;= 7.2

3.0.0PHP &gt;= 7.2 &lt; 8.3

v3.x-devPHP &gt;= 7.2 &lt;= 8.4

### 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://avatars.githubusercontent.com/u/3417446?v=4)[Christian Leucht](/maintainers/Chrico)[@Chrico](https://github.com/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 (17 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

[symfony/runtime

Enables decoupling PHP applications from global state

74798.8M1.0k](/packages/symfony-runtime)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5445.2M563](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2124.7M202](/packages/drupal-core-project-message)[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.

3014.6M26](/packages/vaimo-composer-patches)[sandersander/composer-link

Adds ability to link local packages for development with composer

98457.9k](/packages/sandersander-composer-link)[phpro/grumphp-shim

GrumPHP Phar distribution

294.7M340](/packages/phpro-grumphp-shim)

PHPackages © 2026

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