Laravel 12 + Inertia.js + Vue 3 + TailwindCSS 4 Starter Template

A modern starter template for Laravel 12 projects using Inertia.js 2, Vue 3, and TailwindCSS 4. This template provides a solid foundation for building modern web applications with the latest versions of these powerful technologies.

Features

• 🚀 Laravel 12
• ⚡️ Vite 6 with HMR
• 🎭 Inertia.js 2
• 💚 Vue 3
• 🎨 TailwindCSS 4
• 🐳 Docker with Laravel Sail
• 📝 Laravel Pint for PHP code styling
• 🔍 Laravel Pail for improved logging
• ✅ PHPUnit for testing

Requirements

• PHP 8.2 or higher
• Composer
• Node.js 20 or higher
• Docker (for Laravel Sail)

Installation

You can create a new project using Composer:

composer create-project xocdr/laravel-inertia-vue3-starter your-project-name
cd your-project-name

Development Setup

1. Copy the environment file:

cp .env.example .env

2. Start Laravel Sail:

./vendor/bin/sail up -d

3. Install PHP dependencies:

./vendor/bin/sail composer install

4. Install Node.js dependencies:

./vendor/bin/sail npm install

5. Generate application key:

./vendor/bin/sail artisan key:generate

6. Run database migrations:

./vendor/bin/sail artisan migrate

7. Start the development server:

./vendor/bin/sail npm run dev

Your application will be available at:

• Frontend (Vite): http://localhost:5173
• Backend (Laravel): http://localhost

Docker Services

The following services are available in your development environment:

Database Connection Details

• Host: mariadb
• Port: 3306
• Database: laravel
• Username: sail
• Password: password

Redis Connection Details

• Host: redis
• Port: 6379
• No password required

MinIO S3 Storage Details

• Console URL: http://localhost:8900
• API URL: http://localhost:9000
• Access Key: sail
• Secret Key: password
• Default Bucket: local
• Region: us-east-1

The MinIO setup is automatically configured to work with Laravel's S3 filesystem driver. A default bucket named 'local' is created during installation. You can access the MinIO Console to manage your buckets and files using the credentials above.

Example usage in Laravel:

// Store a file
Storage::disk('s3')->put('example.txt', 'Contents');

// Get a file
$contents = Storage::disk('s3')->get('example.txt');

// Generate a temporary URL
$url = Storage::disk('s3')->temporaryUrl('example.txt', now()->addMinutes(5));

Development Commands

• Start all development servers:

./vendor/bin/sail composer dev

• Run tests:

./vendor/bin/sail composer test

• Format PHP code:

./vendor/bin/sail composer pint

License

This project is open-sourced software licensed under the MIT license.