• Upgrade Guide
  • Preparation
    • Upgrade Filament
    • Upgrade Other Plugins
    • Livewire Model Binding
  • Registering The Plugins
    • Supported Plugins
    • Zeus Plugins
  • Theme and Assets
    • Custom Classes:
    • Frontend Views
  • Migrate The Configurations
  • Publish The Migration

#Upgrade Guide

The upgrading process is almost identical for all our packages; I'll list all the significant changes. If you found any missing information or had a bug, please open an issue in the corresponding repository for your package.

• Wind
• Sky
• Bolt
• Thunder
• Rain
• Rhea
• Artemis

#Preparation

#Upgrade Filament

First, update your filament app; after the upgrade, all Zeus packages won't be active by default, so it's an excellent opportunity to check and ensure that your app works perfectly after the upgrade.

#Upgrade Other Plugins

Ensure all other plugins in your app are updated for v3; check their versions and update them.

#Livewire Model Binding

Enable livewire model binding in the livewire config:

'legacy_model_binding' => true,

#Registering The Plugins

All Zeus plugins depend on other plugins, and you must register them all.

#Supported Plugins

->plugins([
    // ...
    SpatieLaravelTranslatablePlugin::make()
        //If you don't use multi-language
        ->defaultLocales([config('app.locale')])
        // or if you have more
        ->defaultLocales(['en', 'es']),
 
    // required for 'Sky' and 'dynamic dashboard' only
    FilamentNavigation::make(),
])

#Zeus Plugins

Now you can register Zeus plugins as needed.

->plugins([
    // ...
    WindPlugin::make(),
    SkyPlugin::make(),
    BoltPlugin::make(),
    RainPlugin::make(),
])

#Theme and Assets

#Custom Classes:

You need to add these files to your tailwind.config.js file in the content section.

• Core

  • frontend:
    • ./vendor/lara-zeus/core/resources/views/**/*.blade.php

• Wind

  • filament:
    • ./vendor/lara-zeus/wind/resources/views/filament/**/*.blade.php
    • ./vendor/lara-zeus/wind/src/Filament/Resources/LetterResource.php
  • frontend:
    • ./vendor/lara-zeus/wind/resources/views/themes/**/*.blade.php

• Sky

  • filament:
    • ./vendor/lara-zeus/wind/resources/views/filament/**/*.blade.php
    • ./vendor/lara-zeus/sky/src/Models/PostStatus.php
  • frontend:
    • ./vendor/lara-zeus/wind/resources/views/themes/**/*.blade.php
    • ./vendor/lara-zeus/sky/src/Models/PostStatus.php

• Bolt

  • filament:
    • ./vendor/lara-zeus/bolt/resources/views/filament/**/*.blade.php
  • frontend:
    • ./vendor/lara-zeus/bolt/resources/views/themes/**/*.blade.php

• Thunder

  • filament:
    • ./vendor/lara-zeus/bolt/resources/views/filament/**/*.blade.php
  • frontend:
    • ./vendor/lara-zeus/bolt/resources/views/themes/**/*.blade.php
    • ./vendor/lara-zeus/thunder/src/Models/TicketsStatus.php

• Rain

  • filament:
    • ./vendor/lara-zeus/rain/resources/views/filament/**/*.blade.php
  • frontend:
    • ./vendor/lara-zeus/rain/resources/views/themes/**/*.blade.php
    • ./vendor/lara-zeus/rain/src/Models/Columns.php

• Artemis

  • frontend:
    • ./vendor/lara-zeus/artemis/resources/views/**/*.blade.php

#Frontend Views

You must publish the missing new blade files if you publish the frontend views. Also, worth checking your published views and comparing them with the new ones; a lot has stayed the same but minor improvements.

#Migrate The Configurations

With the new filament structures, no more config files. All the configurations can be set by your panel provider. You need to check the Configuration.php class for each package.

• Wind
• Sky
• Bolt
• Thunder
• Rain
• Rhea

now, you can delete all old config files

#Publish The Migration

To make sure you have all migration, republish them by:

php artisan migrate