laravel-frontend-presets / tailwindcss

A Tailwind CSS frontend preset for the Laravel Framework
https://laravel-frontend-presets.github.io/tailwindcss/
MIT License
1.15k stars 140 forks source link
laravel preset tailwind tailwind-scaffolding tailwindcss

Laravel 7.0+ Frontend preset for Tailwind CSS

A Laravel front-end scaffolding preset for Tailwind CSS - a Utility-First CSS Framework for Rapid UI Development.

Usage

  1. Fresh install Laravel >= 7.0 and cd to your app.
  2. Install this preset via composer require laravel-frontend-presets/tailwindcss --dev. Laravel will automatically discover this package. No need to register the service provider.

a. For Presets without Authentication

  1. Use php artisan ui tailwindcss for the basic Tailwind CSS preset
  2. npm install && npm run dev
  3. php artisan serve (or equivalent) to run server and test preset.

b. For Presets with Authentication

  1. Use php artisan ui tailwindcss --auth for the basic preset, auth route entry, and Tailwind CSS auth views in one go. (NOTE: If you run this command several times, be sure to clean up the duplicate Auth entries in routes/web.php)
  2. npm install && npm run dev
  3. Configure your favorite database (mysql, sqlite etc.)
  4. php artisan migrate to create basic user tables.
  5. php artisan serve (or equivalent) to run server and test preset.

Config

The default tailwind.config.js configuration file included by this package simply uses the config from the Tailwind vendor files. Should you wish to make changes, you should remove the file and run node_modules/.bin/tailwind init, which will generate a fresh configuration file for you, which you are free to change to suit your needs.

Add a new i18n string in the resources/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 should help with accessibility

<li>
    <a href="https://github.com/laravel-frontend-presets/tailwindcss/blob/main/URL?page=2" class="..."
       aria-label="Goto page #2"
    >
        2
    </a>
</li>

Pagination

Laravel now supports Tailwind CSS pagination directly. If you would like to use these views in your app, you can refer to docs.

Screenshots

Welcome

Register

Login

Reset Password

Dashboard

Verify