Skip to content

Releases: shipbytes/laravel-ui-kit

Release list

v0.3.0

Choose a tag to compare

@shipbytes shipbytes released this 22 Oct 16:08

Changed

  • Breaking: Livewire 4. The kit now requires livewire/livewire: ^4.4 and
    no longer uses Volt. The eleven auth and profile pages stay single-file
    components at the same paths under resources/views/livewire/… (no ⚡
    prefix), now extending Livewire\Component; routes/auth.php registers them
    with Route::livewire() instead of Volt::route(), with unchanged URLs and
    route names. Nothing changes visually. To upgrade a 0.2 app:

    1. If the app's own composer.json requires livewire/volt (it normally
      arrives through the kit), run composer remove livewire/volt --no-update.
    2. composer require shipbytes/laravel-ui-kit:^0.3 -W — a ^0.2
      constraint never picks up 0.3, and -W lets Composer move Livewire 3 to 4
      and drop Volt.
    3. In routes/auth.php, replace Volt::route( with Route::livewire( and
      delete the use Livewire\Volt\Volt; line.
    4. In resources/views/livewire/**, replace use Livewire\Volt\Component;
      with use Livewire\Component;.
    5. If the app has a VoltServiceProvider, remove it from
      bootstrap/providers.php and delete app/Providers/VoltServiceProvider.php.
    6. php artisan ui-kit:doctor — every row should pass.

    Until steps 3–5 are done the app keeps working through the shim below.

Added

  • ui-kit:doctor checks for the Livewire 4 move: Livewire 4 installed,
    routes/auth.php uses Route::livewire, views free of Volt imports (lists
    the views under resources/views/livewire/ that still import Volt) and
    no Volt service provider, each with the repair step as its hint.
  • A transition shim for apps upgrading from 0.2: when Volt is not installed,
    the kit aliases Livewire\Volt\Volt (route(), mount()) and
    Livewire\Volt\Component onto their Livewire 4 equivalents, so an
    unmigrated routes/auth.php and its views keep working (and artisan keeps
    booting) until the steps above are done. It will be removed in 1.0.

Removed

  • The livewire/volt dependency.

v0.2.2

Choose a tag to compare

@shipbytes shipbytes released this 22 Oct 13:39

Added

  • Documentation screenshots. npm run screenshots (scripts/screenshots.mjs)
    builds a fresh Laravel 12 app with every module, seeds it deterministically
    and photographs each screen in light and dark mode into docs/images/,
    which shipbytes.dev copies at build time.

Fixed

  • The impersonation module registers its routes. lab404/laravel-impersonate
    ships impersonate and impersonate.leave as a router macro the app has to
    call; the module now injects Route::impersonate(); into
    routes/ui-kit-user.php (web + auth) at install, so the partials no longer
    fail with Route [impersonate] not defined on a fresh install. ui-kit:doctor
    gained an impersonation routes registered check. Apps that added the macro
    to routes/web.php by hand should remove that line after re-running
    ui-kit:install-module impersonation, or the doctor reports duplicate names.
  • ContactSubmission now uses HasFactory, so ContactSubmission::factory()
    works as the README promised.

Full changelog: v0.2.1...v0.2.2