references/images/patterns.md
Images Patterns
Choose the workflow that matches the existing storage and delivery architecture, then read its implementation guide.
| Workflow | Documentation | |----------|---------------| | Let users upload without exposing account credentials | Direct Creator Upload | | Serve images for different layouts and display densities | Make responsive images | | Select output format for hosted images | Hosted-image format optimization | | Select output format for a Worker pipeline | Workers optimization binding | | Optimize user uploads, add a watermark, and store the result in R2 | Transform user-uploaded images before uploading to R2 | | Compose overlays and watermarks | Draw overlays | | Cache a Worker transformation response | Binding methods and caching guidance | | Configure hosted-image browser caching | Browser TTL |
Adapt dimensions and quality to the actual layout and representative source images. Keep upload credentials server-side, preserve the application's access checks, and validate both the resulting image and its response headers. Consult limits and troubleshooting before choosing batch sizes or retry behavior.