amici/craft-super-images

High-performance image processing, transformation, encoding, optimization, storage, and delivery for Craft CMS.

5.0.0 2026-08-18 09:01 UTC

Requires

• php: ^8.2 || ^8.3 || ^8.4
• ext-json: *
• craftcms/cms: ^5.0

Suggests

• ext-gd: Baseline image driver fallback.
• ext-imagick: Recommended image driver when Libvips is unavailable.
• aws/aws-sdk-php: Required for S3 / DigitalOcean Spaces / Cloudflare R2 storage adapters.
• jcupitt/vips: Preferred high-performance Libvips driver.

proprietary

• Amici Infotech

• s3
• cms
• images
• optimization
• cdn
• Craft
• craftcms
• craft-plugin
• Webp
• avif
• craft5
• transforms

Published on Packagist.org on 2026-08-18 10:58 UTC

README

High-performance image processing for Craft CMS 5.

Transforms, format conversion (JPEG / PNG / WebP / AVIF), optimization, local & S3-compatible storage, and deterministic derivative delivery — one engine for Twig, CLI, queue, and runtime generation.

Requirements

• Craft CMS 5.x
• PHP 8.2+
• At least one image driver: GD, Imagick, or Libvips (jcupitt/vips)

Optional:

• aws/aws-sdk-php for S3 / Spaces / R2
• External optimizers: jpegoptim, oxipng, optipng, pngquant, cwebp, avifenc

Installation

composer require amici/craft-super-images
php craft plugin/install super-images
cp vendor/amici/craft-super-images/config/super-images.example.php config/super-images.php

Interactive demo (optional)

cp -R vendor/amici/craft-super-images/demo templates/super-images

Open /super-images for live Twig examples (CDN-first — no Asset ID required).

Quick Twig

{{ craft.superImages.img(asset, { profile: 'responsive', variant: 'md', format: 'webp' }) }}
{{ craft.superImages.picture(asset, { profile: 'responsive', formats: ['webp', 'jpg'], sizes: '100vw' }) }}

Documentation

New to Super Images? docs/getting-started.md

Full index: docs/README.md

Topic	Doc
Getting started	docs/getting-started.md
Extend (storage, optimizers, ops)	docs/extension-api.md + examples/
Interactive demo	docs/demo.md
Configuration	docs/configuration.md
Twig API & operations	docs/twig.md
Storage & path naming	docs/storage.md
Control Panel	docs/control-panel.md
CLI	docs/cli.md
Encoders / optimizers	docs/encoders-optimizers.md

Example config: config/super-images.example.php

Changelog

See CHANGELOG.md for release notes.

License

Proprietary — Amici Infotech