🌟 Laravel Español 🇪🇸

El paquete laravel-lat-es ofrece traducciones al español latinoamericano para Laravel. Incluye los archivos de idioma por defecto de Laravel traducidos, listos para publicar en tu proyecto con un solo comando.

Archivos incluidos

lang/es/auth.php
lang/es/pagination.php
lang/es/passwords.php
lang/es/validation.php

• Requisitos
• Instalación
• Configuración
• Laravel Boost
• Colaborar

📋 Requisitos

• PHP ^8.2
• Laravel ^10.0 | ^11.0 | ^12.0

🚀 Instalación

Instala el paquete via Composer:

composer require amendozaaguiar/laravel-lat-es

El ServiceProvider se registra automáticamente gracias al autodiscovery de Laravel, no es necesario registrarlo manualmente.

Publica los archivos de traducción con el comando del paquete:

php artisan laravellates:install

O usando directamente vendor:publish:

php artisan vendor:publish --tag=laravel-lat-es-lang

Verificar sincronización

Usa el comando laravellates:check para comparar lang/en/ con lang/es/ y detectar claves faltantes o desactualizadas:

php artisan laravellates:check

Si tu proyecto tiene otro locale, usa la opción --locale:

php artisan laravellates:check --locale=es_MX

⚙️ Configuración

Establece el idioma en config/app.php:

'locale' => 'es', // español
'locale' => 'en', // inglés

También puedes cambiarlo en tiempo de ejecución (solo para esa petición):

App::setLocale('es');

🤖 Laravel Boost

Este paquete incluye soporte nativo para Laravel Boost, lo que permite que los agentes de IA (GitHub Copilot, Claude Code, Cursor, etc.) tengan contexto automático sobre las traducciones disponibles.

Guideline automática

Cuando el paquete está instalado y se ejecuta boost:update, los agentes reciben automáticamente una guideline informándoles que el proyecto tiene traducciones al español disponibles en lang/es/.

Skill activable

El paquete incluye la skill laravel-lat-es con documentación completa de todas las claves de traducción disponibles. Para activarla, añade el paquete a tu boost.json:

{
    "packages": ["amendozaaguiar/laravel-lat-es"],
    "skills": ["laravel-lat-es"]
}

Luego actualiza las guidelines:

php artisan boost:update

A partir de ese momento, el agente de IA sabrá exactamente qué claves existen, cómo usar el helper __() con ellas, y cuándo activar la skill completa.

🤝 Colaborar

Estamos abiertos a mejoras y variaciones para países de habla hispana. ¡Aceptamos cualquier contribución a través de un Pull Request con entusiasmo! 😊

Inspirado

Agradecemos la inspiración de Laravel-Spanish y a ChatGPT por su contribución en la mejora de los textos.