PHPackages                             initred/laravel-boost-guidelines - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. initred/laravel-boost-guidelines

AbandonedArchivedLibrary[Utility &amp; Helpers](/categories/utility)

initred/laravel-boost-guidelines
================================

Generate AI-friendly project guidelines for Laravel applications - Part of Laravel Boost ecosystem

v1.3.0(3mo ago)0224↓33.3%MITPHPPHP ^8.2CI passing

Since Jan 12Pushed 3mo agoCompare

[ Source](https://github.com/initred/laravel-boost-guidelines)[ Packagist](https://packagist.org/packages/initred/laravel-boost-guidelines)[ Docs](https://github.com/initred/laravel-boost-guidelines)[ RSS](/packages/initred-laravel-boost-guidelines/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (10)Versions (6)Used By (0)

Laravel Boost Guidelines
========================

[](#laravel-boost-guidelines)

[![Tests](https://camo.githubusercontent.com/9e1eec58f1c6a3c552b0ff38f0095e5426c9f76015228a07e9c7c53deba3f653/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f696e69747265642f6c61726176656c2d626f6f73742d67756964656c696e65732f74657374732e796d6c3f6c6162656c3d7465737473)](https://github.com/initred/laravel-boost-guidelines/actions/workflows/tests.yml)[![Latest Stable Version](https://camo.githubusercontent.com/7ac94efd4ce12b1689a8ac6a84a79a27d73fbf88260d68c3d5955aa9e51a99db/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696e69747265642f6c61726176656c2d626f6f73742d67756964656c696e6573)](https://packagist.org/packages/initred/laravel-boost-guidelines)[![Total Downloads](https://camo.githubusercontent.com/e2ca0407de9bd553c8c5da0670264694b2be532c6db5f24366c5592516360c5d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f696e69747265642f6c61726176656c2d626f6f73742d67756964656c696e6573)](https://packagist.org/packages/initred/laravel-boost-guidelines)[![License](https://camo.githubusercontent.com/0b0627dd8cfc60045f77714512708d50467ac0aab08869ed333bacedb94e2b60/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f696e69747265642f6c61726176656c2d626f6f73742d67756964656c696e6573)](https://github.com/initred/laravel-boost-guidelines/blob/main/LICENSE)

> 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
--------

[](#features)

- **Inertia React v2 Forms** - Modern `` 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
-----------

[](#quick-start)

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

php artisan boost:guidelines --all
```

Installation
------------

[](#installation)

### From Packagist (Recommended)

[](#from-packagist-recommended)

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

The package will be auto-discovered by Laravel.

### For Development

[](#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
-----

[](#usage)

### Install Guidelines

[](#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

[](#after-installation)

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

```
php artisan boost:update
```

### Automatic Installation (Optional)

[](#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
--------------------

[](#available-guidelines)

### inertia-react/2/forms

[](#inertia-react2forms)

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

FeatureDescription`` ComponentDeclarative form handling with built-in state management (v2.1+)`useForm` HookFor projects not yet on v2.1shadcn/ui IntegrationField components with proper error states (`data-invalid`, `aria-invalid`)shadcn/ui ButtonIcon styling best practices (no unnecessary `mr-*` or `size-*` classes)Wayfinder SupportType-safe form actions with `.form()` methodReact 19 &amp; Compiler`useRef` argument requirements, ref callback syntax, auto-memoization### wayfinder/core

[](#wayfindercore)

Laravel Wayfinder integration for type-safe routing:

FeatureDescriptionNamed ImportsTree-shakable controller method importsRoute ObjectsFunctions return `{ url, method }` shaped objectsForm Support`.form()` method for HTML form attributesQuery Parameters`query` and `mergeQuery` options for URL paramsInertia IntegrationWorks with `` component and `useForm` hook### tailwindcss/4/core

[](#tailwindcss4core)

Tailwind CSS v4 migration guide:

Before (v3)After (v4)`tailwind.config.js``@theme` directive in CSS`@tailwind base/components/utilities``@import "tailwindcss"``bg-opacity-50``bg-black/50``flex-shrink-0``shrink-0``w-4 h-4``size-4`Running Tests
-------------

[](#running-tests)

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

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 11.x or 12.x
- [Laravel Boost](https://github.com/nicepkg/laravel-boost)

Contributing
------------

[](#contributing)

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

###  Health Score

40

—

FairBetter than 87% of packages

Maintenance83

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

116d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7007211b2cdb5ebbf36fb45cd7473a6ae364f69b1be7c9f93a7dedc3683fedab?d=identicon)[InitRed](/maintainers/InitRed)

---

Top Contributors

[![initred](https://avatars.githubusercontent.com/u/34208843?v=4)](https://github.com/initred "initred (6 commits)")

---

Tags

ai-guidelinesartisan-commandinertiainertiajslaravellaravel-packagephpreactshadcn-uitailwindcsstailwindcss-v4laravelaiinertiareactcursorcopilotclaudeguidelinesboost

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/initred-laravel-boost-guidelines/health.svg)

```
[![Health](https://phpackages.com/badges/initred-laravel-boost-guidelines/health.svg)](https://phpackages.com/packages/initred-laravel-boost-guidelines)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M683](/packages/barryvdh-laravel-ide-helper)[laravel/boost

Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code.

3.4k10.6M272](/packages/laravel-boost)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[livewire/flux

The official UI component library for Livewire.

9385.0M85](/packages/livewire-flux)[laravel/ai

The official AI SDK for Laravel.

732506.3k60](/packages/laravel-ai)[laravel/folio

Page based routing for Laravel.

608453.9k27](/packages/laravel-folio)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
