Upgrade Sage v10 to v11

sage
1

I want to upgrade the Sage theme from version 10 to 11. I’m also using Tailwind and SCSS. Is there any guide/tutorial that I might have missed?

2

Hello!

I used this one:

Upgrading from Sage 10 to Sage 11 is almost comically easy. For comparison, upgrading from Sage 9 to Sage 10 was a completely different beast and was quite the annoyance.

Even upgrading an ancient poorly coded site from Sage 10 with Bedrock to Sage 11 with Radicle took 3-4 hours which is nothing all things considered. Would recommend if you have 80 bucks sitting around waiting to be spent.

All in all I’d say a normal Sage 10 to Sage 11 migration will take 2 hours tops.

The way that assets are fetched has been changed with Sage 11, and I’d suggest using a helper function instead of doing it “raw”, especially if there’ a chance that the assets aren’t available.

helpers.php:

use Illuminate\Support\Facades\Vite;
if (!function_exists('getAsset')) {
    function getAsset(string $path): string
    {
        try {
            return Vite::asset($path);
        } catch (\Exception $e) {
            Log::error($e->getMessage());

            return $path;
        }
    }
}

How to use it:
$favicon_icon = getAsset('resources/images/favicon.ico');

1 Like
3

I wrote this Sage 10 to 11 Upgrade Guide which goes through the process of upgrading as well as some common bugfixes and tweaks you may want or need to make after the upgrade, such as fixing image paths, loading jQuery, etc.

1 Like
4

perfect thanks so much

1 Like