TallCraftUI

Upgrading to V2

This guide will help you upgrade from TallCraftUI v1 to v2.
Tip: Use git to track your changes during the upgrade.
If you encounter any issues, join our Discord community or open an issue on GitHub.

# Requirements

Follow these steps to upgrade your project from TallCraftUI v1 to v2.

# Upgrade Tailwind CSS

TallCraftUI v2 requires Tailwind CSS 4.x. If you are using an older version, you must upgrade Tailwind first.

Run the following command to upgrade Tailwind CSS:

npx @tailwindcss/upgrade

For more details, refer to the official Tailwind CSS upgrade guide.

# Install TallCraftUI V2

Update your composer.json to require TallCraftUI v2 and run the installation command:

composer require developermithu/tallcraftui:^2.0
php artisan install:tallcraftui

# Update Configuration File

Remove the old configuration file config/tallcraftui.php and publish the new one.

rm config/tallcraftui.php
php artisan vendor:publish --tag=tallcraftui-config

Review the newly published config/tallcraftui.php file for any new configuration options or changes.

# Clear View Cache

Clear the Laravel view cache to ensure your application uses the updated components:

php artisan view:clear

# Update Component Usage (Breaking Change)

The <x-select> component from v1 has been renamed to <x-native-select> in v2 to avoid conflicts with a new, enhanced <x-select> component.

You need to update your code wherever you used the old select component:

<!-- Before (v1) -->
<x-select wire:model="country" ... />
 
<!-- After (v2) -->
<x-native-select wire:model="country" ... />
 
<!-- New v2 Select (Optional) -->
<x-select wire:model="user_id" ... />

The new <x-select> component offers more features (like multiple options select and custom styling) and has a different API.