Existing R2 buckets
Use public R2 URLs as the source for product media, uploads, previews, CMS images, avatars, and galleries.
cloudflare r2 image optimization
Optimize Cloudflare R2 images without creating derived objects
Keep product photos, avatars, screenshots, CMS media, and generated previews in Cloudflare R2. Put Skymage in front of public R2 object URLs so apps, APIs, templates, and frontend clients can request exact dimensions, crops, WebP or AVIF output, compression, and cached delivery.
https://demo.skymage.net/v1/media.example.com/products/sku-42.jpg?w=520&h=390&fit=cover&f=webp&q=82
https://demo.skymage.net/v1/media.example.com/users/42/avatar.png?w=96&h=96&fit=cover&f=webp
https://demo.skymage.net/v1/media.example.com/previews/report-42.png?w=960&fit=inside&f=avif&q=84
r2 storage surfaces
Start with the R2 object URL your app already renders
A useful R2 image optimization test starts with one public object path, one repeated surface, and one helper or API response that can add Skymage parameters before the image reaches the browser.
S3-compatible helpers
Keep your current S3-compatible storage path and render optimized URLs from templates, serializers, or frontend components.
No derived objects first
Test resize, crop, compression, WebP, and AVIF through URL parameters before adding workers or extra R2 object variants.
first test map
Choose one R2 image family and prove the URL pattern
The first rollout should answer whether Skymage can fetch the public R2 URL, return the right variant, keep visual quality, and reduce transfer size on a repeated surface.
| R2-backed surface | Skymage URL pattern |
|---|---|
| Product or listing card | ?w=520&h=390&fit=cover&f=webp&q=82 |
| Avatar or logo | ?w=96&h=96&fit=cover&f=webp |
| Dashboard preview | ?w=960&fit=inside&f=avif&q=84 |
| Gallery detail | ?w=1440&fit=inside&f=webp&q=85 |
rollout path
A low-risk Cloudflare R2 image CDN test
Confirm public origin fit
Use one public R2 URL or CDN-backed bucket path that Skymage can fetch consistently.
Map rendered slots
Record the real card, avatar, preview, or gallery dimensions before choosing parameters.
Change one helper
Add Skymage URL generation in one template helper, serializer, API response, or frontend component.
Measure before expansion
Compare bytes, cache behavior, visual quality, and rollout complexity before touching more R2 object paths.
free check
Send one R2-backed page and get the first image path to test
The free audit will identify whether your public R2 URL, current template surface, and desired variants fit a low-risk Skymage rollout before adding workers or derived objects.