Composer Local Repositories

Composer Local Repositories is a Composer plugin that lets you define local repository overrides without touching your project's composer.json. This is particularly useful when working on packages alongside the projects that consume them, where you need to point Composer at a local path temporarily without committing that change.

The Problem

When developing a package and a consuming application simultaneously, the standard approach is to add a path repository entry to composer.json. The problem is that this change is easy to accidentally commit, and it pollutes the project's version history with development-only configuration.

How It Works

The plugin introduces support for a repositories.local.json file at the project root. Any repositories defined there are automatically merged into Composer's repository list at runtime, without modifying composer.json. The local file can be safely added to .gitignore, keeping it out of version control entirely.

Contributors

This project was built with contributions from @doekenorg and @ruudk.