PHPackages                             symplify/monorepo-builder - 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. symplify/monorepo-builder

ActiveLibrary[Utility & Helpers](/categories/utility)

symplify/monorepo-builder
=========================

Not only Composer tools to build a Monorepo.

12.5.2(1mo ago)5205.3M—8.2%46[7 issues](https://github.com/symplify/monorepo-builder/issues)20MITPHPPHP >=8.2CI passing

Since Jun 10Pushed 1mo ago11 watchersCompare

[ Source](https://github.com/symplify/monorepo-builder)[ Packagist](https://packagist.org/packages/symplify/monorepo-builder)[ Fund](https://www.paypal.me/rectorphp)[ GitHub Sponsors](https://github.com/tomasvotruba)[ RSS](/packages/symplify-monorepo-builder/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (46)Versions (567)Used By (20)

Monorepo Builder
================

[](#monorepo-builder)

[![Downloads total](https://camo.githubusercontent.com/5dc91e0266e06abd90ccd8d84e1ca0a118271d7967e642df54cc620f4f45580a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73796d706c6966792f6d6f6e6f7265706f2d6275696c6465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/symplify/monorepo-builder)

A set of tools for managing PHP monorepos: merging `composer.json` files, validating package versions, releasing with automation, and more.

Install
-------

[](#install)

```
composer require monorepo-php/monorepo --dev
```

Requires PHP 8.2+. For PHP 8.1, use `symplify/monorepo-builder:^11.2` (no longer maintained).

Quick Start
-----------

[](#quick-start)

If you're new to monorepos, generate a basic structure:

```
vendor/bin/monorepo-builder init
```

All configuration goes in `monorepo-builder.php` at your project root.

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

[](#configuration)

### Package Directories

[](#package-directories)

By default, packages are discovered from `./packages`. To customize:

```
use Symplify\MonorepoBuilder\Config\MBConfig;

return static function (MBConfig $mbConfig): void {
    $mbConfig->packageDirectories([
        __DIR__ . '/packages',
        __DIR__ . '/projects',
    ]);

    // exclude specific packages
    $mbConfig->packageDirectoriesExcludes([__DIR__ . '/packages/secret-package']);
};
```

Commands
--------

[](#commands)

### merge

[](#merge)

Merges all sections from package `composer.json` files into the root `composer.json`. For the reverse direction, see [`propagate`](#propagate).

```
vendor/bin/monorepo-builder merge
```

**Behavior:**

- All sections are merged, including standard (`require`, `autoload`, etc.) and custom ones (`scripts-aliases`, `abandoned`, etc.)
- If a package appears in both `require` and `require-dev`, the `require` entry takes priority
- The original key order of the root `composer.json` is preserved; new sections are appended at the end

**Append and remove data after merge:**

```
use Symplify\MonorepoBuilder\ComposerJsonManipulator\ValueObject\ComposerJsonSection;
use Symplify\MonorepoBuilder\Config\MBConfig;
use Symplify\MonorepoBuilder\ValueObject\Option;

return static function (MBConfig $mbConfig): void {
    // add data after merge (supports any composer.json key)
    $mbConfig->dataToAppend([
        ComposerJsonSection::AUTOLOAD_DEV => [
            'psr-4' => [
                'Symplify\Tests\\' => 'tests',
            ],
        ],
        ComposerJsonSection::REQUIRE_DEV => [
            'phpstan/phpstan' => '^2.1',
        ],
    ]);

    // remove data after merge
    $mbConfig->dataToRemove([
        ComposerJsonSection::REQUIRE => [
            // removed by key, version is irrelevant
            'phpunit/phpunit' => '*',
        ],
        ComposerJsonSection::REPOSITORIES => [
            Option::REMOVE_COMPLETELY,
        ],
    ]);
};
```

**Custom section order:**

By default, the original key order is preserved. To enforce a specific order:

```
use Symplify\MonorepoBuilder\Config\MBConfig;
use Symplify\MonorepoBuilder\Merge\JsonSchema;

return static function (MBConfig $mbConfig): void {
    $mbConfig->composerSectionOrder(JsonSchema::getProperties());
};
```

### validate

[](#validate)

Checks that all packages use the same version for shared dependencies:

```
vendor/bin/monorepo-builder validate
```

### bump-interdependency

[](#bump-interdependency)

Updates mutual dependencies between packages to a given version:

```
vendor/bin/monorepo-builder bump-interdependency "^4.0"
```

### propagate

[](#propagate)

Propagates versions from root `composer.json` to all packages (the reverse of `merge`):

```
vendor/bin/monorepo-builder propagate
```

### package-alias

[](#package-alias)

Updates the `branch-alias` in every package `composer.json` to match the current version:

```
vendor/bin/monorepo-builder package-alias
```

To customize the alias format:

```
use Symplify\MonorepoBuilder\Config\MBConfig;

return static function (MBConfig $mbConfig): void {
    // default: ".-dev"
    $mbConfig->packageAliasFormat('..x-dev');
};
```

### localize-composer-paths

[](#localize-composer-paths)

Sets mutual package paths to local packages for pre-split testing:

```
vendor/bin/monorepo-builder localize-composer-paths
```

### release

[](#release)

Automates the release process: bumping dependencies, tagging, pushing, and updating changelogs.

```
vendor/bin/monorepo-builder release v7.0
```

Preview what will happen without making changes:

```
vendor/bin/monorepo-builder release v7.0 --dry-run
```

Release by semver level (`patch`, `minor`, or `major`):

```
# current v0.7.1 -> v0.7.2
vendor/bin/monorepo-builder release patch
```

**Configuring release workers:**

`TagVersionReleaseWorker` and `PushTagReleaseWorker` are enabled by default. Add more workers or customize the order:

```
use Symplify\MonorepoBuilder\Config\MBConfig;
use Symplify\MonorepoBuilder\Release\ReleaseWorker\AddTagToChangelogReleaseWorker;
use Symplify\MonorepoBuilder\Release\ReleaseWorker\PushNextDevReleaseWorker;
use Symplify\MonorepoBuilder\Release\ReleaseWorker\PushTagReleaseWorker;
use Symplify\MonorepoBuilder\Release\ReleaseWorker\SetCurrentMutualDependenciesReleaseWorker;
use Symplify\MonorepoBuilder\Release\ReleaseWorker\SetNextMutualDependenciesReleaseWorker;
use Symplify\MonorepoBuilder\Release\ReleaseWorker\TagVersionReleaseWorker;
use Symplify\MonorepoBuilder\Release\ReleaseWorker\UpdateBranchAliasReleaseWorker;
use Symplify\MonorepoBuilder\Release\ReleaseWorker\UpdateReplaceReleaseWorker;

return static function (MBConfig $mbConfig): void {
    $mbConfig->workers([
        UpdateReplaceReleaseWorker::class,
        SetCurrentMutualDependenciesReleaseWorker::class,
        AddTagToChangelogReleaseWorker::class,
        TagVersionReleaseWorker::class,
        PushTagReleaseWorker::class,
        SetNextMutualDependenciesReleaseWorker::class,
        UpdateBranchAliasReleaseWorker::class,
        PushNextDevReleaseWorker::class,
    ]);
};
```

To disable the default workers:

```
return static function (MBConfig $mbConfig): void {
    $mbConfig->disableDefaultWorkers();
};
```

You can also add custom workers by implementing `ReleaseWorkerInterface`.

**Branch-aware tag validation (LTS):**

If you maintain multiple version lines, the release command may reject older versions because it compares against the most recent tag globally. Enable branch-aware validation to compare only within the same major version:

```
use Symplify\MonorepoBuilder\Config\MBConfig;
use Symplify\MonorepoBuilder\Git\BranchAwareTagResolver;
use Symplify\MonorepoBuilder\Contract\Git\TagResolverInterface;

return static function (MBConfig $mbConfig): void {
    $services = $mbConfig->services();
    $services->set(BranchAwareTagResolver::class);
    $services->alias(TagResolverInterface::class, BranchAwareTagResolver::class);
};
```

Package Splitting
-----------------

[](#package-splitting)

To split packages into separate repositories, use [symplify/github-action-monorepo-split](https://github.com/symplify/github-action-monorepo-split) with GitHub Actions.

###  Health Score

76

—

ExcellentBetter than 100% of packages

Maintenance89

Actively maintained with recent releases

Popularity65

Solid adoption and visibility

Community41

Growing community involvement

Maturity95

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 93.7% 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 ~5 days

Recently: every ~26 days

Total

566

Last Release

54d ago

Major Versions

v7.3.18 → v8.0.0-beta12020-05-16

8.3.48 → 9.0.0-BETA12020-11-14

9.4.70 → 10.0.0-beta12021-11-02

10.3.3 → 11.0.12022-06-13

11.2.23 → 12.0.02025-08-06

PHP version history (9 changes)v4.4.2PHP ^7.1

v7.0.0PHP ^7.2

8.2.17PHP ^7.2|^8.0

8.3.0PHP >=7.2

9.0.0-rc1PHP >=7.3

v9.3.27PHP >=8.0

9.4.6PHP >=7.1

11.1.25PHP >=8.1

12.1.0PHP >=8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/924196?v=4)[Tomas Votruba](/maintainers/TomasVotruba)[@TomasVotruba](https://github.com/TomasVotruba)

---

Top Contributors

[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (1715 commits)")[![kayw-geek](https://avatars.githubusercontent.com/u/29700073?v=4)](https://github.com/kayw-geek "kayw-geek (41 commits)")[![TomasVotruba](https://avatars.githubusercontent.com/u/924196?v=4)](https://github.com/TomasVotruba "TomasVotruba (35 commits)")[![samsonasik](https://avatars.githubusercontent.com/u/459648?v=4)](https://github.com/samsonasik "samsonasik (26 commits)")[![garrettw](https://avatars.githubusercontent.com/u/84885?v=4)](https://github.com/garrettw "garrettw (3 commits)")[![elliotbruneel](https://avatars.githubusercontent.com/u/37578863?v=4)](https://github.com/elliotbruneel "elliotbruneel (2 commits)")[![tchapuis](https://avatars.githubusercontent.com/u/15218089?v=4)](https://github.com/tchapuis "tchapuis (2 commits)")[![AntonEvers](https://avatars.githubusercontent.com/u/1489129?v=4)](https://github.com/AntonEvers "AntonEvers (2 commits)")[![RobinDev](https://avatars.githubusercontent.com/u/3944894?v=4)](https://github.com/RobinDev "RobinDev (1 commits)")[![georgique](https://avatars.githubusercontent.com/u/15987211?v=4)](https://github.com/georgique "georgique (1 commits)")[![jdreesen](https://avatars.githubusercontent.com/u/424602?v=4)](https://github.com/jdreesen "jdreesen (1 commits)")[![elpadi](https://avatars.githubusercontent.com/u/1967321?v=4)](https://github.com/elpadi "elpadi (1 commits)")[![tacman](https://avatars.githubusercontent.com/u/619585?v=4)](https://github.com/tacman "tacman (1 commits)")

---

Tags

composermonorepophp

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StyleECS

Type Coverage Yes

### Embed Badge

![Health badge](/badges/symplify-monorepo-builder/health.svg)

```
[![Health](https://phpackages.com/badges/symplify-monorepo-builder/health.svg)](https://phpackages.com/packages/symplify-monorepo-builder)
```

###  Alternatives

[symfony/maker-bundle

Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code.

3.4k111.1M568](/packages/symfony-maker-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19562.3M1.3k](/packages/drupal-core)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)

PHPackages © 2026

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