Laravel Maestro — de orchestrator voor starter kit-ontwikkeling

Dit artikel is gebaseerd op onderzoek van de broncode. Officiële documentatie bestaat nog niet en de repository is nog niet officieel uitgebracht (stand: april 2026).

Wat is Maestro?

Laravel Maestro is een monorepo-orchestrator voor het centraal beheren van de starter kits van Laravel. De starter kits van Laravel omvatten meerdere stacks — React, Vue, Svelte (Inertia) en Livewire — en daarbovenop bestaan er meer dan 15 varianten door combinaties van authenticatiemethoden (Fortify, WorkOS) en opties (Teams, Blank). Maestro beheert al deze varianten in één repository en biedt een mechanisme om wijzigingen automatisch door te voeren naar de afzonderlijke starter kit-repositories.

Welk probleem lost het op?

Wanneer starter kits over veel varianten verspreid zijn, wordt het omslachtig om één fix in alle varianten door te voeren. Het is bijvoorbeeld inefficiënt om voor een validatiefix in een authenticatieformulier aparte PR’s te maken voor React, Vue, Svelte en Livewire. Maestro lost dit op met een “hiërarchische structuur van gedeelde lagen en variantlagen”. De orchestrator bepaalt in welke laag een wijziging thuishoort en past die automatisch toe op de meest geschikte plek.

Varianten van de starter kits

De starter kits die Maestro beheert, bestaan uit twee stacks.

Livewire-stack (6 varianten)

Variant	Beschrijving
Blank	Minimale configuratie zonder authenticatie
Fortify	Authenticatie via Laravel Fortify
Fortify (Multi-file Components)	Configuratie waarbij Blade-views zijn opgesplitst in componentbestanden
Fortify (Teams)	Fortify-authenticatie + Teams-ondersteuning
WorkOS	Authenticatie via WorkOS
WorkOS (Teams)	WorkOS-authenticatie + Teams-ondersteuning

Inertia-stack (15 varianten)

Met de combinatie van 3 frameworks (React, Vue, Svelte) × Blank, Fortify en WorkOS × wel of geen Teams bestaan er in totaal 15 varianten.

Structuur van de repository

laravel/maestro/
├── orchestrator/    # Laravel-app die de builds beheert
│   ├── app/Console/Commands/BuildCommand.php
│   ├── app/Enums/StarterKit.php
│   └── scripts/
├── kits/            # Bronbestanden van de starter kits
│   ├── Shared/      # Bestanden gedeeld door alle varianten
│   ├── Livewire/    # Livewire-specifieke bestanden
│   └── Inertia/     # Inertia-specifieke bestanden (React/Vue/Svelte)
└── browser_tests/   # Browsertests
    ├── bootstrap/
    ├── common/
    └── teams/

De map orchestrator is zelf een Laravel-applicatie die het bouwen en uitvoeren van de starter kits beheert.

Het bestandslagen-systeem

De kern van Maestro is het mechanisme waarbij starter kits worden samengesteld door lagen te stapelen. Bij Livewire (Fortify) worden bestanden in de volgende volgorde gekopieerd, waarbij latere lagen eerdere lagen overschrijven. Dankzij deze lagenstructuur geldt er een duidelijke regel: fixes die voor alle kits gelden gaan in Shared/, Livewire-specifieke fixes in Livewire/.

De bijdrage-workflow

Bijdragen aan de starter kits doe je niet in de afzonderlijke starter kit-repositories, maar in deze Maestro-repository.

Ga naar de orchestrator-map en bouw een kit

cd orchestrator
php artisan build

Via een interactieve prompt kies je de doelkit en de authenticatievariant. Je kunt ze ook direct opgeven met flags.

php artisan build --kit=vue
php artisan build --kit=react --workos
php artisan build --kit=livewire --teams
php artisan build --kit=vue --workos --teams

Start de gebouwde kit

composer kit:run

De ontwikkelserver van Laravel en een file watcher starten tegelijk. Wijzigingen die je in de map build/ maakt, worden automatisch naar de juiste plek in kits/ gekopieerd.

Breng wijzigingen aan en test

Bewerk de bestanden in de map build/. De watcher detecteert de wijzigingen en zet ze automatisch door naar de map kits/.

Maak een PR

Commit de wijzigingen in de map kits/ en maak een PR. Na het mergen pusht Maestro de wijzigingen automatisch naar de afzonderlijke starter kit-repositories.

De map build/ staat in de gitignore. Voer al je wijzigingen door in build/, laat de watcher ze synchroniseren naar kits/ en commit daarna.

Overige ontwikkelcommando’s

Linten

# Pint uitvoeren op kits en browser_tests (alleen PHP)
composer kits:pint

# PHP-lint + frontend-lint van elke Inertia-variant
composer kits:lint

# Alleen een specifiek framework als doel nemen
composer kits:lint -- --vue
composer kits:lint -- --react --svelte

Browsertests

# Browsertests uitvoeren voor alle varianten
composer kits:browser-tests

# Beperken tot een specifiek framework of specifieke variant
composer kits:browser-tests -- --vue
composer kits:browser-tests -- --livewire --fortify

De browsertests draaien op Pest + Playwright. In de map browser_tests/ zijn de tests georganiseerd in drie lagen: bootstrap/ (gedeelde configuratie), common/ (voor Fortify) en teams/ (voor Teams).

Filteren met flags

Bij elk commando kun je het doel beperken door de flags --livewire, --react, --svelte en --vue te combineren met de flags --blank, --fortify, --workos en --teams.

# Alleen de Fortify-varianten van Vue en Svelte checken
composer kits:check -- --vue --svelte --fortify

# Alleen de WorkOS-varianten van alle frameworks
composer kits:check -- --workos

WorkOS-omgevingsvariabelen instellen

Als je een WorkOS-variant wilt bouwen en uitvoeren, stel je in orchestrator/.env de client-ID en API-sleutel van WorkOS in. Tijdens de build worden deze waarden gekopieerd naar het .env-bestand in de map build/.

# orchestrator/.env
WORKOS_CLIENT_ID=your_client_id
WORKOS_API_KEY=your_api_key

Huidige ontwikkelstatus

GitHub-repository: laravel/maestro
Officiële release: geen (versietags en releases nog niet gepubliceerd)
Laatste commit: april 2026 (actief in ontwikkeling)
Vereiste PHP-versie: ^8.2
Laravel-versie: ^13.0

Maestro is geen pakket voor eindgebruikers, maar functioneert als ontwikkelinfrastructuur voor het Laravel-team en contributors. De starter kits zelf (zoals laravel/starter-kit-react) worden door Maestro vanuit deze monorepo gegenereerd en beheerd.

laravel/maestro repository

Heb je interesse in bijdragen aan de starter kits, lees dan eerst de README van Maestro.

Officiële documentatie van de Laravel starter kits

Raadpleeg de officiële documentatie voor het gebruik van de starter kits zelf.

Changelog

Laravel 13

Producten

Package-introducties

Nieuwe repositories verkennen

Upgradegidsen

Authenticatie

Frontend

Omgeving opzetten

Laravel Maestro — de orchestrator voor starter kit-ontwikkeling

Wat is Maestro?

Welk probleem lost het op?

Varianten van de starter kits

Livewire-stack (6 varianten)

Inertia-stack (15 varianten)

Structuur van de repository

Het bestandslagen-systeem

De bijdrage-workflow

Overige ontwikkelcommando’s

Linten

Browsertests

Filteren met flags

WorkOS-omgevingsvariabelen instellen

Huidige ontwikkelstatus

laravel/maestro repository

Officiële documentatie van de Laravel starter kits

​Wat is Maestro?

​Welk probleem lost het op?

​Varianten van de starter kits

​Livewire-stack (6 varianten)

​Inertia-stack (15 varianten)

​Structuur van de repository

​Het bestandslagen-systeem

​De bijdrage-workflow

​Overige ontwikkelcommando’s

​Linten

​Browsertests

​Filteren met flags

​WorkOS-omgevingsvariabelen instellen

​Huidige ontwikkelstatus

laravel/maestro repository

Officiële documentatie van de Laravel starter kits

Wat is Maestro?

Welk probleem lost het op?

Varianten van de starter kits

Livewire-stack (6 varianten)

Inertia-stack (15 varianten)

Structuur van de repository

Het bestandslagen-systeem

De bijdrage-workflow

Overige ontwikkelcommando’s

Linten

Browsertests

Filteren met flags

WorkOS-omgevingsvariabelen instellen

Huidige ontwikkelstatus