13  Package publishing rules

13.1 Avoid name collisions

While it is technically possible to host a fork or a completely different package with the same name in a universe, this practice is strongly discouraged.

  • Users might accidentally install the example package from CRAN instead of the intended version from a universe.
  • R will overwrite one package with the other when running install.packages() or update.packages().
  • This issue becomes more problematic when other packages depend on the conflicting package.

To address this, R-universe:
- Treats the CRAN version as the official package.
- Warns users about the duplication on the page of the conflicting package.

13.2 Reserved names

Avoid using the following names for packages, as they have special meanings in R-universe URLs (https://username.r-universe.dev/{pkg}/):

  • api
  • apis
  • articles
  • badges
  • bin
  • builds
  • citation
  • contributors
  • datasets
  • docs
  • favicon.ico
  • feed.xml
  • index.xml
  • manual
  • packages
  • readme
  • robots.txt
  • sitemap_index.xml
  • sitemap.xml
  • src
  • stats

13.3 Code of Conduct

Universe maintainers are solely responsible for the projects in their universes.

The R-universe project itself is governed by the rOpenSci code of conduct.