Use rrepo

Getting started

A home for your R package releases, from publishing to installation.

rrepo hosts R package repositories for package authors and teams. Publish your packages in one place and let people install them with their usual package manager. Use a public repository to share your work with anyone, or a private repository for packages used within your team.

How packages are organized

An organization owns your repositories and groups the people who manage them. A repository is a collection of packages with its own address and public or private visibility. It can hold a single package or a team's shared collection.

A package is identified by its R package name. Each release has a version from its DESCRIPTION file and a built source archive. Publishing a new version makes that release available through the repository.

For example, rrepo/hello-world is the hello-world repository in the rrepo organization. It contains the hello.world package.

From development to installation

When a package is ready to share, build a source archive and publish it to rrepo. You can upload it manually or publish automatically from CI when you tag a release.

Users add your repository to their package manager and install packages by name. Publish updates under a new version so users can choose when to upgrade.

Install a package

Try the public hello.world package. In an existing rpx project, add its repository and install it:

sh
rpx repo add https://rrepo.dev/rrepo/hello-world
rpx add hello.world

Then run this in the project's R environment:

r
hello.world::hello_world()
#> [1] "Hello, world!"

No rrepo account or API key is needed for this example. For R, rv, and renv commands, see Install packages.