Skip to content

cardargus

0.2.5Package record

Generate SVG Information Cards with Embedded Fonts and Badges

0packages depend
2.4Kdownloads / year
24.2%test coverage
13/13flavors OK

Overview

About

Create self-contained SVG information cards with embedded 'Google Fonts', shields-style badges, and custom logos. Cards are fully portable SVG files ideal for dashboards, reports, and web applications. Includes functions to export cards to PNG and PDF formats and display them in 'R Markdown' and 'Quarto' documents.

Changes in 0.2.5

New features

  • svg_to_pdf() exports a card to a **vector** PDF via rsvg::rsvg_pdf(), mirroring svg_to_png() (sanitizes the SVG and embeds WOFF2 fonts). For Chrome-based rendering, svg_to_pdf_chrome() remains available (#17).
  • save_card_for_knitr() now accepts format = "pdf" (in addition to "svg" and "png"), using Chrome when available and svg_to_pdf() otherwise.

Chrome rendering: more robust, faster, higher quality

The Chrome-based conversion pipeline (svg_to_png_chrome(),

svg_to_pdf_chrome(), batch_svg_to_*_chrome()) was reworked:

  • **Deterministic readiness wait.** Conversions no longer rely on a fixed Sys.sleep(): the page load event and document.fonts.ready are awaited, so screenshots/PDFs are never captured before web fonts finish rendering, and no time is wasted over-waiting. The load_wait argument now means an *extra* wait after readiness and defaults to 0; a new timeout argument (default 10s) bounds the readiness wait.
Show all changes in 0.2.5Hide the rest of the changes in 0.2.5
  • **Persistent Chrome session.** A single health-checked session is reused across calls (and replaced transparently if it dies), removing the ~1-2s session startup previously paid on every conversion. The session is closed when the package is unloaded.
  • **No temp files.** Pages are loaded via data: URLs instead of temporary HTML files and file:// navigation (a temp file is used only for very large documents), avoiding path/permission issues on Windows.
  • **Real alpha transparency.** With background = "transparent", svg_to_png_chrome() now produces a PNG with a true alpha channel (previously the backdrop was flattened).

Minor improvements

  • svg_to_formats(formats = "pdf") now reuses svg_to_pdf() for the vector path and warns explicitly when it falls back to a rasterized PDF via magick.

Bug fixes

  • magick and rsvg moved from Imports to Suggests: they are only needed for raster/PDF export, which is already guarded by requireNamespace(). This lightens the install footprint and matches the package's "heavy deps in Suggests" convention (#19).
  • svg_card() now sizes badges using value_fontsize instead of a hard-coded 10, preventing clipped/misaligned badge text when value_fontsize differs from 10 (#18).
  • is_light_color() now reports an unknown color name with a clear cli error instead of letting col2rgb() raise a raw base error (#20).
  • .onLoad() no longer tries to download the Jost font from Google Fonts when it is not installed on the system. Network access at load time is against CRAN policy and produced a non-suppressible startup message on machines without the font (the cause of the spurious WARNINGs on the CRAN r-oldrel-macos-arm64 checks for 0.2.4). Fonts are registered on demand when a card is rendered, as before.
  • The GitHub stars badge in the README now links to the repository root: the /stargazers page answers 404 to the HEAD requests CRAN's URL checker uses.

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 6.1 min · r-release-macos-x86_64
Status changes
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-07-28
  • WARNING12 OK, 2 WARNING2026-03-10
Advisories

none known

Documentation

In release 0.2.5
READMEYes · 298 wordsVignettesYes · 6 · dynamicNEWSYes · 100% structured · mentions 0.2.5Citation fileNoWebsiteYes · pkgdown
Help pages
84 (42 internal)includes a package overview page
Examples that run
88%21 run in a plain check (2 of them under a condition) · 1 only when donttest examples are enabled (R CMD check --as-cran) · 2 never run
Exported functions with examples
57%
Documented parameters
99%
Return-value docs
100%
Help pages citing references
0%

Downloads

2.4K
CRAN downloads in the past year
Rank #13,094 · ~7/day · ~201/mo
Daily download trend is not available in this view yet.
30130 days
87890 days
2.4K1 year
Compare downloads with other packages →
Also on94 r2u11 autocran

Repository

1Stars
0Forks
0Open issues
0Open PRs
2Releases
38Commits
1Commit identities
38 commits · Last activity 2026-09-29 · 0% stars, 30d
Responsiveness
How these are sampled
PRs merged (all time)
100%
Median days to close, 50 most recently updated closed issues
15
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2026-06-15 · 12026-07-07 · 1
PracticesBeta

9 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/strategicprojects/cardargus on 2026-10-22.

Continuous integration (1)
GitHub Actions
Docs source (4)
README.Rmdpkgdown

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

pkgdown site last built 2026-09-29

CRAN release process (2)
cran-comments.mdCRAN-SUBMISSION
Lint, format, editor (1)
RStudio project
Show all practicesHide 1 practice
Git structural (1)
.gitattributes
How this is detected·Detection ruleset v4 (2026-10-20)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2026-06-13
    Named in .Rbuildignore: .claude, CLAUDE.md
    Named in .gitignore: .claude, CLAUDE.md
    Commits: at least 23 crediting it in the message
From outside contributors
  • Claude Code
    Pull requests: 8 from outside contributors, first on 2026-06-14
Models named in its commits
  • Claude Opus 4.816 commits · Jun 2026
  • Claude Fable 54 commits · Jul 2026
  • Claude Opus 5.53 commits · Sep 2026
Counts are commits, not lines of code. Commits by a tool's accounts count once across all of its accounts. Commits crediting it are the largest count among its credit lines, a minimum.How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
19 external dependencies (excludes base and recommended)

Installing cardargus adds 17 packages (12 with compiled code, 13 MB of source tarballs). Heaviest: fontLiberation 4.3 MB, fontquiver 2.1 MB, Rcpp 1.8 MB.

Depends (0)
none
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

People & History

People (5)
Author, Maintainer since 0.2.0 (2026)
Author · added in 0.2.5
Author · added in 0.2.5
Releases (6)

Pick two releases to compare their code metrics.

  • 0.2.5Latest
    record
    2026-07-27 · current release · diff ↗ ·
    added 1 export
    svg_to_pdf
  • 0.2.4
    record
    2026-06-14 · diff ↗
  • 0.2.3
    record
    2026-06-14 · diff ↗
  • R
    R 4.6.0 released · 2026-04-24
  • unarchivedReturned to CRAN
    2026-03-01
  • 0.2.2
    record
    2026-03-01 · diff ↗ ·
    added 2 exports
    batch_svg_to_base64_chrome, batch_svg_to_png_chrome
  • archivedRemoved from CRAN
    2026-02-12
    repeated policy violation Even on re-submission after notification
  • 0.2.1
    record
    2026-02-05 · diff ↗ ·
    removed 11 exports
    badge_row_svg, badge_svg, building_icon_svg, cardargus_font_cache_dir, construction_icon_svg, house_icon_svg, install_cardargus_fonts, map_pin_icon_svg, money_icon_svg, register_knitr_engine, setup_cardargus_fonts
  • 0.2.0
    record
    2026-01-31
  • R
    R 4.5.0 released · 2025-04-11

Package metadata

First published
2026-01-31
Total releases
6 / 1 yrs
License
MIT + file LICENSE OSI
Download size
1.0 MB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("cardargus")
Leite, A., Amorim, C., Bezerra, D., Vasconcelos, H., & Wasiliew, M. (2026). cardargus: Generate SVG Information Cards with Embedded Fonts and Badges (Version 0.2.5) [Computer software]. https://doi.org/10.32614/CRAN.package.cardargus

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.

APA

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

From data release v2026-10-25, 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 →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy