Easy interactive web applications with R
Clone or download
alandipert and jcheng5 Upgrade FontAwesome to 5.3.1 (#2186)
* Upgrade FontAwesome to 5.3.1

- Upgrades FontAwesome to a new major (breaking) version, but
  is backwards compatible because we include the v4-shims CSS that maps
  old names to new.
- This is a step toward full V5 adoption that doesn't require us to
  come up with a plan for deprecating V4 icon names.
- Details: https://fontawesome.com/how-to-use/on-the-web/setup/upgrading-from-version-4
- Related to #2156 and #1966

* Improvements to icon

- Clarify in docs that fontawesome V5 icons accessible with V4-style names
- Make icons browseable: icon('address-book') will now open the Viewer
  pane of RStudio IDE so that icons can be experimented with more easily.

* Update LICENSE with CC for FontAwesome .svgs

* Update NEWS
Latest commit 3cea5fb Sep 18, 2018
Failed to load latest commit information.
R Upgrade FontAwesome to 5.3.1 (#2186) Sep 18, 2018
inst Upgrade FontAwesome to 5.3.1 (#2186) Sep 18, 2018
man-roxygen Add documentation about using selected=character(0). Closes #1182 Aug 12, 2016
man Upgrade FontAwesome to 5.3.1 (#2186) Sep 18, 2018
manualtests/async Fix bug where req(cancelOutput=TRUE) would leave things grey Feb 9, 2018
res Update documentation for renderXX Feb 14, 2013
smoketests More tests Nov 16, 2015
srcjs Code review feedback--use an arrow function instead of aliasing `this` Sep 18, 2018
tests Update coordmap tests Aug 11, 2018
tools gruntfile should run 'default' task to make sure everything is built … Jun 20, 2018
.Rbuildignore Add to .Rbuildignore Feb 9, 2018
.Rinstignore Fix Rmd build tooling Apr 3, 2014
.gitattributes Treat shiny.js as binary Apr 23, 2015
.gitignore verify that button icons are in the right format (not necessarily val… Mar 15, 2016
.travis.yml Remove sourcetools workaround for Travis Sep 13, 2016
CONTRIBUTING.md Update links in CONTRIBUTING.md May 23, 2017
DESCRIPTION Remove unneeded Remotes Sep 18, 2018
LICENSE Upgrade FontAwesome to 5.3.1 (#2186) Sep 18, 2018
NAMESPACE Add sentinel value cache miss Jun 29, 2018
NEWS.md Upgrade FontAwesome to 5.3.1 (#2186) Sep 18, 2018
README.md Point to RStudio Community website instead of shiny-discuss Sep 27, 2017
TODO-promises.md Update TODO-promises.md Feb 13, 2018
appveyor.yml For installation of Rtools on Appveyor Feb 16, 2018
cran-comments.md Clear cran comments May 18, 2015
shiny.Rproj Update Rproj for new version of RStudio IDE Jun 2, 2017



Travis: Travis Build Status

AppVeyor: AppVeyor Build Status

Shiny is a new package from RStudio that makes it incredibly easy to build interactive web applications with R.

For an introduction and examples, visit the Shiny Dev Center.

If you have general questions about using Shiny, please use the RStudio Community website. For bug reports, please use the issue tracker.


  • Build useful web applications with only a few lines of code—no JavaScript required.
  • Shiny applications are automatically "live" in the same way that spreadsheets are live. Outputs change instantly as users modify inputs, without requiring a reload of the browser.
  • Shiny user interfaces can be built entirely using R, or can be written directly in HTML, CSS, and JavaScript for more flexibility.
  • Works in any R environment (Console R, Rgui for Windows or Mac, ESS, StatET, RStudio, etc.).
  • Attractive default UI theme based on Bootstrap.
  • A highly customizable slider widget with built-in support for animation.
  • Prebuilt output widgets for displaying plots, tables, and printed output of R objects.
  • Fast bidirectional communication between the web browser and R using the httpuv package.
  • Uses a reactive programming model that eliminates messy event handling code, so you can focus on the code that really matters.
  • Develop and redistribute your own Shiny widgets that other developers can easily drop into their own applications (coming soon!).


To install the stable version from CRAN, simply run the following from an R console:


To install the latest development builds directly from GitHub, run this instead:

if (!require("devtools"))

Getting Started

To learn more we highly recommend you check out the Shiny Tutorial. The tutorial explains the framework in-depth, walks you through building a simple application, and includes extensive annotated examples.

Bootstrap 3 migration

Shiny versions and below used the Bootstrap 2 web framework. After, Shiny switched to Bootstrap 3. For most users, the upgrade should be seamless. However, if you have have customized your HTML-generating code to use features specific to Bootstrap 2, you may need to update your code to work with Bootstrap 3.

If you do not wish to update your code at this time, you can use the shinybootstrap2 package for backward compatibility.

If you prefer to install an older version of Shiny, you can do it using the devtools package:

devtools::install_version("shiny", version = "")

Development notes

The Javascript code in Shiny is minified using tools that run on Node.js. See the tools/ directory for more information.

Guidelines for contributing

We welcome contributions to the shiny package. Please see our CONTRIBUTING.md file for detailed guidelines of how to contribute.


The shiny package is licensed under the GPLv3. See these files in the inst directory for additional details:

  • COPYING - shiny package license (GPLv3)
  • NOTICE - Copyright notices for additional included software