vdiffr

Overview

About

Maintained by Thomas Lin PedersenFirst published 2016-11-0820 releasesCRAN page ↗GitHub ↗

An extension to the 'testthat' package that makes it easy to add graphical unit tests. It provides a Shiny application to manage the test cases.

Install

R (CRAN)pak (dev)Ubuntu (r2u)openSUSE (OBS)

install.packages("vdiffr", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("r-lib/vdiffr")

Development version from r-lib/vdiffr. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-vdiffr

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-vdiffr

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 2.0 min · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 3.15

50.2%

Coverage · measured lines

100%

Documentation · exports

8

Dependencies · direct

Check history

OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 529 wordsVignettesNopkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 100%
Documented parameters: 92%
Return-value docs: 0%
References docs: 0%

Downloads

964.4K

CRAN downloads in the past year

Rank #360 · ~2.6K/day · ~80.4K/mo

Releases R versions

Daily download trend is not available in this view yet.

84.4K30 days

283.1K90 days

964.4K1 year

Compare downloads with other packages →

Also on3.5K r2u36 autocran8.6K conda_forge

Repository

GitHub ↗ r-lib/vdiffr

198Stars

38Forks

11Open issues

2Open PRs

19Releases

422Commits

23Contributors

testthatggplot2graphics

422 commits · Last activity 2026-02-13 · +0.5% stars, 30d

Stars over time

2025-07-14 · 1912026-07-11 · 198

Repository practices

Upstream repositoryBeta

5 development-tooling and community-health practices detected across 4 families in the upstream repository

Checks run against github.com/r-lib/vdiffr on 2026-07-19.

Continuous integration (1)

GitHub Actions

CRAN release process (2)

cran-comments.mdrevdep/

Lint, format, editor (1)

RStudio project

Coverage (1)

Codecov

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

13 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.0

Imports (8)

diffobj gluegrDeviceshtmltools lifecycle rlang testthat xml2

LinkingTo (1)

cpp11

Suggests (5)

covr decor ggplot2 roxygen2 withr

Enhances (0)

none

Dependency license breakdown →

People & History

People (10)

Maintainer (1)

Thomas Lin Pedersen

Maintainer, Author · added in 1.0.0

Authors (5)

Thomas Lin Pedersen

Maintainer, Author · added in 1.0.0

Matthieu Decorde

Author · added in 0.3.0

Lionel Henry

Author

Vaudor Lise

Author · added in 0.3.0

T Jake Luciani

Author · added in 0.3.0

Contributors (4)

David Gohel

Contributor · added in 0.3.0

Håkon Malmedal

Contributor · added in 0.3.0

Tony Plate

Contributor · added in 0.3.0

Yixuan Qiu

Contributor · added in 0.3.0

Copyright holders (1)

Posit Software, PBC

Copyright holder, Funder · added in 1.0.6

Funders (1)

Posit Software, PBC

Copyright holder, Funder · added in 1.0.6

Listed in earlier versions (6)

Humble Software