yannickyayo / laravel-preset-ttall
Laravel frontend preset for Ttall stack
Installs: 822
Dependents: 0
Suggesters: 0
Security: 0
Stars: 9
Watchers: 5
Forks: 4
Open Issues: 3
Language:HTML
Requires
- laravel/framework: ^6.0 || ^7.0
- laravel/ui: ^1.2 || ^2.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.16
- phpstan/phpstan: ^0.12.14
README
An opiniated Laravel front-end scaffolding preset for TTALL stack - Taiwlindcss | Turbolinks | Alpinejs | Laravel | Livewire.
If you are using a previous version of this package (current version is 3.x), check the table below to find the right README.md
file:
It comes with usefull packages and their configurations files :
- Laravel debugbar
- Laravel IDE Helper
- Php CS Fixer
- Larastan
- Eslint (Airbnb rules)
- Prettier
1. Usage
- Fresh install Laravel >= 6.0 and
cd
to your app. - Install this preset via
composer require yannickyayo/laravel-preset-ttall --dev
. Laravel will automatically discover this package. No need to register the service provider.
a. For Presets without Authentication
- Use
php artisan ui ttall
for the basic preset composer update && npm install && npm run dev
php artisan serve
(or equivalent) to run server and test preset.
b. For Presets with Authentication
- Use
php artisan ui ttall --auth
for the basic preset, auth route entry and auth views in one go. (NOTE: If you run this command several times, be sure to clean up the duplicate Auth entries inroutes/web.php
) composer update && npm install && npm run dev
php artisan serve
(or equivalent) to run server and test preset.
Config
The default tailwind.config.js
configuration file included by this package is including the Inter
font family. You should wish to make changes by removing the file and run node_modules/.bin/tailwind init
, which will generate a fresh configuration file for you, which you are free to change to suit your needs.
The Inter
font family is included in your resources/layouts/app.blade.php
file.
Add a new i18n string in the resources/lang/XX/pagination.php
file for each language that your app uses:
'previous' => '« Previous', 'next' => 'Next »', 'goto_page' => 'Goto page #:page', // Add this line
This should help with accessibility
<li> <a href="URL?page=2" class="..." aria-label="Goto page #2"> 2 </a> </li>
scripts
A composer's script is added automatically to tell Laravel IDE Helper
to rescan your Facades
and Models
files after every composer update
:
"scripts":{ "post-update-cmd": [ "Illuminate\\Foundation\\ComposerScripts::postUpdate", "@php artisan ide-helper:generate", "@php artisan ide-helper:meta" ] }
Scripts are also added to your package.json
and composer.json
to run specific actions :
composer format
: will usephp-cs-fixer
to format your php filescomposer test
: will use thephp artisan test
command to run your phpunit testscomposer analyse
: will uselarastan
to analyse your codenpm run format
: will format your js files onresources/js
foldernpm run lint
: will find issues in your js files based on Airbnb's rules and try to fix them
Screenshots
Coming soon...