Repository files navigation

A front-end preset for Laravel to scaffold an application using theTALL stack, jumpstarting your application's development.

If you're not familiar with the name, it's an acronym that describes the main technologies involved in the stack:

• Tailwind CSS
• Alpine.js
• Laravel
• Livewire

Some notable features of this package include:

• Views extending a default layout
• Front-end assets like Tailwind CSS and Alpine.js compiled with Vite 3
• Tailwind-powered pagination views
• TheTailwind UI and Tailwind'sCustom Forms extensions available out-of-the-box

Note: If you're looking for an application boilerplate that supports the TALL stack, you should check outLaravel Jetstream. It comes with authentication scaffolding, account management, teams support.

This preset is intended to be installed into a fresh Laravel application. FollowLaravel's installation instructions to ensure you have a working environment before continuing.

Then simply run the following commands:

composer require livewire/livewire laravel-frontend-presets/tallphp artisan ui tallnpm installnpm run dev

If you would like to install the preset and its auth scaffolding in a fresh Laravel application, make sure to use the--auth flag on theui command:

composer require livewire/livewire laravel-frontend-presets/tallphp artisan ui tall --authnpm installnpm run dev

Some notable features of the authentication scaffolding include:

• Powered by Livewire components and single action controllers
• Bundled with 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.

Tailwind uses PurgeCSS to remove any unused classes from your production CSS builds. You can modify or remove this behaviour in thepurge section of yourtailwind.config.js file. For more information, please see theTailwind documentation.

If you don't want to keep this package installed once you've installed the preset, you can safely remove it. Unlike the default Laravel presets, this one publishes all the auth logic to your project's/app directory, so it's fully redundant.

If you are using pagination, you set the default pagination views to the ones provided in theboot method of a service provider:

useIlluminate\Pagination\Paginator;useIlluminate\Support\ServiceProvider;class AppServiceProviderextends ServiceProvider{publicfunctionboot()    {        Paginator::defaultView('pagination::default');        Paginator::defaultSimpleView('pagination::simple-default');    }}

• Dan Harrin
• Liam Hammett
• Ryan Chandler
• Tailwind UI for the default authentication and pagination views
• All Contributors