← Back to home
Comparison · Infra & APIs

pkgdown vs usethis

A side-by-side editorial comparison of pkgdown and usethis — release velocity, themes, recent moves, and the top alternatives to consider.

Shared themes:quarto

pkgdown vs usethis: at a glance

Featurepkgdownusethis
SectorInfra & APIsInfra & APIs
Velocity score0.00.0
Sparks · 30d00
Top themesdocumentation, llm-readable, quarto, dark-modedeveloper-tooling, quarto, positron, formatting
Last editorial update1h ago1h ago
WebsiteVisit →Visit →

What is pkgdown?

pkgdown now generates llms.txt and a markdown copy of every documentation page

pkgdown builds the documentation sites for most R packages. The 2.1 line was about format and appearance - Quarto vignettes, a light and dark switch, self-hosted assets instead of CDN fetches. The 2.2 line changed audience: build_llm_docs() emits an llms.txt at the site root and a markdown version of every page, on by default.

Read the full pkgdown trajectory →

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.

Read the full usethis trajectory →

pkgdown vs usethis: editorial side-by-side

P
pkgdown
INFRA · APIS
0.0

pkgdown now generates llms.txt and a markdown copy of every documentation page

◆ Current state

pkgdown builds the documentation sites for most R packages. The 2.1 line was about format and appearance - Quarto vignettes, a light and dark switch, self-hosted assets instead of CDN fetches. The 2.2 line changed audience: build_llm_docs() emits an llms.txt at the site root and a markdown version of every page, on by default.

◆ Where it's heading

Two audiences are now being served from one build. Human-facing work continues in small increments - dark-mode plot filtering, new translations, a local http server so search works in preview - while the new machine-facing output is opt-out rather than opt-in. The default matters more than the feature: thousands of package sites will start emitting llms.txt without their maintainers choosing to.

◆ Prediction

Expect the markdown output to gain the same configuration surface the HTML has, and the llms.txt contents to get more selective as maintainers discover what ends up in it; a way to exclude individual pages is the obvious next request.

U
usethis
INFRA · APIS
0.0

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 pkgdown 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 pkgdown or usethis.

See all pkgdown alternatives → · See all usethis alternatives →

Recent activity from pkgdown and usethis

Latest ship moves from both products, interleaved chronologically. ⚡ = editorial spark.

  1. 1mo agopkgdownLocal preview served over http so search works
  2. 9mo agopkgdownbuild_llm_docs() emits llms.txt and markdown for every page
  3. 11mo agousethiscreate_quarto_project() exits early without the Quarto CLI
  4. 11mo agousethisuse_air() adopts the Air formatter; project detection widens
  5. 1y agopkgdownMenu items accept class and id attributes
  6. 1y agopkgdownROR IDs, Codeberg support, bslib navbar variables
  7. 1y agousethisuse_vignette() and use_article() support Quarto
  8. 1y agopkgdownKeyboard shortcut for search; clean_cache() added
  9. 2y agousethisUI moves to cli; Travis and AppVeyor helpers removed
  10. 2y agopkgdownQuarto vignettes, light/dark switch, self-hosted assets
  11. 2y agousethisCRAN-requested documentation fixes
  12. 3y agousethisVersion comparisons always pass character input

Frequently asked questions

What is the difference between pkgdown and usethis?

Both compete on the same themes — quarto — within Infra & APIs. pkgdown and usethis are shipping at a similar cadence (velocity 0.0 vs 0.0, both within Sparkpulse's "active" band). See the at-a-glance table above for a side-by-side breakdown of velocity, recent sparks, and editorial themes.

Is pkgdown better than usethis?

Sparkpulse doesn't pick a winner — we score release velocity, not feature parity. pkgdown and usethis are shipping at a similar cadence (velocity 0.0 vs 0.0, both within Sparkpulse's "active" band). For your specific use case, the alternatives sections above list other Infra & APIs products to evaluate alongside.

What are the best alternatives to pkgdown?

Top pkgdown alternatives in Infra & APIs are ranked by recent ship velocity. Browse the "pkgdown alternatives" section above for the current picks, or visit /alternatives/pkgdown 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.