/tall

[WIP] Do not use, this is the old preset.

Primary LanguagePHP

Laravel TALL

build status   npx use-preset tall   use-preset version

use-preset is a scaffolding tool for developers. Read the documentation for more information.

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