Cómo instalar Laravel Sail en proyectos con Starter Kits de Laravel 12

Laravel 12, lanzado oficialmente el 24 de febrero de 2025, trae consigo una renovada colección de starter kits que facilitan la implementación de sistemas de autenticación con Vue, React y Livewire. Como explico en mi artículo sobre Novedades en Laravel 12, esta versión incluye importantes mejoras en el ecosistema. Sin embargo, existe un pequeño desafío: estos kits actualmente solo funcionan con el instalador tradicional de Laravel (laravel new) y no con Laravel Sail, el entorno de desarrollo Docker oficial.

En este tutorial te mostraré, de forma directa y concisa, cómo combinar los nuevos starter kits de Laravel 12 con Laravel Sail.

¿Qué aprenderás en este tutorial?

• Instalar Laravel 12 con los nuevos starter kits

• Añadir Laravel Sail a un proyecto existente con starter kit

Requisitos previos

• PHP 8.2 o superior instalado

• Composer

• Docker Desktop (para Laravel Sail)

• Si usas Windows, te recomiendo configurar WSL 2 en Windows con Laravel Sail

• Conocimientos básicos de Laravel

Paso 1: Crear un proyecto con Laravel 12 y un starter kit

Primero, necesitamos crear un nuevo proyecto de Laravel 12 utilizando el comando tradicional que incluirá la selección del starter kit:

# Crear un nuevo proyecto Laravel 12 con starter kit
laravel new laravel12-starter-kits-sail

Durante este proceso, Laravel 12 te presentará prompts interactivos donde podrás seleccionar qué starter kit deseas utilizar (Vue, React o Livewire). Simplemente sigue las instrucciones en pantalla para completar la configuración inicial.

Paso 2: Instalar Laravel Sail en el proyecto existente

Ahora viene la parte interesante. Vamos a instalar Laravel Sail en nuestro proyecto que ya cuenta con un starter kit, pero antes, aquí tienes la entrada completa que cubre este proceso:

# Instalar Laravel Sail 
composer require laravel/sail --dev 

# Seleccionar Servicios y publicar los archivos de configuración de Sail 
php artisan sail:install

Durante la instalación, se te pedirá que selecciones los servicios que deseas incluir (MySQL, Redis, etc.). Selecciona los que necesites para tu proyecto.

Paso 3: Iniciar Laravel Sail

Ahora que tenemos Sail instalado, podemos iniciar nuestro entorno de desarrollo:

# Iniciar Sail en segundo plano 
./vendor/bin/sail up -d

# O, si tienes el alias
sail up -d

Paso 4: Ejecutar migraciones

Para finalizar la configuración:

# Ejecutar migraciones 
sail artisan migrate:fresh --seed

Solución de problemas comunes

Conflictos de puertos Docker

Si encuentras conflictos de puertos, simplemente modifica los puertos en tu archivo docker-compose.yml.

Beneficios de esta integración

• Entorno de desarrollo consistente gracias a Docker

• Nuevos sistemas de autenticación con tu stack preferido

• Desarrollo más rápido combinando las mejores herramientas de Laravel

• Compatibilidad total con las nuevas características de Laravel 12

Conclusión

Con estos pasos, ahora tienes un entorno de desarrollo Laravel 12 perfectamente configurado con un starter kit moderno y la potencia de Laravel Sail. Esta combinación te permitirá desarrollar aplicaciones web robustas con un flujo de trabajo optimizado.

Los nuevos starter kits de Laravel 12 son una gran adición al ecosistema, y aunque inicialmente presentan esta pequeña limitación con Sail, siguiendo este tutorial puedes superar esta barrera fácilmente.

Recursos adicionales

• Novedades en Laravel 12

• WSL 2 en Windows con Laravel Sail

• Documentación oficial de Laravel 12

A continuación, te dejo un vídeo que he preparado donde te explico un poco todo lo comentado en este artículo, espero que te guste, y si es así, compártelo con tus colegas.