Laravel Webp Laravel Package

Product Decisions This Supports

• Media pipeline / asset optimization roadmap. The v3.2.0 release (Laravel 13.x compatibility) confirms the package still tracks current framework versions, so WebP conversion can remain a supported step in an image-delivery roadmap rather than a migration liability on the next Laravel upgrade.
• Build vs. buy for image conversion. This is a thin wrapper around GD/Imagick-backed WebP encoding with a facade (WebP::make($file)->save($path)). The decision it informs is narrow: do we hand-roll a converter service, or take a small dependency that gives us the encode-and-save primitive in ~10 lines? It buys the wrapper, not the pipeline.
• Feature scoping for media features. Because the package converts and saves but does not generate responsive variants, run async jobs, or manage storage/CDN lifecycles, it defines the floor of what our own ImagePipeline service must own (queues, <picture>/srcset markup, cache invalidation, fallback serving for non-WebP clients).
• Upgrade planning. A Laravel 13 compatibility release is a concrete input to "can we schedule the framework upgrade?" — it removes WebP conversion from the list of blockers, assuming our other image dependencies (Intervention Image, GD/Imagick builds) are equally current.
• Use-case fit. Well suited to admin-panel uploads, CMS thumbnails, and low-to-moderate volume conversion on request. Not a decision lever for high-traffic, multi-tenant media platforms.

When to Consider This Package

Adopt when:

• We are on a supported Laravel version (now including 13.x) and need straightforward "upload → convert to WebP → save" behavior in one or two call sites.
• The team values a small, readable dependency over a large media library, and we are comfortable owning the surrounding pipeline (queues, storage paths, cleanup, fallbacks).
• Volume is modest enough that synchronous conversion during the request is acceptable.
• We already have GD or Imagick compiled with WebP support in our runtime images — this must be verified, since the package delegates encoding to the underlying driver.

Look elsewhere when:

• We need responsive variant generation, art direction, on-the-fly transforms, or URL-based image resizing — a dedicated service (Glide, Intervention Image v3 pipelines, imgproxy, Cloudinary/imgix) is the better fit.
• We need queued/batch processing, progress reporting, or guaranteed idempotency for large media libraries.
• We require a vendor with SLAs, security disclosure process, or long-term commercial support; this is a single-maintainer, narrow-scope package.
• We need AVIF or next-gen format negotiation beyond WebP.

Risk notes to record: the release is compatibility-only, so there are no new features or breaking API changes in v3.2.0 — the practical upgrade risk is low, but a version bump should still be exercised against our own upload paths. Maintain a thin internal adapter around the facade so a future swap to a fuller media solution is a one-file change.

How to Pitch It (Stakeholders)

For executives: This is a small, low-cost utility that converts uploaded images to WebP, a format that typically cuts image payloads substantially and improves page load and Core Web Vitals. The new v3.2.0 release is a maintenance update that keeps it compatible with Laravel 13, so it will not block our framework upgrade. Recommendation: keep it for simple conversion needs, and treat it as one component — not a strategy — within a broader image-delivery plan.

For engineering: v3.2.0 is a compatibility-only release adding Laravel 13.x support; no API changes, no deprecations, no migration work expected beyond your normal upgrade pass. The package remains a thin facade over GD/Imagick WebP encoding — we still own queuing, storage layout, cache headers, and non-WebP fallbacks. Wrap it behind our own ImageConverter interface, confirm WebP support is compiled into the PHP image driver in every environment (including CI and containers), and add a smoke test on the convert-and-save path so a future major bump surfaces immediately.