Splitting the Repo – Git Fission

By Oscar Merida

Managing a new PHP project often begins with a “monorepo” approach for the sake of convenience and rapid development. However, as the Spacetraders.io client evolved to include a CLI, a Web GUI, and a suite of REST clients, the initial simplicity has turned into a tangled web of dependencies. It’s time to improve maintainability and allow for easier collaboration with some “Git Fission”—splitting our repository while preserving the commit history. > > This month, let’s see a technical roadmap you can adapt to deconstruct a monolithic repository into more modular components. I’ll show you how to use `git-filter-repo`, walk through renaming namespaces, and see how to use a newly split component as a dependency in Composer. by Oscar Merida

This article was originally published in the April 2026 issue of PHP Architect magazine. To read the complete article please subscribe or purchase the complete issue.

Leave a comment

Use the form below to leave a comment: