Download the PHP package fabioserembe/blade-svg-pro without Composer
On this page you can find all versions of the php package fabioserembe/blade-svg-pro. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download fabioserembe/blade-svg-pro
More information about fabioserembe/blade-svg-pro
Files in fabioserembe/blade-svg-pro
Package blade-svg-pro
Short Description A Laravel package to convert (massively and recursively) SVG files in a folder into a single or multiple .blade.php file(s).
License MIT
Homepage https://github.com/fabioserembe/blade-svg-pro
Informations about the package blade-svg-pro
BladeSVGPro
Simplify the implementation of custom icons and use them in your Laravel project by using TailwindCSS classes for styling.
BladeSVGPro is a package that simplifies the conversion of SVG files into Blade components for Laravel projects. It allows you to convert SVG icons from an input folder into a single or multiple .blade.php
files. Additionally, it offers support for custom icons compatible with the Flux package.
Requirements
Ensure you have the following requirements to use BladeSVGPro:
- PHP: ^8.0
- PHP Extension:
ext-simplexml
- Laravel core: >= 10.x
- Additional Packages:
laravel/prompts
: ^0.1.25spatie/image-optimizer
: ^1.7
Make sure all required components are correctly installed in your environment to ensure the proper functioning of the package.
Installation
Run the following command to install the package:
Usage
BladeSVGPro offers a straightforward interface to convert your SVG files:
Basic Usage Example
Run the command and follow the prompts:
Usage with Parameters
You can specify the input and output directories using the --i
and --o
options:
Available Options
--i
: Specifies the path to the folder containing the SVGs to be converted.--o
:Specifies the path to the folder where the generated .blade.php files will be saved.--flux
: Enables support for custom icons compatible with the Flux package.
Flux support
To convert icons into a format compatible with Flux custom icons, use the --flux
parameter:
Note: When using --flux
, the output directory is automatically set to resources/views/flux/icon
as required by the Flux documentation. If the path does not exist, it will be created automatically.
Converting into Single or Multiple .blade files
When running the command without the --flux
option, you will be prompted to choose whether you want to convert the icons into a single file or multiple files:
- Single File: All icons are inserted into one
.blade.php
file. - Multiple Files: Each icon is saved in a separate
.blade.php
file.Example for Single file conversion
Follow the prompts and choose "Single file" when asked.
Example for Multiple file conversion
Follow the prompts and choose "Multiple file" when asked.
Output example
Single .blade file
If you choose to convert into a single file, the output will look similar to this:
Use the blade component in a view
Let us assume that we have exported the icons within a blade file named icons
located in the views/components
directory.
Within the view blade, we can use this file generated with:
You can customize the icon by adding your preferred Tailwind classes:
Multiple .blade files
If you choose to convert into multiple files, each icon will have its own .blade.php
file.
Example for the chevron-left.blade.php
icon
Using blade component in a view
Let us assume that we have exported the blade files in the views/components/icons
directory.
You can customize the icon by adding your preferred Tailwind classes:
Flux support
When you use the --flux
option, the icons are generated in a format compatible with the Flux package.
Example of a generated file
Using the blade component with Flux in a view
Currently supported icon types
- Linear
- Bold
- Duotone
- Bulk
Issues and bugs
Please report any issues or bugs in the issues section.
Suggestions
If you have any suggestions, write to me at [email protected].
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
Do you like this package?
If you like this package and find it useful, please Buy me a beer 🍺
Thanks for your support! 🤙🏻
All versions of blade-svg-pro with dependencies
ext-simplexml Version *
illuminate/collections Version ^8.0|^9.0|^10.0|^11.0|^12.0
illuminate/console Version ^8.0|^9.0|^10.0|^11.0|^12.0
illuminate/support Version ^8.0|^9.0|^10.0|^11.0|^12.0
laravel/prompts Version *
spatie/image-optimizer Version ^1.0