README

A front-end preset for Laravel to scaffold an application using the TALL stack with maryUI components.

Some notable features of this package include:

Views extending a base layout
Front-end assets like Tailwind CSS and Alpine.js compiled with Vite
maryUI components ready to use
Livewire installation

Installation

This preset is intended to be installed into a fresh Laravel 12 application.

Simply run the following commands:

composer require alexvargash/tall-maryui
php artisan tall:install

After running php artisan tall:install you will be prompted if you want to install the auth scaffolding and if you want to compile the assets.

Some notable features of the authentication scaffolding include:

Powered by Livewire components and single action controllers
Bundled with pre-written tests
Auth components build with maryUI

All routes, components, controllers, config files 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.

Removing the package

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.

Authentication routes

In the config\tall-maryui file you can specify name routes for the auth redirects.

return [
    /*
    |--------------------------------------------------------------------------
    | Authentication Routes
    |--------------------------------------------------------------------------
    |
    | These configuration options determine the route that a user is redirected
    | after an action is successful.
    |
    */

    'routes' => [
        'login' => 'home',
        'register' => 'home',
        'verify' => 'home',
        'reset_password' => 'home',
    ],

];

maryUI components

If for some reason you need to rename maryUI components using a custom prefix, you can do it in the config\mary file.

return [
    /**
     * Default component prefix.
     *
     * Make sure to clear view cache after renaming with `php artisan view:clear`
     *
     *    prefix => ''
     *              <x-button />
     *              <x-card />
     *
     *    prefix => 'mary-'
     *               <x-mary-button />
     *               <x-mary-card />
     *
     */
    'prefix' => '',

];

Credits

laravel-frontend-presets\tall

alexvargash / tall-maryui

Maintainers

Details