Skip to content

bslib

0.12.0Package record

Custom 'Bootstrap' 'Sass' Themes for 'shiny' and 'rmarkdown'

138packages dependsuggested by 132
15.9Mdownloads / year
68.0%test coverage
8/13flavors OK

Overview

About

Simplifies custom 'CSS' styling of both 'shiny' and 'rmarkdown' via 'Bootstrap' 'Sass'. Supports 'Bootstrap' 3, 4 and 5 as well as their various 'Bootswatch' themes. An interactive widget is also provided for previewing themes in real time.

Changes in 0.12.0

New features

  • Added offcanvas() to create Bootstrap offcanvas panels that slide in from an edge of the viewport. Panels can be revealed by a trigger element in the UI or controlled from the server with show_offcanvas(), hide_offcanvas(), and toggle_offcanvas(). (#1328)

Documentation

  • layout_columns() and layout_column_wrap() now describe their CSS length inputs with concrete examples. (@LeonidasZhak #1300)

Bug fixes

  • Fixed dynamically-rendered outputs (e.g. uiOutput()) failing to render inside a title-less popover() or tooltip(), caused by an upstream Shiny change. A temporary CSS workaround restores rendering. (#1326)
  • Fixed label-to-options spacing on shiny::radioButtons() and shiny::checkboxGroupInput() in Bootstrap 5, where a Shiny rule was overriding the bslib fix. (#1308)
  • Fixed the resize handle indicator position for position = "right" sidebars, which now correctly appears at the inner boundary of the sidebar handle. (#1322)
  • Allow users to directly grab the sidebar handle to resize the sidebar. (#1331)

From NEWS.md in the release

Install

Health

CRAN checks
5NOTE8OK
Check messages
NOTEdependencies in R coder-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc, r-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc, r-devel-windows-x86_64

r-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc, r-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc

Base packages in Suggests/Enhances imported in NAMESPACE:
  ‘tools’ ‘utils’

r-devel-windows-x86_64

Base packages in Suggests/Enhances imported in NAMESPACE:
  'tools' 'utils'

CRAN check page ↗

Slowest check: 3.7 min · r-oldrel-macos-x86_64
Status changes
  • NOTE8 OK, 5 NOTENow
  • NOTE11 OK, 2 NOTE2026-09-12
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-07-21
  • ERROR12 OK, 1 ERROR2026-07-18
Show 4 earlier changesHide 4 earlier changes
  • OK13 OK2026-06-09
  • ERROR12 OK, 1 ERROR2026-06-08
  • OK12 OK2026-04-25
  • NOTE11 OK, 3 NOTE2026-03-10
Advisories

none known

Documentation

In release 0.12.0
READMEYes · 326 wordsVignettes· In the repository, left out of the releaseNEWSYes · 100% structured · mentions 0.12.0Citation fileNoWebsiteYes · pkgdown
Help pages
59 (8 internal)includes a package overview page
Examples that run
100%38 run in a plain check (30 of them under a condition)
Exported functions with examples
69%
Documented parameters
92%
Return-value docs
62%
Help pages citing references
31%

Downloads

15.9M
CRAN downloads in the past year
Rank #20 · ~43.5K/day · ~1.3M/mo
Daily download trend is not available in this view yet.
1.4M30 days
4.5M90 days
15.9M1 year
Compare downloads with other packages →
Also on288.3K r2u21 autocran1.5M conda_forge20.6K c2d4u

Repository

569Stars
72Forks
186Open issues
20Open PRs
19Releases
1,077Commits
30Commit identities
shinyrmarkdownsassbootstraphtmltools
1,077 commits · Last activity 2026-10-13 · 0% stars, 30d · Default branch at 0.12.0.9000, ahead of CRAN 0.12.0 (checked 2026-10-11) · Discussions: 27 posts
Responsiveness
How these are sampled
PRs merged (all time)
93%
Median days to close, 50 most recently updated closed issues
4
Median days to close, 50 most recently updated closed PRs
3

Stars over time

2025-10-16 · 5312026-10-07 · 569
PracticesBeta

13 development-tooling and community-health practices detected across 6 families in the upstream repository

Checks run against github.com/rstudio/bslib on 2026-10-11.

Continuous integration (1)
GitHub Actions
Governance and community (3)
Code of conductIssue templatesPR template
Docs source (3)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-09-22

pkgdown site last built 2026-08-03, before release 0.12.0 (2026-08-04)

CRAN release process (2)
cran-comments.mdrevdep/
Show all practicesHide 2 practices
Lint, format, editor (3)
AirVS CodeRStudio project
Git structural (1)
.gitattributes
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2026-03-07
    Seen in the repository: .claude, .claude/skills
    Named in .Rbuildignore: .claude
    Pull request it wrote: opened by a project member
    Commits: at least 2 crediting it in the message
  • GitHub Copilotfirst seen 2026-08-03
    Commits: at least 1 crediting it in the message
Shared conventions any agent may read, so they name no particular tool.
Seen in the repository: AGENTS.md
Review tools
  • Copilot code review
    Commits: at least 1 accepting its review suggestions
Models named in its commits
  • Claude Opus 4.61 commit · Apr 2026
  • Claude Sonnet 4.61 commit · May 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
26 external dependencies (excludes base and recommended)

Installing bslib adds 16 packages (12 with compiled code, 7.8 MB of source tarballs). Heaviest: sass 2.9 MB, fs 1.4 MB, jsonlite 1.0 MB.

Depends (1)
R >= 2.10
LinkingTo (0)
none
Enhances (0)
none

People & History

People (9)
Author, Maintainer since 0.2.4 (2021)
Author · added in 0.5.0
Author
Contributor, Copyright holder
Bootstrap colorpicker library
Contributor
Bootstrap library
Contributor, Copyright holder
Bootswatch library
Contributor, Copyright holder
Bootstrap accessibility plugin
Copyright holder, Funder · added in 0.5.0
Copyright holder
Bootstrap library
Listed in earlier versions (1)
RStudio
no longer listed · 0.2.4 to 0.4.2
Releases (19)

Pick two releases to compare their code metrics.

  • 0.12.0Latest
    record
    2026-08-04 · current release · diff ↗ ·
    added 4 exports
    hide_offcanvas, offcanvas, show_offcanvas, toggle_offcanvas
  • 0.11.0
    record
    2026-05-16 · diff ↗ ·
    added 7 exports
    toolbar, toolbar_divider, toolbar_input_button, toolbar_input_select, toolbar_spacer, update_toolbar_input_button, update_toolbar_input_select
  • R
    R 4.6.0 released · 2026-04-24
  • 0.10.0
    record
    2026-01-26 · diff ↗ ·
    added 8 exports
    hide_toast, input_code_editor, input_submit_textarea, show_toast, toast, toast_header, update_code_editor, update_submit_textarea
  • R
    R 4.5.0 released · 2025-04-11
  • 0.9.0
    record
    2025-01-31 · diff ↗ ·
    added 1 export
    navbar_options
  • 0.8.0
    record
    2024-07-29 · diff ↗ ·
    added 1 export
    css
  • R
    R 4.4.0 released · 2024-04-24
  • 0.7.0
    record
    2024-03-29 · diff ↗ ·
    added 3 exports
    bind_task_button, input_task_button, update_task_button
  • 0.6.2
    record
    2024-03-22 · diff ↗
  • 0.6.1
    record
    2023-11-29 · diff ↗
  • 0.6.0
    record
    2023-11-21 · diff ↗ ·
    added 6 exports
    input_dark_mode, navset_card_underline, navset_underline, showcase_bottom, toggle_dark_mode, value_box_theme
  • 0.5.1
    record
    2023-08-11 · diff ↗ ·
    added 11 exports
    builtin_themes, input_switch, popover, toggle_popover, toggle_sidebar, toggle_switch, toggle_tooltip, tooltip, update_popover, update_switch, update_tooltip
  • 0.5.0
    record
    2023-06-09 · diff ↗ ·
    added 31 exports
    accordion, accordion_panel, accordion_panel_close, accordion_panel_insert, accordion_panel_open, accordion_panel_remove, accordion_panel_set, accordion_panel_update, as_fill_carrier, as_fill_item, as_fillable_container, breakpoints, is_fill_carrier, is_fill_item, is_fillable_container, layout_columns, layout_sidebar, nav_panel, nav_panel_hidden, navset_bar, navset_card_pill, navset_card_tab, navset_hidden, navset_pill, navset_pill_list, navset_tab, page_fillable, page_sidebar, remove_all_fill, sidebar and 1 more
  • R
    R 4.3.0 released · 2023-04-21
  • 0.4.2
    record
    2022-12-16 · diff ↗ ·
    added 13 exports
    as.card_item, card, card_body, card_body_fill, card_footer, card_header, card_image, card_title, is.card_item, layout_column_wrap, showcase_left_center, showcase_top_right, value_box
Show 10 earlier eventsHide 10 earlier events
  • 0.4.1
    record
    2022-11-02 · diff ↗
  • 0.4.0
    record
    2022-07-16 · diff ↗
  • R
    R 4.2.0 released · 2022-04-22
  • 0.3.1
    record
    2021-10-06 · diff ↗
  • 0.3.0
    record
    2021-09-02 · diff ↗ ·
    removed 1 export
    %>%
    added 24 exports
    nav, nav_append, nav_content, nav_hide, nav_insert, nav_item, nav_menu, nav_prepend, nav_remove, nav_select, nav_show, nav_spacer, navs_bar, navs_hidden, navs_pill, navs_pill_card, navs_pill_list, navs_tab, navs_tab_card, page, page_fill, page_fixed, page_fluid, page_navbar
  • 0.2.5.1
    record
    2021-05-18 · diff ↗
  • R
    R 4.1.0 released · 2021-05-18
  • 0.2.5
    record
    2021-05-12 · diff ↗ ·
    added 3 exports
    bs_add_functions, bs_add_mixins, font_collection
  • 0.2.4
    record
    2021-01-25
  • R
    R 4.0.0 released · 2020-04-24

Package metadata

First published
2021-01-25
Total releases
19 / 5 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 2.10
Download size
5.6 MB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("bslib")
Sievert, C., Posit Software, PBC, Aden-Buie, G., Aguilar, J., Bootstrap contributors, , Cheng, J., Park, T., PayPal, , & Twitter, Inc, . (2026). bslib: Custom 'Bootstrap' 'Sass' Themes for 'shiny' and 'rmarkdown' (Version 0.12.0) [Computer software]. https://doi.org/10.32614/CRAN.package.bslib

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 bslib version 0.12.0 [Data set]. HJJB, LLC. Data release v2026-10-17. https://doi.org/10.5281/zenodo.21843040

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