#laravel-modules

Web Development

A modular monolith in Laravel with laravel-modules: boundaries, contracts and when not to split

Rafael Domínguez · Apr 30, 2026 · 7 min read

Our subscription platform had grown into a Laravel app with 400 models in one namespace, and every change risked breaking billing. We restructured it into modules with nwidart/laravel-modules: what a module owns, how modules talk through contracts and events, and where a module is the wrong tool.

Web Development Bug Report

New Laravel module worked locally but "Class not found" in production: the composer merge plugin

Rafael Domínguez · Nov 1, 2025 · 7 min read

A new module built with nwidart/laravel-modules worked on every laptop, then production threw Class not found for its service provider right after deploy. The module's composer.json was never merged into the root autoloader in the image build, and an authoritative classmap froze the result.