Repository files navigation

Thebslib R package provides a modern UI toolkit forShiny andRMarkdown based onBootstrap. It facilitates:

• Creation of delightful and customizableShinydashboards.
  • The underlying UI components (e.g.,cards,valueboxes,sidebars,etc) are also designed to work in other contexts (e.g., in RMarkdown).
• Customtheming ofShiny apps and R Markdown documents.
  • Apps can even be themed interactively in real-time.
• Use of modern versions of Bootstrap andBootswatch
  • Shiny and R Markdown currently default to Bootstrap 3 and maycontinue to do so to maintain backwards compatibility.

Install thebslib package from CRAN as follows:

install.packages("bslib")

The quickest way to see what{bslib} can do is to runbslib::bs_theme_preview() at the console. This launches a demo appcontaining both{bslib} and{shiny} UI components as well as antheming widget (bslib::bs_themer()) overlaid on the app. Seereal-timethemingto learn more.

Since{bslib} covers a wide array of uses, it has numerous gettingstarted articles, each focusing on a particular interest:

• Shinydashboards
• Any Bootstrapproject
• Theming

There are two main places to get help withbslib:

• TheRStudio community is a friendly placeto ask any questions (be sure to add abslib tag when creating atopic).

• Stack Overflow isa great source of answers to commonbslib questions. It is also agreat place to get help, once you have created a reproducible examplethat illustrates your problem. Use the tags[r][bslib] ifyou ask a question. Add the tag[bslib] if you are using a Shinyruntime.

Please note that the bslib project is released with aContributor CodeofConduct.By contributing to this project, you agree to abide by its terms.