Awesome
<p align="center"> <h1 align="center">Laravel TALL</h1> <p align="center"> <a href="https://github.com/use-preset/laravel-tall/actions"> <img alt="build status" src="https://github.com/use-preset/laravel-tall/workflows/tests/badge.svg" > </a> <a href="https://github.com/use-preset/use-preset/releases"> <img alt="npx use-preset tall" src="https://img.shields.io/badge/use--preset-laravel--tall-blue"> </a> <a href="https://www.npmjs.com/package/use-preset"> <img alt="use-preset version" src="https://img.shields.io/npm/v/use-preset?color=32c854&label=use-preset"> </a> </p> <p align="center"> <code>use-preset</code> is a scaffolding tool for developers. <a href="https://docs.usepreset.dev/">Read the documentation</a> for more information. </p> <p>About
This preset is inspired by
laravel-frontend-presets/tall
.
This Laravel preset scaffolds an application using the TALL
stack, jumpstarting your application's development. If you are not familiar with the name, it is an acronym that describes the main technologies involved in the stack:
Tailwind CSS | Alpine.js | Laravel | Livewire |
---|---|---|---|
Utility-first CSS framework | Minimal Javascript framework | PHP framework | Full-stack UI Laravel framework |
Installation
This preset is intended to be installed into a fresh Laravel application. Follow the Laravel installation instructions to ensure you have a working environment before continuing.
Then, run the following command:
npx apply laravel:tall
You'll need to run npm run dev
or yarn dev
to compile your assets right after.
Note that because of an issue with Laravel Mix itself, the vue-template-compiler
will be added even though the preset doesn't use Vue. You may need to run npm install
or yarn
, then npm run dev
or yarn dev
a second time after Mix installs vue-template-compiler
if it results in an error.
An alternative would be to use Webpack Encore instead of Laravel Mix, but no preset exists at this time and Mix will eventually end up fixing that issue (hopefully!).
Authentication
If you don't want the preset to install the authentication scaffolding, you may use the --no-auth
flag.
Some notable features of the authentication scaffolding include:
- Livewire components ans single action controllers
- Pre-written tests
All routes, components, controllers and tests are published to your application. The idea behind this is that you have full control over every aspect of the scaffolding in your own app, removing the need to dig around in the vendor folder to figure out how things are working.
Note: as opposed to other Laravel front-end presets, the authentication logic is published to your application. It means that
laravel/ui
is not required at all.
Pagination
This preset sets up the paginator in the AppServiceProvider
file. If you wish to not use it, you can add the --no-pagination
flag.
Credits
- Dan Harrin
- Liam Hammett
- Ryan Chandler
- Enzo Innocenzi
- Tailwind UI for the default authentication and pagination views
laravel-frontend-presets/tall
's contributorsuse-preset