Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 3 days ago
JSON representation
☁️ ☁️ ☁️ Beautiful Bubbles in Shiny and RMarkdown Backgrounds
- Host: GitHub
- URL: https://github.com/feddelegrand7/bubblyr
- Owner: feddelegrand7
- License: other
- Created: 2020-06-26T00:21:06.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-12-12T22:28:19.000Z (almost 4 years ago)
- Last Synced: 2024-10-08T09:57:54.414Z (about 1 month ago)
- Topics: javascript, rmarkdown, rmarkdown-backgrounds, rmarkdown-document, rstats, shiny
- Language: R
- Homepage: https://ihaddadenfodil.com/post/create-nice-looking-bubbles-in-rmarkdown-and-shiny-backgrounds-with-bubblyr/
- Size: 7.57 MB
- Stars: 16
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.Rmd
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-shiny-extensions - bubblyr - Add animated bubbles to Shiny and R Markdown backgrounds. (UI Components / Animation Effects)
README
---
output: github_document
---```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```[![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.