Repository files navigation

An opinionated Laravel front-end scaffolding preset for TTALL stack - Tailwindcss | Turbolinks | Alpine.js | Laravel | Livewire 🚀

It comes bundled with some helpful packages and their configurations (optional):

It uses concerns oflaravel/ui through Livewire actions. So, security features of laravel/ui (ex: login throttling) are built right in. It also comes bundled with some helpful packages and their configurations (optional):

• Laravel debugbar
• Laravel IDE Helper
• Php CS Fixer
• Larastan
• Eslint (Airbnb rules)
• Prettier
• Composer Git Hooks

If you like this package, show some love by starring the repo. ⭐❤

• TTALL Preset For Laravel 7 and Up
  • Contents
  • Installation
    • For Basic Presets (without authentication)
    • For Presets with Authentication
  • Configuration
  • Options
    • Code Helpers
      • Scripts
  • Support
  • Credits
  • License

To install this preset on your laravel application, run:

composer require pktharindu/ttall --dev

To scaffold the basic preset without authentication, run:

php artisan ui ttall

To scaffold the basic preset, auth route entry and auth views in one go, run:

php artisan ui ttall --auth

Finally runcomposer update && npm install && npm run dev to install the new composer packages and compile your fresh scaffolding.

Add a new i18n string in theresources/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 will help with accessibility.

<li><ahref="URL?page=2"class="..."aria-label="Goto page #2">    2</a></li>

As this preset is designed to get you up-and-running quickly, it comes bundled with some extra options that will take you even further. To utilize these options, use the--option flag when installing the preset.

Usage Example:

php artisan ui ttall --option=code-helpers

code-helpers option will install and configure the below packages to help you with the development:

• Laravel debugbar
• Laravel IDE Helper
• Php CS Fixer
• Larastan
• Eslint (Airbnb rules)
• Prettier
• Composer Git Hooks

A composer's script is added automatically to tellLaravel IDE Helper to rescan yourFacades files and update git hooks after everycomposer update :

"scripts": {"post-update-cmd": ["Illuminate\\Foundation\\ComposerScripts::postUpdate","@php artisan ide-helper:generate","cghooks update"    ]}

Also, Git Hooks are added to format your php files automatically before each commit.

"extra": {"hooks": {"pre-commit": ["STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM -- '*.php')","php-cs-fixer fix","git add $STAGED_FILES"        ]    }},

Scripts are also added to yourpackage.json andcomposer.json to run specific actions :

• composer format : will usephp-cs-fixer to format your php files
• composer test : will use thephp artisan test command to run your phpunit tests
• composer analyse : will uselarastan to analyse your code
• npm run format : will format your js files onresources/js folder
• npm run lint : will find issues in your js files based on Airbnb's rules and try to fix them

If you require any support please contact me onTwitter or open an issue on this repository.

• P. K. Tharindu
• All Contributors

This Package is inspired bylaravel-frontend-presets/tall andYannickYayo/laravel-preset-ttall. I wanted to have a combination of both. Thanks to all authors of these packages.

Licensed under the MIT license, seeLICENSE for details.