The Bridge — URL Translation Between Providers

Translate image URLs between 8 CDN providers in real-time. Migrate from Imgix to Cloudinary, Cloudflare to ImageKit, or any combination — without rewriting a single URL in your codebase.

How It Works

1. Client requests: /~bridge/migrate-to-imgix/cover/300x300/photo.jpg
2. Parse URL using source parser (e.g. ImageBoss format)
3. Convert to CanonicalOptions (provider-agnostic)
4. Emit URL in target format (e.g. Imgix query params)
5. Redirect (301/302) to target domain

The bridge performs no image processing — it's a pure URL translator that redirects to the target provider.

8 Supported Platforms

Any-to-any translation between these platforms — 56 possible combinations:

ImageBoss

Path-based: /:source/:op/:dims/path

Imgix

Query params: /path?w=400&fit=crop

Cloudflare

Path: /cdn-cgi/image/w=400/path

Cloudinary

Path: /image/upload/w_400,c_fill/path

ImageKit

Path: /tr:w-400/path

Sirv

Query: ?w=400&scale.option=fill

Thumbor

Path: /unsafe/400x300/smart/path

Uploadcare

Path: /-/resize/400x300/

Configuration

bridges:
  - slug: imgix-to-cloudinary
    from: imgix
    to: cloudinary
    targetDomain: res.cloudinary.com/mycloud
    redirectCode: 302

  - slug: from-cloudflare
    from: cloudflare
    to: imageboss
    targetDomain: img.example.com
    redirectCode: 301

Use Cases

🚚

Provider Migration

Migrate from Imgix to Cloudinary (or vice versa) while old URLs continue working via redirects.

🧪

A/B Testing

Route a percentage of traffic through the bridge to compare quality, performance, and cost between providers.

🏗️

Multi-Provider Architecture

Route product images to Imgix, user content to Cloudinary, and blog images to your own infrastructure.

Translation Examples

FromToInput → Output
ImageBossImgix/cover:attention/400x300/photo.jpg?w=400&h=300&fit=crop&crop=entropy
CloudinaryImageBoss/w_400,c_fill,e_grayscale/photo.jpg/cover/400/grayscale:true/photo.jpg
ImgixCloudflare?w=400&blur=10/cdn-cgi/image/width=400,blur=10/photo.jpg

Migrate Without Rewriting URLs

Set up a bridge, redirect traffic, move at your own pace.

Get Started Free Read the Docs