README

Need to:

• Transform in Worker? → api.md (Workers Binding API)
• Upload from Worker? → api.md (REST API)
• Upload from client? → patterns.md (Direct Creator Upload)
• Set up variants? → configuration.md
• Serve responsive images? → patterns.md
• Add watermarks? → patterns.md
• Fix errors? → gotchas.md

Reading Order

For building image upload/transform feature:

1. configuration.md - Setup Workers binding
2. api.md - Learn transform API
3. patterns.md - Direct upload pattern
4. gotchas.md - Check limits and errors

For URL-based transforms:

1. configuration.md - Create variants
2. api.md - URL syntax
3. patterns.md - Responsive patterns

For troubleshooting:

1. gotchas.md - Error messages
2. gotchas.md - Size/format limits

Core Methods

In This Reference

• api.md - Complete API: Workers binding, REST endpoints, URL transforms
• configuration.md - Setup: wrangler.toml, variants, auth, signed URLs
• patterns.md - Patterns: responsive images, watermarks, format negotiation, caching
• gotchas.md - Troubleshooting: limits, errors, best practices

Key Features

• Automatic Optimization - AVIF/WebP format negotiation
• On-the-fly Transforms - Resize, crop, blur, sharpen via URL or API
• Workers Binding - Transform images in Workers (2026 primary method)
• Direct Upload - Secure client-side uploads without backend proxy
• Global Delivery - Cached at 300+ Cloudflare data centers
• Watermarking - Overlay images programmatically

See Also

• Official Docs (opens in a new tab)
• Workers Examples (opens in a new tab)