V2 is in public beta! 🎉 Report any issues on the repository.

Powerful suite of Blade components for TALL Stack apps.

Upgrade Guide

WARNING!

2.x is in public beta while we gather community feedback.

This page transcribes a conversation between the creator of the TallStackUI - AJ, and you.

# Before Start

Before you start updating your application to TallStackUI 2.x, I, AJ, would like to thank you for using TallStackUI. I am very happy to know that by solving my problem, I was able to help you too, because TallStackUI was designed to solve my problem of not relying on other component libraries that are abandoned over time.

Also, I would like to apologize for the delay! Yes, I consider it a big delay. My goal was to release version 2.x on the same date as version 1.x, on November 28th. Unfortunately, I was unable to meet this deadline due to several issues I had in my office.

# Whats News

TallStackUI 2.x brings a number of things that I consider important. You can think of components, components, and components, but a library like TallStackUI isn't just about new components. Version 2.x brings new components, improvements to current components, and hundreds of small bug fixes.

Here's a quick list of what you can expect from version 2.x 👇

👀 Internal:

  • - Redesigned internal structure for better long-term maintenance.
  • - Internal documentation in important logic sections.
  • - New internal concepts to improve Blade file structure.
  • - Increased performance for rendering multiple components by up to 10%

🥳 New Components and Helper:

  • - Carousel
  • - Environment
  • - Layout
  • - Signature
  • - New Helper: EnvBar

🌐 Others:

  • - New Scoped Soft Personalization concept.
  • - New colors personalization concept.
  • - New icons concept.
  • - Card Component: support of colors, image and minimize effect.
  • - Dropdown Component: support to child dropdown.
  • - Floating Component: ability to personalize floating class per component.
  • - Form Color Component: support of clearable option.
  • - Form Input Component: support of clearable option.
  • - Form Input Component: ability to globally invalidate form validation errors.
  • - Form Select Styled Component: support of a basic lazy loading.
  • - Form Select Styled Component: support of group options.
  • - Form Select Styled Component: support of set select with default values.
  • - Form Password Component: ability to change password generator algorithm.
  • - Form Number Component: ability to increase/decrease by using step attribute.
  • - Form Upload Component: ability to validate BEFORE the upload.
  • - Form Upload Component: ability to control the floating closing effect after upload.
  • - Rating Component: ability to use any icon.
  • - Slide Component: ability of opening via new positions: top and bottom.
  • - Stats Component: support to wire:click .
  • - Helper darkTheme : several enhancements.
  • - Helper Debug Mode : now the ignore works with component class name instead of pure string.

With the exception of the "Internal" section, all details are described on the respective pages for each component.

# How to Upgrade

Now that I've listed everything I've done in this new version so far, let's talk about how to upgrade your application from version 1.x to the new version, 2.x. First of all, it's important to mention that how much work it will be to upgrade to version 2.x will depend on how your application is doing. I've upgraded two of my SaaS applications by simply changing the version reference in composer.json

1. Check soft personalization keys:

Before starting the update process, check if the names of the Soft Personalization keys remain the same. I've renamed some of them for better internal organization regarding the naming logic. If you do not use Soft Personalization, then just skip this step!

2. Redo deep personalization:

While I know this is a lot of work, if you have published TallStackUI Blade files or extended component classes to change specific behaviors - such as the 1.x color scheme customization, we recommend that you back up your files, republish the new ones, and adjust the new files with your adjustments. This is necessary because since we are talking about a new version, several internal changes have been made, so your current files will be out of date. If you do not use Soft Personalization, then just skip this step!

3. Save soft personalization scoped:

The concept of Scoped Soft Personalization has changed in version 2.x, and the change is for the better! So save all your customizations to apply them using the new concept. I explain everything about this on the Soft Personalization page. If you do not use Soft Personalization, then just skip this step!

4. Component attributes:

As for the components and their attributes, there is no change, they are the same. In this regard, I hope you will not have any problems. That is why if you use TallStackUI "in a basic way", then the upgrade process becomes extremely easy, as in my personal projects.

5. Republish the configuration file:

The TallStackUI configuration file - config/tallstackui.php , will contain changes and additions to content in this new version, 2.x. Be sure to compare your changes with the new file and synchronize accordingly so that your file has the necessary modifications and additions, such as the addition of new components.

6. Update the Composer:

Finally, it's time to update your application to the beta version 2.x. Edit your composer.json file: 

"require": {
    "laravel/framework": "^11.0",
    "tallstackui/tallstackui": "^2.0@beta", 
    "livewire/livewire": "^3.0",
 
    // ...
},

After that, run this command: 

rm -fr vendor/ && composer install

This will delete your vendor folder - to ensure a correct update, and install the beta version of TallStackUI.

If you notice any inconsistencies with this guide or any unexpected behavior during the beta phase, please help us by reporting as an issue.

Code highlighting provided by Torchlight