rmirandasv/laravel-i18n-starter-kit

A professional starter kit based on the official Laravel React Starter Kit, featuring a fully synchronized i18n system.

1.0.0 2026-05-19 00:07 UTC

Requires

• php: ^8.3
• inertiajs/inertia-laravel: ^3.0
• laravel/fortify: ^1.34
• laravel/framework: ^13.7
• laravel/tinker: ^3.0
• laravel/wayfinder: ^0.1.14

Requires (Dev)

• fakerphp/faker: ^1.24
• laravel/boost: ^2.2
• laravel/pail: ^1.2.5
• laravel/pao: ^1.0.6
• laravel/pint: ^1.27
• laravel/sail: ^1.53
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.9.3
• pestphp/pest: ^4.7
• pestphp/pest-plugin-laravel: ^4.1

MIT

• framework
• laravel

README

A professional starter kit based on the official Laravel React Starter Kit (Laravel 13, Inertia.js v3, and React 19), featuring an extra layer for a fully synchronized internationalization (i18n) system for both frontend and backend.

Leer en Español

Features

• Official Base: Built directly on top of the official Laravel + Inertia + React starter kit.
• Full Stack i18n: Synchronized language switching between React (frontend) and Laravel (backend).
• Dual Language Support: Ready to use in English and Spanish.
• Frontend Localization: Powered by i18next and react-i18next.
• Backend Localization: Custom middleware that reads the frontend language preference (via cookie) and updates the Laravel locale.
• Language Selector: Integrated UI component in the main sidebar header.
• Translated UI: Profile settings, Security (including 2FA), Team management, Dashboard, and all Auth pages (Login, Register, etc.) are already translated.
• Translated Validations: Full set of Spanish translations for Laravel's default validation messages, authentication, and password reset lines.
• Inertia v3 & React 19: Leveraging the latest features of the ecosystem.
• Tailwind CSS v4: Modern styling for all components.

Requirements

• PHP 8.3+
• Node.js & NPM
• SQLite (default) or other supported database.

Installation

Using Laravel Installer

You can create a new project using the --using flag:

laravel new my-app --using rmirandasv/laravel-i18n-starter-kit

Using Composer

Alternatively, you can use composer create-project:

composer create-project rmirandasv/laravel-i18n-starter-kit my-app

Setup

1. Enter the project directory:

   cd my-app

2. Run the setup script:

   composer run setup

   This will install dependencies, copy .env, generate keys, and run migrations.

3. Start development:

   composer run dev

Key Files

• resources/js/i18n/: i18next configuration and JSON translation files.
• app/Http/Middleware/HandleLocalization.php: Synchronizes language between frontend and backend.
• lang/: Backend PHP translation files (including the es directory).

License

The MIT License (MIT). Please see License File for more information.