Skip to content

Latest commit

 

History

History
87 lines (61 loc) · 3.96 KB

README.md

File metadata and controls

87 lines (61 loc) · 3.96 KB

shiny.fluent shiny.fluent logo

Microsoft Fluent UI for Shiny Apps

CRAN status CI downloads monthly downloads total

We believe that a great UI plays a huge role in the success of application projects. shiny.fluent gives your apps:

  • beautiful, professional look
  • rich set of components easily usable in Shiny
  • fast speed of development that Shiny is famous for.

As Fluent UI is built in React, shiny.fluent is based on another package called shiny.react, which allows for using React libraries in Shiny.

A big game-changer for companies already using Microsoft tools on a daily basis, because everyone is already familiar and pleased by the Microsoft UI.

Note: This package strives to be as easy to use as possible, while providing most of Fluent UI possibilities. That said, Fluent UI is more flexible and low level than Bootstrap, and there is additional complexity coming from using React in Shiny. You should expect using shiny.fluent to be somewhat more complex than vanilla Shiny or shiny.semantic (at some point you will likely want to browse the original Fluent UI documentation), but you get more power, flexibility and better UI in return.

shinyfluentapp

Getting started

Installation

Stable version:

install.packages("shiny.fluent")

Development version:

remotes::install_github("Appsilon/shiny.fluent")

Quick start

Here's how to make an app containing a Fluent UI checkbox:

shinyApp(
    ui = div(
      Checkbox.shinyInput("checkbox", value = TRUE),
      textOutput("checkboxValue")
    ),
    server = function(input, output) {
      output$checkboxValue <- renderText({
        sprintf("Value: %s", input$checkbox)
      })
    }
  )

shiny.fluent provides all components from Microsoft's Fluent UI library. Browse the official docs or start typing shiny.fluent:: in RStudio to see all available controls.

All components are documented, so if you run ?shiny.fluent::MyComponentName, you'll see documentation for this component in RStudio, along with examples. When in doubt, open Fluent UI docs for details.

Examples

A good way to learn more is to look at the examples. Once you install the library, you can run them with shiny.fluent::runExample("example_name"). We recommend the following for starters:

  • demo: a demo app for analyzing sales reps performance,
  • dashboard: a showcase of all available components along with documentation.

There are also usage examples for individual components. Use shiny.fluent::runExample() to list all available examples.

Appsilon

Appsilon is a Posit (formerly RStudio) Full Service Certified Partner.
Learn more at appsilon.com.

Get in touch [email protected]

Explore the Rhinoverse - a family of R packages built around Rhino!

We are hiring!