open source · typescript · MIT
One type-safe API for Cloudinary, S3, R2, and the providers you add next. Less SDK noise, more feature work.
FluxMedia keeps provider differences behind one surface so your app code stays boring in the best way.
Core API
Cloudinary, S3, and R2 share one upload contract. Swap providers without rewriting call sites.
// Same code for ANY provider
const uploader = new MediaUploader(
new S3Provider({ ... }) // or Cloudinary, R2
);
await uploader.upload(file, {
folder: "uploads",
onProgress: (p) => console.log(p)
});Strict types on configs, uploads, and plugin hooks. Autocomplete where SDKs usually guess.
Import only the core and providers you ship. No monolithic client bundle.
Production tooling
Validation, optimization, metadata, analytics, and retry attach in a predictable order.
Upload state, progress, and errors surfaced for UI without reimplementing event wiring.
Exponential backoff for transient failures, configured once at the uploader level.
Provider surface
Resize, format, and quality paths on Cloudinary. S3 and R2 stay lean by design.
Catch bucket names, regions, and option shapes before deploy, not in production logs.
Provider-specific features stay optional. The core contract does not.
R2 ships with zero egress fees. Cloudinary carries transforms. S3 stays minimal.
| Capability | Cloudinary | AWS S3 | Cloudflare R2 |
|---|---|---|---|
| Image transforms | Supported | Not supported | Not supported |
| Video processing | Supported | Not supported | Not supported |
| AI tagging | Supported | Not supported | Not supported |
| Multipart upload | Supported | Supported | Supported |
| Direct upload | Supported | Supported | Supported |
FluxMedia normalizes uploads across providers. Reach for native SDK features only when you need provider-specific behavior.
Docs, examples, and a playground. Everything you need to wire FluxMedia into your stack tonight.