lifecycle
lifecycle gave the tidyverse the word superseded, then spent years tuning who gets warned
Comparison · Infra & APIs
roxygen2 vs usethis
A side-by-side editorial comparison of roxygen2 and usethis — release velocity, themes, recent moves, and the top alternatives to consider.
roxygen2 vs usethis: at a glance
What is roxygen2?
roxygen2 8.0 cut stringi out of the entire devtools dependency tree.
roxygen2 turns inline comments into R documentation and NAMESPACE files. The 8.0.0 release was as much about dependencies as features: dropping purrr, stringr and stringi means nothing in the devtools constellation pulls in stringi, long a persistent install obstacle on constrained Linux systems. 8.1.0 follows with markdown correctness work and cached link resolution.
What is usethis?
usethis swaps in the Air formatter and stops assuming RStudio is the editor
usethis is the tidyverse's project-scaffolding tool and, unlike much of the r-lib cohort, is still actively developed. Recent work moves it off its own assumptions: the cli package replaced its homegrown UI layer in 3.0.0, and 3.2.0 replaced tidy-style formatting with Air while widening what counts as a project root.
roxygen2 vs usethis: editorial side-by-side
roxygen2
2.5INFRA · APIS
roxygen2 8.0 cut stringi out of the entire devtools dependency tree.
◆ Current state
roxygen2 turns inline comments into R documentation and NAMESPACE files. The 8.0.0 release was as much about dependencies as features: dropping purrr, stringr and stringi means nothing in the devtools constellation pulls in stringi, long a persistent install obstacle on constrained Linux systems. 8.1.0 follows with markdown correctness work and cached link resolution.
◆ Where it's heading
The package is investing in the documentation toolchain beneath it — a new rdtools package supplies cached indexes so link targets and inherited Rd topics resolve without repeated help() lookups. Running alongside is steady correction of markdown handling, where multibyte characters inside Rd tags had been corrupting everything that followed.
◆ Prediction
Expect more Rd processing to migrate into rdtools, and further link-resolution changes now that all generated links share a single code path.
usethis
0.0INFRA · APIS
usethis swaps in the Air formatter and stops assuming RStudio is the editor
◆ Current state
usethis is the tidyverse's project-scaffolding tool and, unlike much of the r-lib cohort, is still actively developed. Recent work moves it off its own assumptions: the cli package replaced its homegrown UI layer in 3.0.0, and 3.2.0 replaced tidy-style formatting with Air while widening what counts as a project root.
◆ Where it's heading
The direction is de-RStudio-ing. Project detection now recognizes a VS Code settings file, a Quarto config, or an renv lockfile; use_course() opens folders in Positron as readily as RStudio; Quarto is a first-class vignette and project format. usethis is being rebuilt around the editor and format plurality that has grown up around R, and the pre-3.0 RStudio-and-styler era is being deprecated out.
◆ Prediction
Expect Quarto and Positron support to keep filling in - create_quarto_project() is still flagged experimental - and further deprecation of the RStudio-specific and styler-era helpers.
Alternatives to roxygen2 and usethis
Other Infra & APIs products tracked by Sparkpulse, ranked by recent ship velocity. Each card links to a full editorial trajectory and lets you pivot into a head-to-head comparison with either roxygen2 or usethis.
waldo
waldo keeps shedding dependencies while teaching its diff engine new object systems
pkgdown
pkgdown now generates llms.txt and a markdown copy of every documentation page
knitr
knitr adds OpenTelemetry tracing, turning document builds into observable pipelines
lintr
lintr makes the native pipe the default rule and clears out a decade of deprecations
covr
covr's coverage tooling has been stable to the point of dormancy since 2022
See all roxygen2 alternatives → · See all usethis alternatives →
Recent activity from roxygen2 and usethis
Latest ship moves from both products, interleaved chronologically. ⚡ = editorial spark.
- 8d agoroxygen2roxygen2 8.1.0 resolves links via cached rdtools indexes
- 3mo agoroxygen2roxygen2 8.0.0 drops stringi from the devtools dependency chain ⚡
- 11mo agousethiscreate_quarto_project() exits early without the Quarto CLI
- 11mo agoroxygen2roxygen2 7.3.3 auto-resolves markdown links to external topics
- 11mo agousethisuse_air() adopts the Air formatter; project detection widens ⚡
- 1y agousethisuse_vignette() and use_article() support Quarto
- 2y agousethisUI moves to cli; Travis and AppVeyor helpers removed
- 2y agoroxygen2roxygen2 7.3.2 disables cli hyperlinks in included Rmd
- 2y agousethisCRAN-requested documentation fixes
- 2y agoroxygen2roxygen2 7.3.1 fixes @importFrom for quoted non-syntactic names
- 2y agoroxygen2roxygen2 7.3.0 reports S3 methods missing @export
- 3y agousethisVersion comparisons always pass character input
Frequently asked questions
What is the difference between roxygen2 and usethis?
They serve adjacent needs but don't currently overlap on shipped themes. roxygen2 is currently shipping more aggressively (velocity 2.5 vs 0.0), with 0 editorial sparks in the last 30 days against 0. See the at-a-glance table above for a side-by-side breakdown of velocity, recent sparks, and editorial themes.
Is roxygen2 better than usethis?
Sparkpulse doesn't pick a winner — we score release velocity, not feature parity. roxygen2 is currently shipping more aggressively (velocity 2.5 vs 0.0), with 0 editorial sparks in the last 30 days against 0. For your specific use case, the alternatives sections above list other Infra & APIs products to evaluate alongside.
What are the best alternatives to roxygen2?
Top roxygen2 alternatives in Infra & APIs are ranked by recent ship velocity. Browse the "roxygen2 alternatives" section above for the current picks, or visit /alternatives/roxygen2 for the full list with editorial commentary on each.
What are the best alternatives to usethis?
Top usethis alternatives in Infra & APIs are ranked by recent ship velocity. Browse the "usethis alternatives" section above for the current picks, or visit /alternatives/usethis for the full list with editorial commentary on each.