README

AI-powered coding guidelines for Laravel + Inertia React + Tailwind CSS v4 + shadcn/ui

Install best-practice guidelines for modern Laravel stack via a simple Artisan command. Works seamlessly with AI coding assistants like Claude, Cursor, and GitHub Copilot.

Features

• Inertia React v2 Forms - Modern <Form> component and useForm hook patterns
• Tailwind CSS v4 Migration - CSS-first config, new utilities, deprecated class replacements
• shadcn/ui Integration - Proper error states, accessible form fields, button icon styling
• Wayfinder Support - Type-safe form actions with .form() method
• Interactive CLI - Select specific guidelines or install all at once

Quick Start

composer require initred/laravel-boost-guidelines --dev

php artisan boost:guidelines --all

Installation

From Packagist (Recommended)

composer require initred/laravel-boost-guidelines --dev

The package will be auto-discovered by Laravel.

For Development

If you want to contribute or test local changes, add the package as a path repository:

{
    "repositories": [
        {
            "type": "path",
            "url": "../laravel-boost-guidelines"
        }
    ]
}

Then install:

composer require initred/laravel-boost-guidelines:@dev --dev

After making changes to the package, update it:

composer update initred/laravel-boost-guidelines

Usage

Install Guidelines

# Interactive mode - select which guidelines to install
php artisan boost:guidelines

# Install all guidelines
php artisan boost:guidelines --all

# Install specific category only
php artisan boost:guidelines --tailwindcss
php artisan boost:guidelines --inertia-react

# Install multiple categories
php artisan boost:guidelines --tailwindcss --inertia-react

# Force overwrite existing files
php artisan boost:guidelines --force

# Skip boost:update prompt after installation
php artisan boost:guidelines --all --no-update

# List available guidelines
php artisan boost:guidelines --list

After Installation

Run Laravel Boost's update command to apply the guidelines:

php artisan boost:update

Automatic Installation (Optional)

Add to your project's composer.json scripts to automatically install guidelines on composer update:

{
    "scripts": {
        "post-update-cmd": [
            "@php artisan boost:guidelines --all --force --no-update",
            "@php artisan boost:update --ansi"
        ]
    }
}

Available Guidelines

inertia-react/2/forms

Inertia v2 form handling guidelines (upgrade from v1's router.post pattern):

wayfinder/core

Laravel Wayfinder integration for type-safe routing:

tailwindcss/4/core

Tailwind CSS v4 migration guide:

Running Tests

git clone https://github.com/initred/laravel-boost-guidelines.git
cd laravel-boost-guidelines
composer install
composer test

Requirements

• PHP 8.2+
• Laravel 11.x or 12.x
• Laravel Boost

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

License

MIT License. See LICENSE for details.