foundationapp / power-ups
This is the power-ups package.
Requires
- php: ^7.4|^8.0
- illuminate/support: ^10.0
Requires (Dev)
- orchestra/testbench: ^6.0
- phpunit/phpunit: ^9.0
This package is auto-updated.
Last update: 2024-10-23 16:18:03 UTC
README
Power-Ups allow developers to create re-usable TALL Stack components for Laravel applications.
Similar to how 🍄 Power-Ups help Mario complete a level, this package helps developers save time by providing a clear list of available Tall Stack Components to choose from. Now, developers can build 🍄 Power-ups and easily re-use them in any another application.
Installation
You can install the package via composer:
composer require foundationapp/power-ups
After including the package, you can install any Power-Up by running:
php artisan powerup:install vendor/repo
If we wanted to install the https://github.com/foundationapp/hello-world example, we would run:
php artisan powerup:install foundationapp/hello-world
You can install any power-up by passing the
vendor/repo
to the install command.
Usage
After installing a power-up, you can enable it with:
php artisan powerup:enable name-of-component
and use it on any page:
<livewire:powerup.name-of-component />
You can see a list out all the installed Power-Ups by running the following command:
php artisan powerup:list
If you wish to disable or remove the Power-up, you may run the following commands accordingly:
php artisan powerup:disable name-of-component
php artisan powerup:remove name-of-component
Available Power-Ups
Here are a list of a some available Power-Ups you can use, or you can create your own.
- 👋 Hello World - Example power-up for learning purposes
- 📸 Media Selector - Add an Emoji, Icon, or Image using the MediaSelector
Create Your Own Power-Ups
If you wish to create your own Power-Up, you can easily copy the HelloWorld example and create your own. This will allow you to convert any existing Livewire component and turn it into your own Power-Up that can be used across all your apps.
Testing
composer test
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 tony@devdojo.com instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.
Laravel Package Boilerplate
This package was generated using the Laravel Package Boilerplate.