{"id":37229398,"url":"https://github.com/initred/laravel-boost-guidelines","last_synced_at":"2026-01-15T03:32:34.678Z","repository":{"id":332017671,"uuid":"1132437475","full_name":"initred/laravel-boost-guidelines","owner":"initred","description":"🚀 Laravel Boost AI Guidelines - Install Inertia React v2 forms, shadcn/ui components \u0026 Tailwind CSS v4 migration guides via Artisan command","archived":false,"fork":false,"pushed_at":"2026-01-12T05:05:05.000Z","size":21,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-12T07:46:32.768Z","etag":null,"topics":["ai-guidelines","artisan-command","inertia","inertiajs","laravel","laravel-package","php","react","shadcn-ui","tailwindcss","tailwindcss-v4"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/initred.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-12T00:24:28.000Z","updated_at":"2026-01-12T05:04:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/initred/laravel-boost-guidelines","commit_stats":null,"previous_names":["initred/laravel-boost-guidelines"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/initred/laravel-boost-guidelines","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/initred%2Flaravel-boost-guidelines","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/initred%2Flaravel-boost-guidelines/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/initred%2Flaravel-boost-guidelines/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/initred%2Flaravel-boost-guidelines/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/initred","download_url":"https://codeload.github.com/initred/laravel-boost-guidelines/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/initred%2Flaravel-boost-guidelines/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28442286,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-15T00:55:22.719Z","status":"online","status_checked_at":"2026-01-15T02:00:08.019Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-guidelines","artisan-command","inertia","inertiajs","laravel","laravel-package","php","react","shadcn-ui","tailwindcss","tailwindcss-v4"],"created_at":"2026-01-15T03:32:34.088Z","updated_at":"2026-01-15T03:32:34.673Z","avatar_url":"https://github.com/initred.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Laravel Boost Guidelines\n\n[![Tests](https://img.shields.io/github/actions/workflow/status/initred/laravel-boost-guidelines/tests.yml?label=tests)](https://github.com/initred/laravel-boost-guidelines/actions/workflows/tests.yml)\n[![Latest Stable Version](https://img.shields.io/packagist/v/initred/laravel-boost-guidelines)](https://packagist.org/packages/initred/laravel-boost-guidelines)\n[![Total Downloads](https://img.shields.io/packagist/dt/initred/laravel-boost-guidelines)](https://packagist.org/packages/initred/laravel-boost-guidelines)\n[![License](https://img.shields.io/github/license/initred/laravel-boost-guidelines)](https://github.com/initred/laravel-boost-guidelines/blob/main/LICENSE)\n\n\u003e AI-powered coding guidelines for Laravel + Inertia React + Tailwind CSS v4 + shadcn/ui\n\nInstall best-practice guidelines for modern Laravel stack via a simple Artisan command. Works seamlessly with AI coding assistants like Claude, Cursor, and GitHub Copilot.\n\n## Features\n\n- **Inertia React v2 Forms** - Modern `\u003cForm\u003e` component and `useForm` hook patterns\n- **Tailwind CSS v4 Migration** - CSS-first config, new utilities, deprecated class replacements\n- **shadcn/ui Integration** - Proper error states, accessible form fields, button icon styling\n- **Wayfinder Support** - Type-safe form actions with `.form()` method\n- **Interactive CLI** - Select specific guidelines or install all at once\n\n## Quick Start\n\n```bash\ncomposer require initred/laravel-boost-guidelines --dev\n\nphp artisan boost:guidelines --all\n```\n\n## Installation\n\n### From Packagist (Recommended)\n\n```bash\ncomposer require initred/laravel-boost-guidelines --dev\n```\n\nThe package will be auto-discovered by Laravel.\n\n### For Development\n\nIf you want to contribute or test local changes, add the package as a path repository:\n\n```json\n{\n    \"repositories\": [\n        {\n            \"type\": \"path\",\n            \"url\": \"../laravel-boost-guidelines\"\n        }\n    ]\n}\n```\n\nThen install:\n\n```bash\ncomposer require initred/laravel-boost-guidelines:@dev --dev\n```\n\nAfter making changes to the package, update it:\n\n```bash\ncomposer update initred/laravel-boost-guidelines\n```\n\n## Usage\n\n### Install Guidelines\n\n```bash\n# Interactive mode - select which guidelines to install\nphp artisan boost:guidelines\n\n# Install all guidelines\nphp artisan boost:guidelines --all\n\n# Install specific category only\nphp artisan boost:guidelines --tailwindcss\nphp artisan boost:guidelines --inertia-react\n\n# Install multiple categories\nphp artisan boost:guidelines --tailwindcss --inertia-react\n\n# Force overwrite existing files\nphp artisan boost:guidelines --force\n\n# Skip boost:update prompt after installation\nphp artisan boost:guidelines --all --no-update\n\n# List available guidelines\nphp artisan boost:guidelines --list\n```\n\n### After Installation\n\nRun Laravel Boost's update command to apply the guidelines:\n\n```bash\nphp artisan boost:update\n```\n\n### Automatic Installation (Optional)\n\nAdd to your project's `composer.json` scripts to automatically install guidelines on `composer update`:\n\n```json\n{\n    \"scripts\": {\n        \"post-update-cmd\": [\n            \"@php artisan boost:guidelines --all --force --no-update\",\n            \"@php artisan boost:update --ansi\"\n        ]\n    }\n}\n```\n\n## Available Guidelines\n\n### inertia-react/2/forms\n\nInertia v2 form handling guidelines (upgrade from v1's `router.post` pattern):\n\n| Feature | Description |\n|---------|-------------|\n| `\u003cForm\u003e` Component | Declarative form handling with built-in state management (v2.1+) |\n| `useForm` Hook | For projects not yet on v2.1 |\n| shadcn/ui Integration | Field components with proper error states (`data-invalid`, `aria-invalid`) |\n| shadcn/ui Button | Icon styling best practices (no unnecessary `mr-*` or `size-*` classes) |\n| Wayfinder Support | Type-safe form actions with `.form()` method |\n| React 19 \u0026 Compiler | `useRef` argument requirements, ref callback syntax, auto-memoization |\n\n### wayfinder/core\n\nLaravel Wayfinder integration for type-safe routing:\n\n| Feature | Description |\n|---------|-------------|\n| Named Imports | Tree-shakable controller method imports |\n| Route Objects | Functions return `{ url, method }` shaped objects |\n| Form Support | `.form()` method for HTML form attributes |\n| Query Parameters | `query` and `mergeQuery` options for URL params |\n| Inertia Integration | Works with `\u003cForm\u003e` component and `useForm` hook |\n\n### tailwindcss/4/core\n\nTailwind CSS v4 migration guide:\n\n| Before (v3) | After (v4) |\n|-------------|------------|\n| `tailwind.config.js` | `@theme` directive in CSS |\n| `@tailwind base/components/utilities` | `@import \"tailwindcss\"` |\n| `bg-opacity-50` | `bg-black/50` |\n| `flex-shrink-0` | `shrink-0` |\n| `w-4 h-4` | `size-4` |\n\n## Running Tests\n\n```bash\ngit clone https://github.com/initred/laravel-boost-guidelines.git\ncd laravel-boost-guidelines\ncomposer install\ncomposer test\n```\n\n## Requirements\n\n- PHP 8.2+\n- Laravel 11.x or 12.x\n- [Laravel Boost](https://github.com/nicepkg/laravel-boost)\n\n## Contributing\n\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finitred%2Flaravel-boost-guidelines","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finitred%2Flaravel-boost-guidelines","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finitred%2Flaravel-boost-guidelines/lists"}