← Back to upload

How it works

One image moves through a private conversion line.

The product is intentionally narrow: upload one static source, configure the image pack, let the worker generate responsive assets, then download the result before temporary files expire.

01

Upload one source image

Start with a static JPEG, PNG, or WebP. The app checks the file size and image limits before creating a temporary processing job.

02

Analyze the source

The backend reads dimensions, format, transparency, aspect ratio, and image characteristics. This gives the configure screen enough context to suggest practical defaults.

03

Review recommended settings

Choose output formats, responsive widths, quality levels, image role, loading behavior, and code preferences. Defaults are selected, but every important choice remains visible.

04

Convert in the background

A worker process uses pyvips to generate optimized variants while the web UI tracks job progress. The API stays responsive because CPU-heavy conversion does not run in the request handler.

05

Package assets and code

The result includes generated images, a manifest, examples for common implementation targets, and a ZIP package for downloading the complete image pack.

06

Expire temporary files

Source files and generated outputs are stored privately and removed after the retention window. The MVP is built for temporary conversion, not permanent asset hosting.

What runs behind the scenes

  • Next.js provides the upload, configure, progress, and results screens.
  • FastAPI exposes the versioned API and keeps route handlers thin.
  • Redis stores temporary job state, sessions, leases, counters, and queue state.
  • Celery workers process image analysis, conversion, packaging, and cleanup jobs.
  • MinIO/S3-compatible storage holds private temporary source and output objects.

Why the flow is staged

Image conversion can be slow and memory-heavy. Splitting the work into upload, analysis, configuration, background processing, and packaging keeps the API responsive and makes recovery clearer when a job fails.

See what is planned next →