R Observatory: Metrics for icons version 1.0.0

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

icons

1.0.0Package record

Easily Insert SVG Icons into R Outputs

1packages depend

766downloads / year

29.6%test coverage

13/13flavors OK

Overview

About

Maintained by Mitchell O'Hara-WildCRAN page ↗GitHub ↗Website ↗Issues ↗

Provides tools to download, style, and insert scalable vector graphics (SVG) icons into R output, such as 'R Markdown' and 'Quarto' documents, 'Shiny' apps, 'gt' tables, and 'ggplot2' visualisations via the 'ggicons' package. Bundles popular icon libraries, such as 'Font Awesome' (https://fontawesome.com), 'Academicons' (https://jpswalsh.github.io/academicons/), and 'Material Design Icons' (https://fonts.google.com/icons), which are downloaded on demand to keep the package small, or build a custom icon set from any folder of local SVG files. Icon appearance, such as size, colour, and position, can be customised.

Changes in 1.0.0

New icon sets

Added the health_icons() icon set (https://healthicons.org/).
Added the super_tiny_icons() icon set (https://github.com/edent/SuperTinyIcons).

New features

Added icon_uri(), which encodes icons as self-contained base64 data strings. This makes it easier to use icons in other contexts, such as gt tables and as leaflet markers.
Added icon vectors, to make it easier to use icons in data-oriented workflows (e.g. in tables, graphics, maps, ...)
Added icon_path(), giving the file path(s) of an icon's source SVG - handy for using icons with ggplot2 and other packages that plot from image files.
Added icon_label(), for identifying an icon by its library accessor label (for example "fontawesome$solid$rocket").

Show all changes in 1.0.0Hide the rest of the changes in 1.0.0

Added a "Using icons" vignette covering installation, insertion, styling, custom icon sets and Shiny usage.

Breaking changes

Icons are now fully vectorised. Accessing a single icon (e.g. fontawesome$solid$rocket) no longer returns a scalar icon that outputs raw SVG directly - it returns a length-1 icons vector, the same type returned by icon_find() and other multi-icon results. Code that reached into a result as a raw htmltools tag, or called format() expecting SVG markup, should use htmltools::as.tags() first.

Improvements

Each icon set's documentation now includes a "License" section describing the license its icons are distributed under, with a link to the source (#15).
Messages, warnings and errors are now consistently produced with the cli package, and include more helpful hints (crayon is no longer used).
Icon set functions now suggest similarly named icons when a requested icon can't be found (#67).
icons vectors now have an as.character() method that returns their labels.
Improved embedding of icons in other output formats.
Improved the base icon style used for inline icon positioning.
Downloading google_material() icons is now faster, using a git sparse checkout to fetch only the required SVG files (#70).
The package's startup message is now suppressed in development sessions (e.g. devtools::load_all()).

Bug fixes

Icons now work as expected in titles (#7).
Icons now work alongside emojis (#25).
Fixed icon_find() when searching custom icon sets (#38).
Fixed the download URL for octicons() (thanks @bbest, #58).

From NEWS.md in the release

Install

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

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

Development version from mitchelloharawild/icons. 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-icons

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled. We list this channel from recorded r2u download activity rather than from a live index of the repository, so treat it as last known rather than guaranteed.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-icons

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# 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-icons

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed). We list this channel from recorded autoCRAN download activity rather than from a live index of the repository, so treat it as last known rather than guaranteed.

Health

CRAN checks

13OK

CRAN check page ↗

Slowest check: 1.4 min · r-devel-windows-x86_64

Status changes

OK13 OKNow
OK7 OK2026-09-04

Advisories

none known

How this is measured·How advisories are found

Documentation

In release 1.0.0

READMEYes · 332 wordsVignettesYes · 1 · dynamicNEWSYes · 100% structured · mentions 1.0.0Citation fileNoWebsiteYes · pkgdown

Help pages: 20 (1 internal)includes a package overview page
Examples that run: 100%9 run in a plain check
Exported functions with examples: 47%
Documented parameters: 97%
Return-value docs: 100%
Help pages citing references: 0%

Vignettes (1)

Using icons HTML

How these are measured

Downloads

766

CRAN downloads in the past year

Rank #16,081 · ~2/day · ~64/mo

Releases R versions

Daily download trend is not available in this view yet.

46530 days

76690 days

7661 year

Compare downloads with other packages →

Also on11 r2u2 autocran

How downloads are counted

Repository

mitchelloharawild/icons ↗Account: mitchelloharawild

315Stars

43Forks

3Open issues

0Open PRs

3Releases

318Commits

10Commit identities

ozunconf17runconffontawesomeweb-iconsicon-library

318 commits · Last activity 2026-09-03 · Default branch at 1.0.0.9000, ahead of CRAN 1.0.0 (checked 2026-10-18)

Responsiveness

How these are sampled

PRs merged (all time): 92%
Median days to close, 50 most recently updated closed issues: 105
Median days to close, 50 most recently updated closed PRs: 0

Commits over time

2026-09-06 · 3182026-09-15 · 318

How these are measured

PracticesBeta

8 development-tooling and community-health practices detected across 4 families in the upstream repository

Checks run against github.com/mitchelloharawild/icons on 2026-10-18.

Continuous integration (2)

GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux

Docs source (4)

README.Rmdpkgdown

GitHub Pages site last deployed 2026-09-03 · The repository has a site deploy workflow

pkgdown site last built 2026-09-03

CRAN release process (1)

cran-comments.md

Lint, format, editor (1)

RStudio project

How this is detected·Detection ruleset v3 (2026-09-26)

Dependencies

Declared dependencies

17 external dependencies (excludes base and recommended)

Installing icons adds 20 packages (15 with compiled code, 16 MB of source tarballs). Heaviest: stringi 11 MB, jsonlite 1.0 MB, vctrs 1.0 MB.

Depends (1)

R >= 3.1.3

Imports (12)

base64enc knitr rlang htmltools glue rappdirs xml2 stringr jsonlite cliutilsvctrs

LinkingTo (0)

none

Suggests (6)

rsvg gh rmarkdown pillar shiny testthat

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

1direct

0indirect

Imports 1

Depends, Imports or LinkingTo, most downloaded first

ggicons

How these are counted

Code & Tests

People & History

People (5)

Mitchell O'Hara-Wild

Author, Maintainer since 1.0.0 (2026)

Contributor

Contributor

Contributor

Contributor

Releases (1)

1.0.0Latest
record
2026-09-03 · current release
R
R 4.6.0 released · 2026-04-24

Package metadata

First published: 2026-09-03
Total releases: 1 / 1 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 3.1.3
Download size: 73 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("icons")

Format

O'Hara-Wild, M., Hyndman, T., Jemmett, T., Wang, E., & Warkentin, M. (2026). icons: Easily Insert SVG Icons into R Outputs (Version 1.0.0) [Computer software]. https://doi.org/10.32614/CRAN.package.icons

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

Format

APA

Balamuta, J. J. (2026). R Observatory: Metrics for icons version 1.0.0 [Data set]. HJJB, LLC. Data release v2026-10-20. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-20, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →