Todo lo que necesitas para instrumentar Laravel.
El paquete incluye un único archivo de configuración y un comando artisan. La mayoría de los equipos ejecutan su primera auditoría en menos de 5 minutos después de composer require.
Lighthouse, más el contexto de servidor que produjo el score.
Laravel Vitals ejecuta Google Lighthouse contra tus propias páginas, captura lo que tu servidor estaba haciendo en ese instante — queries, memoria, problemas N+1 — y apunta directamente a las líneas de código responsables. Todo aterriza en un dashboard en /vitals que cualquier miembro del equipo puede leer y actuar. Tus datos permanecen en tu propia base de datos — sin SaaS, sin facturación por usuario.
Instala, declara una URL, lanza una auditoría.
composer require corentinbtmps/laravel-vitals
php artisan vendor:publish --tag=vitals-config
php artisan migrate
php artisan vitals:install<head>
<meta charset="utf-8">
@vitalsRum
</head>'urls' => ['home' => '/'],php artisan vitals:audit home --syncAbre /vitals — score Lighthouse, telemetría backend y recomendaciones con sus referencias archivo:línea.
Cómo se ejecuta una auditoría en realidad.
-
1
Declara tus URLs
config/vitals.php contiene tus URLs como pares label => /ruta. Lanza vitals:audit a mano, en un schedule o desde tu CI.
-
2
La auditoría arranca
El paquete firma un header X-Vitals-Audit-Id con tu APP_KEY y dispara Lighthouse (Node local, Playwright o la API Google PageSpeed según tu driver).
-
3
Telemetría backend
Mientras Lighthouse carga la página, tu middleware detecta el header firmado y registra número de queries, tiempo de query, sospecha N+1, pico de memoria, vistas, jobs y aciertos/fallos de caché.
-
4
Resultado Lighthouse
Los scores llegan (0–100) junto con los valores brutos: LCP, INP, CLS, TTFB, FCP, TBT, Speed Index.
-
5
Análisis de código
Analizadores estáticos escanean tus vistas Blade, tu config Vite y tu composer.json para adjuntar un archivo:línea preciso a cada finding de Lighthouse. Todo se almacena y se expone en /vitals.
Primeros pasos
Drivers de auditoría
Telemetría + monitorización
Comprobaciones SEO
CI + notificaciones
Referencia
Explicaciones en lenguaje sencillo de cada métrica.
Cada métrica de Lighthouse — LCP, INP, CLS, TTFB — tiene una página "Learn" que la explica en tres frases, muestra el umbral y enlaza la referencia de Web Vitals. Útil para incorporar nuevos desarrolladores.
Referencia completa en GitHub.
El README cubre todos los comandos Artisan, los endpoints de la API JSON, la superficie de configuración (~30 ajustes que se sobrescriben vía .env), las garantías de privacidad, troubleshooting y la guía de contribución.