Upgrade Guide

1. Rename "personalization" to "customization":

The terminology has changed across the entire library: "Soft Personalization" is now "Soft Customization", "Deep Personalization" is now "Deep Customization", and so on. The main facade method has also changed from personalize() to customize() . Update any references in your code accordingly:

use TallStackUi\Facades\TallStackUi;
 
// In AppServiceProvider::boot()
 
TallStackUi::personalize() 
TallStackUi::customize() 
    ->alert()
    ->block('wrapper', 'rounded-full');

If you do not use any personalization/customization features, then just skip this step!

2. Check soft customization keys:

Some soft customization keys may have been renamed for better organization. Before upgrading, review the Soft Customization documentation to verify your keys are up to date. If you do not use Soft Customization, then just skip this step!

3. Redo deep customization:

If you have published TallStackUI Blade files or extended component classes, we recommend that you back up your files, republish the new ones, and reapply your adjustments. Internal changes require fresh files to work properly. If you do not use Deep Customization, then just skip this step!

4. Internal Scoped Customization:

If you used to publish Blade files to customize internal components within other components, this is no longer necessary. Learn about the Internal Scoped Customization: a way to customize internal components without publishing Blade files or changing all components globally.

5. Update TailwindCSS to v4:

TallStackUI 3 requires TailwindCSS v4. Support for TailwindCSS v3 has been discontinued. Follow the official TailwindCSS v4 migration guide to update your project. This is an important step for all users.

6. Update vendor publishable tag:

Important: The vendor publishable tag has been renamed from tallstackui to ts-ui . This affects all php artisan vendor:publish commands. If you have any scripts, CI pipelines, or documentation referencing the old tag name, make sure to update them to use ts-ui instead.

7. Republish the configuration file:

The TallStackUI configuration file - config/tallstackui.php , contains changes and additions in version 3. Be sure to compare your changes with the new file and synchronize accordingly so that your file has the necessary modifications and additions.

8. Migrate to the $tsui JavaScript helper:

In version 3, all individual JavaScript helpers have been unified into a single global $tsui object. If you use any of the old helpers in your Alpine.js expressions or Blade templates, you must update them:

9. Rename environment variable:

The environment variable TALLSTACKUI_AVOID_LAYOUT_REGISTRATION has been renamed to TALLSTACKUI_IGNORE_LAYOUT_REGISTRATION . If you use this variable in your .env file or CI/CD pipelines, make sure to update it. The old variable name will not be recognized in version 3.

10. Component attributes:

Most component attributes remain the same. New attributes have been added to several components (check individual component documentation pages for details). In this regard, you should not have any breaking changes.

11. Update the Composer:

Finally, it's time to update your application to version 3. Edit your composer.json file:

"require": {
    "laravel/framework": "^12.0",
    "tallstackui/tallstackui": "^2.0", 
    "tallstackui/tallstackui": "^3.0", 
    "livewire/livewire": "^4.0",
 
    // ...
},

After that, remove the vendor folder and then run this command to reinstall all your dependencies:

composer install