Skip to content

AGENTS.md

Latest commit

 

History

History
33 lines (26 loc) · 1.88 KB

AGENTS.md

File metadata and controls

33 lines (26 loc) · 1.88 KB
Raw

Maestro

Maestro is the monorepo orchestrator for the official Laravel starter kits. Use the maestro skill before making changes.

Quick Reference

  • Build: cd orchestrator && php artisan build (interactive) or use --kit, --blank, --workos, --teams flags
  • Dev: composer kit:run (from orchestrator/)
  • Test: composer setup && composer ci:check (from build/)
  • Test all kits: composer kits:check (from orchestrator/) — builds and runs CI checks for all 21 variants
  • Pint only: composer kits:pint (from orchestrator/) — runs Pint on kits/ and browser_tests/
  • Lint: composer kits:lint (from orchestrator/) — runs kits:pint, then frontend lint/format for Inertia variants
  • Browser tests (all 8 kits): composer kits:browser-tests (from orchestrator/)
  • Edit in build/ only if it exists and composer kit:run is running; otherwise edit kits/ directly. Always commit in kits/.
  • Stop kit:run before running kits:lint or kits:check — running them while the watcher is active corrupts kits/. kits:pint is safe at any time.

Selective Execution

Pass --livewire, --react, --svelte, and/or --vue to target specific frameworks. Pass --blank, --fortify, --workos, --components, and/or --teams to target specific variants. Combine both to narrow down exactly which kit variants to run:

composer kits:check -- --react --svelte
composer kits:check -- --vue --svelte --fortify     # Vue and Svelte, Fortify variants only
composer kits:check -- --livewire --fortify --workos # Livewire Fortify and WorkOS only
composer kits:check -- --workos                      # all frameworks, WorkOS variant only
composer kits:lint -- --vue
composer kits:lint -- --livewire                     # runs only the shared Pint step (no frontend lint phase)
composer kits:browser-tests -- --vue

No flags runs the full default matrix for each command.