Folder contract
Suite format
Lay out scenes, outputs and renderers, and describe them in fidelity.json.
results/fidelity.jsonRead more →Renderer fidelity · TypeScript · Open source
Your renderer writes images to a folder. fidelity-kit measures each one against your references, draws the difference, and serves a viewer to browse the results.

Write images into a results folder
PSNR and a delta image per renderer
Side-by-side viewer with live reload
Static site or Docker container
Skip the custom tooling
Every renderer is compared with a reference, with a PSNR score and a heatmap of where the images differ. Sort scenes by worst score to find regressions first.
# While you develop: process, watch and view
npx fidelity-kit dev results
# In CI: process and export a static site
npx fidelity-kit build results --out site/Beyond still frames
Temporal techniques such as TAA, upscaling and denoisers cannot be judged from one frame. Temporal fidelity scores an animated sequence for ghosting, flicker and slow convergence, and benchmarks track performance next to quality.
Read about temporal fidelity →{
"id": "spinning-fan",
"temporalFidelity": {
"width": 640,
"height": 360,
"frames": 150,
"warmup": 30,
"fps": 60
}
}Go deeper
Start from the folder format, drive it from the CLI, or call the same code from TypeScript.
Folder contract
Lay out scenes, outputs and renderers, and describe them in fidelity.json.
results/fidelity.jsonRead more →Command line
process, dev, serve and build, with every option generated from the command definitions.
npx fidelity-kit dev resultsRead more →TypeScript
Scan suites, compute comparisons and build file paths from your own code.
import { scanSuite } from "fidelity-kit/scan"Read more →Sharing
Export a self-contained site for any static host, or serve a processed suite from Docker.
fidelity-kit build results --out site/Read more →Try it on your renders
pnpm add -D fidelity-kit