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
    • Install Jetstream With Livewire
  • Install Bootsjet
  • Finalizing The Installation

• License

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:

1. Ensure Tailwind packages are removed from package.json if they are still present.
2. Ensure Bootstrap/Sass dependencies are available in your frontend setup.
3. Install and build frontend assets.
4. 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 use npm run dev.

License

Bootsjet is open-sourced software licensed under the MIT license.