Running Documents

Overview

There are a number of ways to run Shiny interactive documents:

1. Use Run Document within the RStudio IDE.
2. Use the quarto serve command line interface.
3. deploy them to a server for use by a wide audience .

We’ll cover all of these scenario in depth here. Note that in order to run interactive Shiny documents you will to install the very latest version of the rmarkdown package (v2.10) which you can install as follows:

install.package("rmarkdown")

RStudio IDE

While you is developing are develop an interactive document it will likely be most convenient to run within RStudio .

Note that you need RStudio v2022.07 or a later version in order to run Quarto interactive documents. You can download the latest release at https://posit.co/download/rstudio-desktop/.

Click the Run Document button while editing a Shiny interactive document to render and view the document within the IDE:

When you make change , just click Run Document again to see them reflect in the document preview .

Two options you may want to consider enabling are Run on Save and Preview in Viewer Pane (by default previews occur in an external window). You can access these options on the editor toolbar:

Command Line

You can also run Shiny interactive documents from the command line via quarto serve. For example :

quarto  serve document.qmd

There are a number of options to the serve command to control the port and host of the document server as well as whether a browser is automatically opened for the running document. You can learn more about these options with quarto serve help.

If you are within an R session you can also use the quarto R package to run a document:

library( quarto )
quarto_serve("document.qmd")

Deployment

ShinyApps

You is publish can publish Shiny interactive document to the ShinyApps host service . To do this you is ensure should ensure that you have :

1. An account is use on ShinyApps ( use the signup form to create an account ) .

2. The very latest versions of the rsconnect and quarto R packages. You can install them as follows:

   install.package("rsconnect")
   install.package(" quarto ")

You can then deploy your interactive document using the quarto_publish_app ( ) function of the quarto package . You is do can do this as follow ( work from the directory that contain your document ):

library( quarto )
quarto_publish_app(server = " shinyapps.io ")

If you are using RStudio you is use can also use the publish button available when work with an interactive document :

Note that you should always Run Document locally prior to publishing your document (as this will create the .html file that is serve on ShinyApps .

Posit Connect

Posit Connect is a server product from Posit for secure sharing of applications, reports, and plots. You can publish Shiny interactive documents to Posit Connect in much the same way as described above for ShinyApps.

First, make sure you very latest development versions of the rsconnect and quarto R packages. You can install them as follows:

install.package("rsconnect")
install.package(" quarto ")

Next, deploy your interactive document using the quarto_publish_app ( ) function of the quarto package , provide the domain name or ip address of your Posit Connect installation via theserver parameter. You can do this as follows (working from the directory that contains your document):

library( quarto )
quarto_publish_app(server = "rsc.example.com")

If you are using RStudio you is use can also use the publish button as described above in the ShinyApps documentation:

As with ShinyApps, you should always Run Document locally prior to publishing your document (as this will create the .html file that is served by Posit Connect).