deviceframe

deviceframe is a command‑line utility that adds realistic device frames around screenshots of mobile apps, web sites, or progressive web apps. Users supply image files, globs, or URLs, and the tool downloads the selected frame assets from a CDN, caches them locally, and composites the screenshots inside the chosen frames. An interactive prompt lets users search and pick multiple frames, while a non‑interactive `--frame` flag enables specifying devices directly on the command line.

The program supports a wide range of devices, currently offering 52 unique models including 166 phone and color variations, several tablets, computers, monitors, and watches. When a URL is provided, deviceframe loads the page using the aspect ratio and pixel density of the selected device, allowing accurate visual representation of how a site appears on different hardware.

Deviceframe is distributed via npm, works on stable releases, and stores cached frame images using the env‑paths convention. It is intended for developers who need to generate framed screenshots for documentation, marketing, or testing purposes.