gammamatrix / playground-blade
Playground: Provides Blade UI handling.
Installs: 262
Dependents: 4
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Language:Blade
Requires
- php: ^8.2
- gammamatrix/playground: *
Requires (Dev)
This package is auto-updated.
Last update: 2025-03-05 19:26:26 UTC
README
The Playground Blade package for Laravel applications.
This package provides Blade UI handling.
Read more on using Playground Blade at Read the Docs: Playground Documentation.
Installation
You can install the package via composer:
composer require gammamatrix/playground-blade
Configuration
You can publish the config file with:
php artisan vendor:publish --provider="Playground\Blade\ServiceProvider" --tag="playground-config"
See the contents of the published config file: config/playground-blade.php
Read more on using Environment Variables at the Read the Docs for Playground Blade.
UI Layouts
NOTE: Using Blade is not required to use Playground, it just an option, such as Vue, React or TypeScript.
The configuration in config/playground-blade.php has a section for frontend assets. If you would like to add more assets, CSS or JavaScript, publish the configuration and add them to the libs section.
Assets may be loaded into either head or they will be added to the end of the body.
By default, the following libraries are loaded.
favicon:/favicon.ico- Nunito: Loaded from Google Fonts.
- Bootstrap: v5.3.3
- FontAwesome: v6.5.1
- CKEditor 5: v41.1.0
- Vue 3 - v3.4.21
/vendor/playground/blade.jsA small library to be loaded for Blade UI usage. Needs to be published.
Optionally, a page may load:
- CKEditor 5 an advanced WYSIWYG editor for forms.
Assets
If you are using the Playground Blade UI, you can publish the JS assets with:
php artisan vendor:publish --tag playground-blade-js
- These Javascript assets, resources/js/playground-blade.js, provide simple helpers for features such as Bootstrap Form Validation and loading CKEditor for textarea elements on forms.
Publishes CSS:
php artisan vendor:publish --tag playground-blade-css
You can publish the layouts file with:
php artisan vendor:publish --tag playground-blade-layouts
Components may also be published:
php artisan vendor:publish --tag playground-blade-components
Error pages are available at:
php artisan vendor:publish --tag playground-blade-errors
Testing
composer test
Cloc
composer cloc
➜ playground-blade git:(develop) ✗ composer cloc
> cloc --exclude-dir=output,vendor .
154 text files.
118 unique files.
38 files ignored.
github.com/AlDanial/cloc v 1.98 T=0.10 s (1143.8 files/s, 81948.0 lines/s)
-------------------------------------------------------------------------------
Language files blank comment code
-------------------------------------------------------------------------------
Blade 49 397 13 2700
PHP 47 466 518 2524
CSS 10 139 141 461
SVG 2 2 2 301
YAML 1 5 0 275
XML 3 0 7 221
Markdown 3 47 0 98
JSON 1 0 0 65
JavaScript 1 0 35 22
INI 1 3 0 12
-------------------------------------------------------------------------------
SUM: 118 1059 716 6679
-------------------------------------------------------------------------------
PHPStan
Tests at level 9 on:
config/resources/views/src/tests/Feature/tests/Unit/
composer analyse
About
Playground Blade provides information in the artisan about command.
Changelog
Please see CHANGELOG for more information on what has changed recently.
Credits
License
The MIT License (MIT). Please see License File for more information.