Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/feddelegrand7/bubblyr

☁️ ☁️ ☁️ Beautiful Bubbles in Shiny and RMarkdown Backgrounds
https://github.com/feddelegrand7/bubblyr

javascript rmarkdown rmarkdown-backgrounds rmarkdown-document rstats shiny

Last synced: about 1 month ago
JSON representation

☁️ ☁️ ☁️ Beautiful Bubbles in Shiny and RMarkdown Backgrounds

Awesome Lists containing this project

README

        

---
output: github_document
---

```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```

# bubblyr

[![CRAN_Status_Badge](https://www.r-pkg.org/badges/version/bubblyr)](https://cran.r-project.org/package=bubblyr)

[![CRAN_time_from_release](https://www.r-pkg.org/badges/ago/bubblyr)](https://cran.r-project.org/package=bubblyr)

[![metacran
downloads](https://cranlogs.r-pkg.org/badges/bubblyr)](https://cran.r-project.org/package=bubblyr)

![](http://cranlogs.r-pkg.org/badges/grand-total/bubblyr?color=blue)

[![license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://choosealicense.com/licenses/mit/)

[![R build status](https://github.com/feddelegrand7/bubblyr/workflows/R-CMD-check/badge.svg)](https://github.com/feddelegrand7/bubblyr/actions)

`bubblyr` is an R wrapper of the JavaScript library [bubbly-bg](https://github.com/tipsy/bubbly-bg). It allows you to add beautiful animated bubbles within Shiny and RMarkdown backgrounds. You can choose from several themes and apply the animation with one line of code.

![](man/figures/lalalandexample.gif)

## Installation

You can install the `bubblyr` package from CRAN with:

```{r, eval=FALSE}

install.packages("bubblyr")

```

You can install the development version of `bubblyr` from Github with:

```{r, eval=FALSE}

install.packages("remotes") #if not installed

remotes::install_github("feddelegrand7/bubblyr")

```

# Themes

Here a list of all the available themes. Note that The ocean, cherry, hippie, bigmom and deepsea themes are provided by the author of the bubbly-bg JavaScript library, I just gave them some fancy names:

```{r, echo=FALSE}
list <- c(
"ocean",
"cherry",
"hippie",
"bigmom",
"deepsea",
"illusion",
"rstudio",
"ash",
"classy",
"volcano",
"lacoste",
"warmup",
"fire",
"traffic",
"life",
"darksky",
"orangina",
"meteor",
"gravitas",
"rladies",
"sunshine",
"sweet",
"lalaland"
)

knitr::kable(list, col.names = "Themes")
```

Below you can find some examples, feel free to experiment the remaining themes:

#### Important: You may experiment some lags when viewing your Shiny/Rmd Document in the RStudio pane, instead use the browser.

```{r, eval=FALSE}
library(shiny)
library(bubblyr)

ui <- fluidPage(

bubbly(theme = "bigmom")

)

server <- function(input, output) {}

shinyApp(ui = ui, server = server)

```

![](man/figures/bigmom.gif)

```{r, eval=FALSE}
library(shiny)
library(bubblyr)

ui <- fluidPage(

bubbly(theme = "rstudio")

)

server <- function(input, output) {}

shinyApp(ui = ui, server = server)

```

![](man/figures/rstudio.gif)

```{r, eval=FALSE}
library(shiny)
library(bubblyr)

ui <- fluidPage(

bubbly(theme = "classy")

)

server <- function(input, output) {}

shinyApp(ui = ui, server = server)

```

![](man/figures/classy.gif)

## Code of Conduct

Please note that the bubblyr project is released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.