Slices

Screenshots

Styled screenshots of web pages, as an image URL, on Chirio.

The screenshots slice films web pages on Chirio and hands you a PNG: the bare page, or the page inside a 3D mockup with browser chrome. It is an add-on by Dopler. No surface requires it, so it is asked for by name:

Bash

node scripts/scaffold.mjs --surfaces landing --slices screenshots --out ../my-app

It adds no dependency. The server calls Chirio over global fetch.

In a page

/api/screenshot serves the image, so a screenshot is just an image URL:

Tsx

<Media
  src={`/api/screenshot?url=${encodeURIComponent("https://your-app.com/pricing")}&theme=dark&chrome=dark`}
  alt="The pricing page"
  aspectRatio="16/9"
/>

Query parameters: url (required), theme (light or dark), chrome (none, light or dark) and style (a mockup style id from Chirio's gallery). The image is cached for a day at the edge, so a page is paid for once a day at most, not once per visitor. The route films only the app's own host (from baseURL) and the hosts in SCREENSHOT_ALLOWED_HOSTS (comma-separated). Anything else answers 403, so a visitor cannot spend your plan on other sites. A page Chirio has never filmed can take a minute; until then the route answers 202 with retry-after.

In server code

import { screenshot } from "@/lib/screenshots/chirio";

const shot = await screenshot("https://your-app.com", { theme: "light", chrome: "none" });
if (shot.status === "done") console.log(shot.imageUrl); // signed, valid about an hour

Setup

Sign in at chirio.dev and create an API key under Settings → API keys.
Set CHIRIO_API_KEY. The same key serves the feedback and publish slices.
Optional: SCREENSHOT_ALLOWED_HOSTS=docs.your-app.com,partner.com.

Without the key the route answers 404 and nothing else changes.

Cost

A finished screenshot is 3 units on your Chirio plan; a failed one costs nothing and polling is free. When the plan runs out Chirio answers quota_exceeded and the route passes on a 429 with Chirio's message, which names what is left and how to upgrade.

Last updated November 1, 2026

Edit this page on GitHub