php-forge/foxy

Fast, reliable, and secure Bun/NPM/Yarn/pnpm bridge for Composer

0.2.0 2026-01-24 22:09 UTC

Requires

• php: ^8.1
• composer-plugin-api: ^2.0
• ext-ctype: *
• ext-mbstring: *
• composer/composer: ^2.8
• composer/semver: ^3.4
• symfony/console: ^6.0|^7.0

Requires (Dev)

• maglnet/composer-require-checker: ^4.7
• php-forge/coding-standard: ^0.1
• php-forge/support: ^0.3
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.1
• phpstan/phpstan-strict-rules: ^2.0.3
• phpunit/phpunit: ^10.5
• xepozz/internal-mocker: ^1.4

Suggests

• infection/infection: Mutation testing

BSD-3-Clause

• nodejs
• package
• asset
• composer
• Bridge
• npm
• dependency manager
• yarn
• bun

README

Foxy

Foxy is a Composer plugin that aggregates asset dependencies from Composer packages into a single package.json and runs Bun, npm, Yarn, or pnpm while preserving the Composer state on failures.

Features

Installation

composer require php-forge/foxy:^0.1

Manager can be bun, npm, yarn or pnpm. For default, npm is used.

{
    "require": {
        "php-forge/foxy": "^0.1"
    },
    "config": {
        "foxy": {
            "manager": "bun"
        }
    }
}

Quick start

Standard PHP project (Yii2)

In a standard PHP application, keep a package.json file at the project root. Foxy will merge asset dependencies from installed Composer packages and run the configured manager during Composer install and update.

Example (Yii2 app template):

Yii2 app template

{
    "require": {
        "php-forge/foxy": "^0.1"
    },
    "config": {
        "foxy": {
            "manager": "npm"
        }
    }
}

Drupal layout (package.json under web/)

In a typical Drupal proof-of-concept workflow, Composer stays at the repository root while frontend tooling and builds live under web/.

Foxy lets you keep that layout while still aggregating asset dependencies and running npm in the correct directory, with Composer state preserved if the install fails.

• Aggregates asset dependencies declared by Composer packages into a single npm install.
• Keeps asset tooling configuration consistent across local and CI environments.
• Restores Composer lock and PHP dependencies if npm exits with an error.
• Runs npm against the web/ package.json without moving Composer files.

{
    "config": {
        "foxy": {
            "manager": "npm",
            "root-package-json-dir": "web"
        }
    }
}

Documentation

• 📚 Guide
• 💡 Usage
• ⚙️ Configuration
• 📅 Events
• ❓ FAQs
• 🧪 Testing Guide
• 🛠️ Development Guide

Package information

Quality code

Our social networks

License