# MattWilcox/Adaptive-Images

Automatically adapts your existing HTML images for mobile devices. No mark-up changes needed.

Repository: https://github.com/MattWilcox/Adaptive-Images
Canonical: https://ross.abutalabs.com/products/adaptive-images
Homepage: http://adaptive-images.com/
Language: HTML
License Family: other
Last push: 2020-01-28T15:28:13+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 5486, "days_push": 2409, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license, no_readme
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1753, forks 224 (observed 2026-08-28T04:05:31.910785+00:00)

## What it is
A PHP-based solution that automatically detects a visitor's screen size and delivers appropriately re-scaled, cached versions of a site's HTML images without requiring any markup changes. It works via an .htaccess rewrite, a small JavaScript snippet that stores screen size in a cookie, and a PHP script that resizes and caches images on the fly.

## Use cases
- serve smaller images to mobile devices without changing img tags
- reduce bandwidth costs for image-heavy responsive websites
- add responsive image support to an existing site with minimal setup
- automatically cache resized image variants per breakpoint
- support retina displays with appropriately sized images
- speed up page loads on slow, low-bandwidth mobile connections

## When to choose
- you have an existing PHP site (Apache or nginx) and cannot modify image markup
- you want a quick, drop-in responsive images solution with minutes of setup
- your CMS cannot generate multiple image resolutions itself
- you want automatic caching of downscaled image versions per screen size

## When to avoid
- your stack is not PHP (e.g. Node, Python, static site generators)
- you can use modern native solutions like srcset, picture element, or a CDN image service
- you need WebP/AVIF support or advanced image optimization
- you are starting a new project - modern responsive image standards are preferable

## Facets
- artifact type: library
- maturity: maintenance
- function: image-processing, caching, web-framework
- domain: web-development, frontend, image-processing, mobile-development
- platform: php, self-hosted
- tags: responsive-images, adaptive-images, htaccess, gd-library, mobile-web, no-markup-changes, image-resizing, retina-display, web-server, linux

## Member repositories
- MattWilcox/Adaptive-Images (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:31.910785+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:28:09.802741+00:00, confidence not recorded.
  - homepage: http://adaptive-images.com/ (fetched 2026-08-29T11:06:14.433662+00:00, sha f6e5b5169488)
  - site_page: https://adaptive-images.com/details.htm (fetched 2026-08-29T11:06:14.443847+00:00, sha 8c02627f216a)
- Data as of 2026-08-30T08:39:29.467469+00:00.