blaze-optimize

Install livewire/blaze via Composer and register compilation paths with Blaze::optimize()->in() in AppServiceProvider. Blaze compiles anonymous Blade components into optimized PHP functions, reducing rendering overhead for component-heavy pages.

Apply memoization to slot-free components without global state access that render many times with the same props, such as icons or badges. Use @blaze(memo: true) in the component or set memo: true on a directory in the service provider.

Yes, Blaze optimizes Flux components automatically once the package is installed, with no additional configuration needed. If the project also has its own anonymous components, those can be registered separately for compilation.

Blaze only supports anonymous components, so class-based components are excluded. Components using the $component variable, view composers or creators, View::share variables, or rendering via view() instead of component tags are also incompatible.

Do not fold components that access global state such as auth, session, request, errors, time, CSRF, database queries, config, or cache, since folding bakes output at compile time and produces stale HTML. Also avoid folding when there are no measured performance issues.

This usually happens when the component accesses global state or uses props in internal logic without correct safe/unsafe annotations. Remove the @blaze directive or add compile: false, and run php artisan view:clear after any changes.