Introduction

Welcome to Repix, a self-hosted image transformation service built with TypeScript, Hono, and Sharp.

What is Repix?

Repix fetches images from remote URLs, applies transformations using Sharp, and returns the result. Point it at any image URL, add transformation parameters, and get back resized images in formats like JPEG, WebP, or AVIF.

Features

• URL-based API — Transform images via URL parameters; no SDK required
• Image Transformations — Resize, crop, format conversion, quality adjustment
• Fit Modes — cover, contain, scale-down, crop, pad
• Format Support — JPEG, PNG, WebP, AVIF
• Preset System — Define reusable transformation presets
• Environment Configuration — Configure via .env and environment variables
• Docker — Containerized deployment

How It Works

Repix fetches images from remote URLs, applies transformations using Sharp, and returns the optimized result. The URL pattern is:

https://your-domain.com/{preset|rules}/{source-url-without-prefix}

Using a preset:

https://your-domain.com/thumbnail/example.com/path/to/image.jpg

Using inline rules:

https://your-domain.com/w=400,h=300,fit=cover,f=webp,q=85/example.com/path/to/image.jpg

Requirements

• Node.js 22.0.0 or higher (required by Sharp and modern ES features)
• npm or yarn for package management