m1ge0 / bootsjet
A Laravel 12-ready package for Jetstream + Livewire to switch from Tailwindcss to Bootstrap.
Requires
- php: ^8.2
- illuminate/support: ^11.0|^12.0
Requires (Dev)
- laravel/jetstream: ^5.0
- orchestra/testbench: ^9.0|^10.0
- phpunit/phpunit: ^10.5|^11.0
Suggests
- livewire/livewire: ^3.0|^4.0
README
Description
Bootsjet is a lightweight Laravel package that focuses on the VIEW layer of Jetstream (Livewire stack).
It swaps Tailwind-based frontend assets/views to Bootstrap-oriented stubs while leaving your existing backend flow (actions, models, controllers, components) untouched.
Compatibility
- PHP:
^8.2 - Laravel:
^11.0 | ^12.0 - Jetstream:
^5.0(Livewire stack) - Livewire:
^3.0 | ^4.0
Laravel 12 Support
Laravel 12 is now officially supported in this package line. Laravel 12 projects can keep using Livewire 4. Bootsjet should not force a Livewire downgrade.
Table of Content
Installation
Installing Jetstream
Use Composer to install Jetstream into your Laravel project:
composer require laravel/jetstream
After installing Jetstream, run jetstream:install with the livewire stack.
You can pass --teams if your project needs team features:
Install Jetstream With Livewire
php artisan jetstream:install livewire or php artisan jetstream:install livewire --teams
Install UI via Composer
Install Bootstrap scaffolding support via Composer:
composer require laravel/ui
Install Bootstrap with laravel/ui
php artisan ui bootstrap
Install Bootsjet
Install Bootsjet as a dev dependency:
composer require m1ge0/bootsjet --dev
Install and configure Laravel Jetstream before running the swap command.
You may use the --teams option to also swap team-related assets:
php artisan bootsjet:swap or php artisan bootsjet:swap --teams
This will publish overrides to enable Bootstrap like the good old days!
Finalizing The Installation
After swapping Jetstream resources:
- Ensure Tailwind packages are removed from
package.jsonif they are still present. - Ensure Bootstrap/Sass dependencies are available in your frontend setup.
- Install and build frontend assets.
- Run migrations.
bootsjet:swap tries to update package.json automatically (remove Tailwind-related packages and add Bootstrap/Sass when missing). Please still review the resulting file in case your project has custom frontend constraints.
npm install && npm run build
php artisan migrate
In production you should use
npm run build. During development you can usenpm run dev.
License
Bootsjet is open-sourced software licensed under the MIT license.