usethis

Overview

About

Maintained by Jennifer BryanFirst published 2017-10-2225 releasesCRAN page ↗GitHub ↗

Automate package and project setup tasks that are otherwise performed manually. This includes setting up unit testing, test coverage, continuous integration, Git, 'GitHub', licenses, 'Rcpp', 'RStudio' projects, and more.

Install

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

install.packages("usethis", 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/usethis")

Development version from r-lib/usethis. 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-usethis

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-usethis

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

Health

CRAN checks

13OK

Slowest check: 6.6 min · r-release-windows-x86_64

Code health

Yes

Tests · ratio 0.52

52.5%

Coverage · measured lines

100%

Documentation · exports

22

Dependencies · direct

Check history

OK2026-06-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-07
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

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

Examples that run: 18%
Documented parameters: 93%
Return-value docs: 24%
References docs: 0%

Downloads

2.7M

CRAN downloads in the past year

Rank #225 · ~7.3K/day · ~222.2K/mo

Releases R versions

Daily download trend is not available in this view yet.

215.7K30 days

692K90 days

2.7M1 year

Compare downloads with other packages →

Also on93.5K r2u140 autocran214.7K conda_forge2.3K c2d4u

Repository

GitHub ↗ r-lib/usethis

919Stars

308Forks

64Open issues

26Open PRs

25Releases

3,001Commits

178Contributors

rsetuppackagegithubrstats

3,001 commits · Last activity 2026-07-14 · +0.1% stars, 30d

Stars over time

2025-07-16 · 8722026-07-11 · 919

Repository practices

Upstream repositoryBeta

12 development-tooling and community-health practices detected across 6 families in the upstream repository

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

Continuous integration (1)

GitHub Actions

CRAN release process (2)

cran-comments.mdrevdep/

Docs source (1)

README.Rmd

Lint, format, editor (3)

AirVS CodeRStudio project

Show all practices

Coverage (2)

Codecov.covrignore

Governance and community (3)

Issue templatesCODEOWNERSSupport guide

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

Dependencies

Declared dependencies

28 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.1

Imports (22)

cli clipr crayon curl desc fs gert gh glue jsonlite lifecycle purrr rappdirs rlang rprojroot rstudioapistatstoolsutilswhisker withr yaml

LinkingTo (0)

none

Suggests (9)

covr knitr magick pkgload quarto rmarkdown roxygen2 spelling testthat (>= 3.1.8)

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

289direct

89indirect

and 241 more packages.

People & History

People (5)

Maintainer (1)

Jennifer Bryan

Author, Maintainer · added in 1.2.0

Authors (4)

Jennifer Bryan

Author, Maintainer · added in 1.2.0

Malcolm Barrett

Author · added in 2.1.0

Andy Teucher

Author · added in 2.2.0

Hadley Wickham

Author

Copyright holders (1)

Posit Software, PBC

Copyright holder, Funder · added in 2.2.0

Funders (1)

Posit Software, PBC

Copyright holder, Funder · added in 2.2.0

Listed in earlier versions (1)

RStudio

no longer listed · 1.0.0 to 2.1.6

Package Timeline

25 releases. Pick two to compare their code metrics. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
3.2.1Latest
2025-09-06 · current release · diff ↗
3.2.0
2025-08-28 · diff ↗
R
R 4.5.0 released · 2025-04-11
3.1.0
2024-11-26 · diff ↗
3.0.0
2024-07-29 · diff ↗
R
R 4.4.0 released · 2024-04-24
2.2.3
2024-02-19 · diff ↗
2.2.2
2023-07-06 · diff ↗
2.2.1
2023-06-24 · diff ↗
2.2.0
2023-06-06 · diff ↗
R
R 4.3.0 released · 2023-04-21
2.1.6
2022-05-25 · diff ↗
R
R 4.2.0 released · 2022-04-22
2.1.5
2021-12-10 · diff ↗
2.1.3
2021-10-27 · diff ↗

Show 19 earlier events

2.1.2
2021-10-25 · diff ↗
2.1.0
2021-10-17 · diff ↗
R
R 4.1.0 released · 2021-05-18
2.0.1
2021-02-10 · diff ↗
2.0.0
2020-12-10 · diff ↗
1.6.3
2020-09-17 · diff ↗
1.6.1
2020-04-29 · diff ↗
R
R 4.0.0 released · 2020-04-24
1.6.0
2020-04-09 · diff ↗
1.5.1
2019-07-04 · diff ↗
R
R 3.6.0 released · 2019-04-26
1.5.0
2019-04-07 · diff ↗
1.4.0
2018-08-14 · diff ↗
R
R 3.5.0 released · 2018-04-23
1.3.0
2018-02-24 · diff ↗
1.2.0
2018-01-19 · diff ↗
1.1.0
2017-11-17 · diff ↗
1.0.0
2017-10-22
R
R 3.4.0 released · 2017-04-21

Package metadata

First published: 2017-10-22
Total releases: 25 / 9 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 4.1
Download size: 385 KB
Installed size: not tracked yet
With dependencies: not tracked yet

Appears in task views

Reproducible Research