README

Archivos de traducción al español latinoamericano para proyectos Laravel + Jetstream.

Incluye:

• lang/es/auth.php, pagination.php, passwords.php, validation.php — traducciones estándar de Laravel
• lang/es.json — 216+ cadenas JSON de Jetstream (2FA, Teams, API Tokens, Browser Sessions, Perfil, etc.)

Requisitos

• PHP ^8.2
• Laravel ^10.0 | ^11.0 | ^12.0
• Laravel Jetstream ^4.0 | ^5.0

Instalación

composer require amendozaaguiar/laraveles-spanish-for-jetstream

Publicar las traducciones

php artisan laravellates-jetstream:install

Esto publica los archivos de traducción en el directorio lang/ de tu proyecto Laravel:

lang/
├── es/
│   ├── auth.php
│   ├── pagination.php
│   ├── passwords.php
│   └── validation.php
└── es.json          ← Todas las cadenas de texto de Jetstream

Activar el locale en español

En config/app.php:

'locale' => 'es',
'fallback_locale' => 'en',

Comandos Artisan

laravellates-jetstream:install

Publica todos los archivos de traducción en el directorio lang/ del proyecto.

php artisan laravellates-jetstream:install

laravellates-jetstream:check

Verifica que las traducciones estén completas y el es.json sea válido. Útil para pipelines CI/CD.

# Verificar locale es (por defecto)
php artisan laravellates-jetstream:check

# Verificar otro locale
php artisan laravellates-jetstream:check --locale=pt

El comando reporta:

• ✗ Archivos PHP faltantes en lang/{locale}/
• ✗ Claves sin traducir por archivo
• ⚠ Claves obsoletas (no existen en lang/en/)
• ✓ Validez y conteo del archivo {locale}.json

Retorna código de salida 0 si todo está bien, 1 si hay problemas.

Traducciones incluidas

Archivos PHP (lang/es/)

JSON — Cadenas de Jetstream (lang/es.json)

Más de 216 traducciones que cubren:

Integración con Laravel Boost (Agentes IA)

Este paquete incluye soporte nativo para Laravel Boost, permitiendo que agentes IA (Claude, Copilot, etc.) conozcan las traducciones disponibles y cómo usarlas.

Agregar al proyecto con Boost

En tu boost.json:

{
    "packages": [
        "amendozaaguiar/laraveles-spanish-for-jetstream"
    ]
}

Luego actualiza:

php artisan boost:update

El agente IA tendrá contexto sobre:

• Archivos de traducción disponibles
• Cómo usar __() para cada área
• Comandos de instalación y verificación

Tests

composer test

Tests incluidos:

• tests/Unit/LangFilesTest.php — verifica que todos los archivos existen, son arrays válidos y tienen las claves requeridas; valida es.json
• tests/Feature/ServiceProviderTest.php — verifica el ServiceProvider, tag de publicación y estructura de Boost
• tests/Feature/CheckCommandTest.php — prueba el comando laravellates-jetstream:check

Licencia

MIT © 2026 Anderson Mendoza