# Laravel OSDD > Laravel OSDD (lomkit/laravel-osdd) splits a Laravel application into domain modules called layers: one Composer package per domain, with its own models, migrations, routes and tests, and an Artisan command, osdd:check, that fails when a layer uses a layer it does not require. It is for teams growing a Laravel application with several business domains, and needs PHP 8.3+ and Laravel 13. ## Documentation Sets - [Laravel OSDD 3.x - Full Documentation](https://laravel-osdd.lomkit.com/llms-full.txt): Every page of the Laravel OSDD 3.x documentation in one Markdown file ## How to use these docs with an AI These pages document Laravel OSDD 3.x, the current version, for Laravel 13. Laravel 12 applications stay on Laravel OSDD 2.x: the upgrade guide below lists the differences. Every page has a Markdown copy under /raw/.md. The package ships a Laravel Boost skill for coding agents, and the docs can be served to an assistant over MCP through GitMCP: see the Use with AI page. - [Use with AI](https://laravel-osdd.lomkit.com/raw/integrations/laravel-boost.md): The Laravel Boost skill, llms.txt, the Markdown copies and the MCP setup ## Getting Started - [Introduction](https://laravel-osdd.lomkit.com/raw/getting-started/introduction.md): What Laravel OSDD is, the problems it solves, when to use it instead of a plain app/ folder or another module package, and how its pieces fit together. - [Installation](https://laravel-osdd.lomkit.com/raw/getting-started/installation.md): Install Laravel OSDD and pick your path, fresh project or existing application. - [Quick Start](https://laravel-osdd.lomkit.com/raw/getting-started/quick-start.md): Convert a fresh Laravel project to layers, create your first layer and check its boundaries, in five minutes. - [Existing Application](https://laravel-osdd.lomkit.com/raw/getting-started/existing-application.md): Add layers to an application that keeps its app/ folder, and move domains into them one at a time. ## Concepts - [Layers](https://laravel-osdd.lomkit.com/raw/concepts/layers.md): What a layer is, what its composer.json declares, and how it gets installed. - [Buckets](https://laravel-osdd.lomkit.com/raw/concepts/buckets.md): The folders that hold the layers, what goes in each one, and how OSDD finds the layers inside them. - [Boundaries](https://laravel-osdd.lomkit.com/raw/concepts/boundaries.md): The rule osdd:check enforces between layers, what it reads, and how to fix or ignore a violation. - [Service Providers](https://laravel-osdd.lomkit.com/raw/concepts/service-providers.md): How each layer wires its migrations, seeders, routes, views and config through a provider of its own. ## Guides - [Add a Domain](https://laravel-osdd.lomkit.com/raw/guides/add-a-domain.md): Take a new domain from an empty layer to a routed, authorized, seeded and tested resource. - [Share Code Between Layers](https://laravel-osdd.lomkit.com/raw/guides/share-code-between-layers.md): Let one layer use another, move shared code to its own layer, and break cycles, while osdd:check stays green. - [Routes](https://laravel-osdd.lomkit.com/raw/guides/routes.md): Give a layer its own web, API, console and broadcast routes. - [Views and Components](https://laravel-osdd.lomkit.com/raw/guides/views-and-components.md): Render Blade views, translations and components from a layer, under the layer name. - [Seeders](https://laravel-osdd.lomkit.com/raw/guides/seeders.md): Give each layer its own seeders, order them across layers, and run them from osdd:seed, db:seed or your tests. - [Configuration](https://laravel-osdd.lomkit.com/raw/guides/configuration.md): Give a layer its own config file, and override the config of Laravel or any package from a layer. - [Events](https://laravel-osdd.lomkit.com/raw/guides/events.md): OSDD registers the listeners of every layer without Event::listen(), as Laravel does for app/Listeners. - [Tests and CI](https://laravel-osdd.lomkit.com/raw/guides/testing-and-ci.md): Give each layer its own test suite, run one layer's tests, and fail pull requests that cross a boundary. - [Production](https://laravel-osdd.lomkit.com/raw/guides/production.md): Deploy an OSDD application so no request scans the layer folders, and know which cache to rebuild after a change. - [Remove a Layer](https://laravel-osdd.lomkit.com/raw/guides/removing-a-layer.md): Retire a domain safely, from the layers that still use it to the tables it leaves behind. - [Multi-tenancy](https://laravel-osdd.lomkit.com/raw/guides/multi-tenancy.md): Keep the tenant migrations and seeders of each layer apart, and hand them to stancl/tenancy or spatie/laravel-multitenancy. ## Commands - [Overview](https://laravel-osdd.lomkit.com/raw/commands/overview.md): Every Artisan command Laravel OSDD registers. - [osdd:start](https://laravel-osdd.lomkit.com/raw/commands/osdd-start.md): Convert a fresh Laravel project to layers. - [osdd:layer](https://laravel-osdd.lomkit.com/raw/commands/osdd-layer.md): Create a layer, generate its first files and register it in Composer. - [osdd:list](https://laravel-osdd.lomkit.com/raw/commands/osdd-list.md): List the layers with their providers, requirements, file counts and health. - [osdd:check](https://laravel-osdd.lomkit.com/raw/commands/osdd-check.md): Check that each layer only uses the layers it requires, and that no requirements form a cycle. - [osdd:graph](https://laravel-osdd.lomkit.com/raw/commands/osdd-graph.md): Print the graph of the layers and the layers they require. - [osdd:seed](https://laravel-osdd.lomkit.com/raw/commands/osdd-seed.md): Run the seeders registered by every layer, or by some layers. - [osdd:phpunit](https://laravel-osdd.lomkit.com/raw/commands/osdd-phpunit.md): Sync phpunit.xml with the test suite and source directory of each layer. - [osdd:remove](https://laravel-osdd.lomkit.com/raw/commands/osdd-remove.md): Remove a layer that no other layer requires. - [osdd:cache](https://laravel-osdd.lomkit.com/raw/commands/osdd-cache.md): Cache the discovered layers for production, or remove that cache. - [Generators](https://laravel-osdd.lomkit.com/raw/commands/make-commands.md): The osdd:* twins of Laravel's make:* commands write inside a layer. ## API Reference - [LayerServiceProvider](https://laravel-osdd.lomkit.com/raw/api-reference/layer-service-provider.md): The base class of every layer's service provider. - [Layers](https://laravel-osdd.lomkit.com/raw/api-reference/layers.md): Discover and inspect the layers of the project from your own code. - [SeederRegistry](https://laravel-osdd.lomkit.com/raw/api-reference/seeder-registry.md): The registry that collects the seeders of every layer, and the seeder that runs them. - [Configuration](https://laravel-osdd.lomkit.com/raw/api-reference/configuration.md): Every key of the osdd config, its default, and where to set it. ## Integrations - [Use with AI](https://laravel-osdd.lomkit.com/raw/integrations/laravel-boost.md): Give coding agents and AI assistants the current Laravel OSDD docs, through the Laravel Boost skill, llms.txt, Markdown copies, GitMCP or Context7. - [Tinker and IDE Helper](https://laravel-osdd.lomkit.com/raw/integrations/tinker-and-ide-helper.md): Use short class names in Tinker, and let IDE Helper find the models of every layer. Nothing to configure. ## Upgrade - [Upgrade from 3.0](https://laravel-osdd.lomkit.com/raw/upgrade/from-3-0.md): Move a Laravel OSDD 3.0 project to 3.1. - [Upgrade from 2.x](https://laravel-osdd.lomkit.com/raw/upgrade/from-2x.md): Move a Laravel OSDD 2.x project to 3.0, step by step.