alok-vishu / jetstrap
A Laravel 8 package to easily switch TailwindCSS resources generated by Laravel Jetstream to Bootstrap 5.
Installs: 20
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 1
Forks: 0
Open Issues: 0
Language:Blade
Requires
- php: ^7.3|^8.0
- illuminate/support: ^8.0
- laravel/jetstream: ^2.3
Requires (Dev)
- orchestra/testbench: ^6.0
- phpunit/phpunit: ^9.3
This package is auto-updated.
Last update: 2024-10-06 18:27:08 UTC
README
Specially customized Laravel jetstream's scaffolding for Vuexy-html-laravel-template. It does not work with another project
Description
Laravel Jetstream is designed using Tailwind CSS and offers your choice of Livewire or Inertia scaffolding. We have remove the Tailwind css dependency and modify the Livewire scaffolding as per our template theme. Please note we have not provided Inertia scaffolding yet.
Vuexy Jetstrap is a lightweight laravel 8 package that focuses on the VIEW
side of Jetstream package installed in your Laravel application, so when a swap is performed, the Action
, MODEL
, CONTROLLER
, Component
and Action
classes of your project is still 100% handled by Laravel development team with no added layer of complexity.
Table of Content
Installation
Installing Jetstream
You may use Composer to install Jetstream into your new Laravel project:
composer require laravel/jetstream
If you choose to install Jetstream through Composer, you should run the jetstream:install Artisan command. This command accepts the name of the stack you prefer (livewire). You are highly encouraged to read through the entire documentation of Livewire before beginning your Jetstream project. In addition, you may use the --teams switch to enable team support:
Install Jetstream With Livewire
php artisan jetstream:install livewire or php artisan jetstream:install livewire --teams
Install Jetstrap
Use Composer to install Jetstrap into your new Laravel project as dev dependency:
composer require Pixinvent/jetstrap-vuexy --dev
Regardless how you install Jetstream, Jetstrap commands are very similar to that
of Jetstream as it accepts the name of the stack you would like to swap (livewire).
It is important you install and configure Laravel Jetstream before performing a swap.
You are highly encouraged to read through the entire documentation of Jetstream
before beginning your Jetstrap project. In addition, you may use the --teams
switch to swap team assets just like you would in Jetstream:
php artisan jetstrap_vuexy:swap livewire or php artisan jetstrap_vuexy:swap livewire --teams
This will publish overrides to enable Bootstrap like the good old days!
Finalizing The Installation
After installing Jetstrap and swapping Jetstream resources, remove tailwindCSS and its dependencies if any from your package.json and then install and build your NPM dependencies and migrate your database:
npm install && npm run mix
yarn && yarn mix
php artisan migrate
Extras
Pagination
It is also important to point out that Laravel 8 still includes pagination views built using Bootstrap CSS. To use these views instead of the default Tailwind views, you may call the paginator's useBootstrap method within your AppServiceProvider:
<?php namespace App\Providers; use Illuminate\Support\ServiceProvider; use Illuminate\Pagination\Paginator; class AppServiceProvider extends ServiceProvider { /** * Register any application services. * * @return void */ public function register() { // } /** * Bootstrap any application services. * @return void */ public function boot() { Paginator::useBootstrap(); } }
License
Jetstrap is open-sourced software licensed under the MIT license.