PHPackages onelegstudios/laravel-tailor - 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 & Helpers](/categories/utility) 4. / 5. onelegstudios/laravel-tailor ActiveLibrary[Utility & Helpers](/categories/utility) onelegstudios/laravel-tailor ============================ The artisan tool to customize your Laravel starter kits. 00PHPCI passing Since Apr 22Pushed 2mo agoCompare [ Source](https://github.com/onelegstudios/laravel-tailor)[ Packagist](https://packagist.org/packages/onelegstudios/laravel-tailor)[ RSS](/packages/onelegstudios-laravel-tailor/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependenciesVersions (3)Used By (0) Laravel Tailor ============== [](#laravel-tailor) [![Release](https://camo.githubusercontent.com/b5f2e0375ef76948ac6d103b867e7a3f37f57e9499da177380c9345faba17e28/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f6e656c656773747564696f732f6c61726176656c2d7461696c6f722e7376673f6c6162656c3d72656c6561736526636f6c6f723d313831383142)](https://packagist.org/packages/onelegstudios/laravel-tailor)[![PHP 8.3+](https://camo.githubusercontent.com/f61e1be0bb99bfdcbda1980910401ed20f7c5a1c22936ff7c5dbcb4daeeeb22a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6f6e656c656773747564696f732f6c61726176656c2d7461696c6f723f6c6162656c3d50485026636f6c6f723d373737424234)](https://packagist.org/packages/onelegstudios/laravel-tailor)[![Tests](https://camo.githubusercontent.com/d0a7e707327cf9dbedc5d6563a5d9afc24d97cad8de8a8aeb48eac7869e25aca/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6f6e656c656773747564696f732f6c61726176656c2d7461696c6f722f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d746573747326636f6c6f723d313641333441)](https://github.com/onelegstudios/laravel-tailor/actions?query=workflow%3Arun-tests+branch%3Amain)[![Style](https://camo.githubusercontent.com/cb3814516c52fee949d71f406e221d462e12d3a727425c1a1eab1e4a744db302/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6f6e656c656773747564696f732f6c61726176656c2d7461696c6f722f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d7374796c6526636f6c6f723d463539453042)](https://github.com/onelegstudios/laravel-tailor/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Downloads](https://camo.githubusercontent.com/36601c570e9433c4969aa2fcf4c805613d855bb4c2a01705f8436c9e286e71f5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f6e656c656773747564696f732f6c61726176656c2d7461696c6f722e7376673f6c6162656c3d646f776e6c6f61647326636f6c6f723d364237323830)](https://packagist.org/packages/onelegstudios/laravel-tailor) [![Laravel 13](https://camo.githubusercontent.com/3bf42ecc03c4897873ecea0886669f91c4cc12c635f2b9b86d1f1e764fce4c70/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31332e782d464632443230)](https://laravel.com)[![Livewire 4](https://camo.githubusercontent.com/be77d55a936ddb78e66882cb1373d4aabdf8ee105603c1579fa14794ae0e0e5f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c697665776972652d342e782d464237304139)](https://livewire.laravel.com)[![Support](https://camo.githubusercontent.com/9595be01befd27d9770b1233dc7c55067a780f84bf929a808c2bf0e7d146bbdb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f537570706f72742d4c69766577697265253230537461727465722532304b69742d304637363645)](https://github.com/onelegstudios/laravel-tailor) Standard starter kits are great, but they often require 30 minutes of "massaging" before you can actually start coding. Tailor automates that process, ensuring every project starts with your specific best practices. - ⚡️ Fast: Transform your kit in seconds. - 🛠 Modular: Choose only what you need. - 🏗 Scalable: Built with Laravel 13 and Livewire in mind. Installation ------------ [](#installation) You can install the package via composer: ``` composer require onelegstudios/laravel-tailor --dev ``` Usage ----- [](#usage) After requiring this package in your Laravel application and installing a Laravel starter kit, run the tailor command to apply your preferred modifications: ``` php artisan tailor:install ``` You will be prompted to select which modifications to apply. Laravel Tailor currently ships with: - Use Lucide icons ### Use Lucide Icons [](#use-lucide-icons) `tailor:use-lucide-icons` migrates supported Flux icon usage to published Lucide icon components. When you run it, Tailor: - scans `resources/views` for supported Flux icon references - publishes the mapped Lucide icon Blade files into `resources/views/flux/icon` - rewrites supported literal icon usages. - leaves unresolved dynamic icon expressions unchanged and reports each one as a warning instead of guessing - adds Tailor's package `@source` directive to `resources/css/app.css` when that file exists, so Tailwind can see the package views used by the published icons Icon names are resolved from Tailor's icon mapping configuration. The default mappings cover common Flux-to-Lucide translations such as `loading` to `loader-circle` and `exclamation-triangle` to `triangle-alert`. If you only want to run the icon migration you can call the command directly: ``` php artisan tailor:use-lucide-icons ``` #### Custom icon mappings [](#custom-icon-mappings) If you want to use different Lucide icons than Tailor's defaults, publish the package config first: ``` php artisan vendor:publish --tag=tailor-config ``` This creates `config/tailor.php`. From there, update `icons.mappings` to point Flux icon names at the Lucide icons you want to publish. ``` 'icons' => [ 'mappings' => [ 'plus' => 'circle-plus', 'users' => 'users-round', 'layout-grid' => 'layout-grid', ], ], ``` Map a Flux icon name to any Lucide icon name you want Tailor to publish. If you want to keep an icon name unchanged but still make sure its Lucide Blade view is published, map it to itself. Package Development ------------------- [](#package-development) Do not run this when installing Laravel Tailor in your own application. Package consumers only need to install the package and run `php artisan tailor:install` inside their Laravel project. ### Refreshing the Testbench workbench with the latest starter-kit version [](#refreshing-the-testbench-workbench-with-the-latest-starter-kit-version) If you are developing or contributing to this package, you can refresh the local Testbench workbench with: ``` php bin/refresh-workbench.php ``` This command is for package development only. It regenerates the local `workbench/` application from the latest Livewire starter kit, rebuilds the Testbench workbench, reinstalls the workbench frontend dependencies, and builds the Vite manifest used by `testbench serve`. ### Syncing Flux icons to config file [](#syncing-flux-icons-to-config-file) When `bin/refresh-workbench.php` changes Flux icon usage in the workbench views, refresh the package icon map with: ``` php bin/sync-flux-icon-map.php ``` This script scans `workbench/resources/views` for Flux icon references and updates the package `config/tailor.php` file under `icons.mappings`. It preserves unrelated Tailor config, keeps any explicit icon mappings you have already defined, adds newly detected icons with `null` targets, always includes Flux internal icons such as `loading` and `exclamation-triangle`, and writes `icons.removed` when older mappings are no longer detected. Run it after changing package Blade views or Flux icon migration behavior so the default package icon configuration stays aligned with the current workbench templates. ### Testing [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](https://github.com/onelegstudios/laravel-tailor/security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Oneleggedswede](https://github.com/oneleggedswede) - [All Contributors](https://github.com/onelegstudios/laravel-tailor/graphs/contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 20 — LowBetter than 13% of packages Maintenance58 Moderate activity, may be stable Popularity0 Limited adoption so far Community9 Small or concentrated contributor base Maturity15 Early-stage or recently created project Bus Factor1 Top contributor holds 61.5% 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/fa2be4742dd58ae6c0ac92b274753dd7a02c2720a3b892bf4d8879fc773e056a?d=identicon)[onelegstudios](/maintainers/onelegstudios) --- Top Contributors [![oneleggedswede](https://avatars.githubusercontent.com/u/164418089?v=4)](https://github.com/oneleggedswede "oneleggedswede (8 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)") ### Embed Badge ![Health badge](/badges/onelegstudios-laravel-tailor/health.svg) ``` [![Health](https://phpackages.com/badges/onelegstudios-laravel-tailor/health.svg)](https://phpackages.com/packages/onelegstudios-laravel-tailor) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)