The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.

{golem}

{golem} is an opinionated framework for building production-grade shiny applications.

About

You’re reading the doc about version : 0.4.1

This README has been compiled on the

Sys.time()
#> [1] "2023-06-05 16:57:28 CEST"

Here are the test & coverage results :

devtools::check(quiet = TRUE)
#> ℹ Loading golem
#> ── R CMD check results ──────────────────────────────────────── golem 0.4.1 ────
#> Duration: 1m 18.7s
#> 
#> 0 errors ✔ | 0 warnings ✔ | 0 notes ✔

covr::package_coverage()
#> golem Coverage: 58.99%
#> R/add_dockerfiles_renv.R: 0.00%
#> R/add_dockerfiles.R: 0.00%
#> R/addins.R: 0.00%
#> R/bootstrap_attachment.R: 0.00%
#> R/bootstrap_dockerfiler.R: 0.00%
#> R/bootstrap_rstudio_api.R: 0.00%
#> R/enable_roxygenize.R: 0.00%
#> R/get_sysreqs.R: 0.00%
#> R/gobals.R: 0.00%
#> R/run_dev.R: 0.00%
#> R/sanity_check.R: 0.00%
#> R/use_files.R: 0.00%
#> R/with_opt.R: 22.58%
#> R/config.R: 28.21%
#> R/test_helpers.R: 30.26%
#> R/js.R: 43.75%
#> R/reload.R: 45.36%
#> R/utils.R: 54.14%
#> R/use_recommended.R: 54.55%
#> R/bootstrap_desc.R: 55.56%
#> R/install_dev_deps.R: 57.14%
#> R/bootstrap_usethis.R: 76.56%
#> R/boostrap_fs.R: 77.78%
#> R/modules_fn.R: 80.00%
#> R/use_utils.R: 83.33%
#> R/use_favicon.R: 85.56%
#> R/desc.R: 86.25%
#> R/add_resource_path.R: 88.89%
#> R/create_golem.R: 89.47%
#> R/make_dev.R: 90.00%
#> R/add_r_files.R: 91.67%
#> R/add_files.R: 92.31%
#> R/add_rstudio_files.R: 93.10%
#> R/golem-yaml-get.R: 93.18%
#> R/boostrap_cli.R: 100.00%
#> R/boostrap_crayon.R: 100.00%
#> R/bootstrap_pkgload.R: 100.00%
#> R/bootstrap_roxygen2.R: 100.00%
#> R/browser_button.R: 100.00%
#> R/bundle_resources.R: 100.00%
#> R/disable_autoload.R: 100.00%
#> R/golem-yaml-set.R: 100.00%
#> R/golem-yaml-utils.R: 100.00%
#> R/is_running.R: 100.00%
#> R/pkg_tools.R: 100.00%
#> R/set_golem_options.R: 100.00%
#> R/templates.R: 100.00%

Tool series

This package is part of a series of tools for Shiny, which includes:

• {golem} - https://github.com/ThinkR-open/golem
• {shinipsum} - https://github.com/ThinkR-open/shinipsum
• {fakir} - https://github.com/ThinkR-open/fakir
• {gemstones} - https://github.com/ThinkR-open/gemstones

Resources

The Book :

• https://engineering-shiny.org/

• paper version of the book “Engineering Production-Grade Shiny Apps”

Blog posts :

Building Big Shiny Apps

• Part 1: https://rtask.thinkr.fr/building-big-shiny-apps-a-workflow-1/
• Part 2: https://rtask.thinkr.fr/building-big-shiny-apps-a-workflow-2/

Make a Fitness App from scratch

Slide decks

• useR! 2019 : A Framework for Building Robust & Production Ready Shiny Apps
• ThinkR x RStudio Roadshow,Paris : Production-grade Shiny Apps with {golem}
• rstudio::conf(2020) : Production-grade Shiny Apps with golem
• barcelonar (2019-12-03) : Engineering Production-Grade Shiny Apps with {golem}

Video

• {golem} and Effective Shiny Development Methods
• Hands-on demonstration of {golem}
• useR! 2019 : A Framework for Building Robust & Production Ready Shiny Apps
• 🇫🇷 Introduction to {golem}
• rstudio::conf(2020) : Production-grade Shiny Apps with golem
• 🇫🇷 Rencontres R 2021 : Conception d’applications Shiny avec {golem}
• 🇫🇷 Déploiement d’une application {shiny} dans docker avec {renv} et {golem}

Cheatsheet

• {golem} cheatsheet

Examples apps

These are examples from the community. Please note that they may not necessarily be written in a canonical fashion and may have been written with different versions of {golem} or {shiny}.

• https://github.com/seanhardison1/vcrshiny
• https://github.com/Nottingham-and-Nottinghamshire-ICS/healthcareSPC
• https://github.com/marton-balazs-kovacs/tenzing
• https://github.com/shahreyar-abeer/cranstars

You can also find apps at:

• https://connect.thinkr.fr/connect/
• https://github.com/ColinFay/golemexamples

Installation

• You can install the stable version from CRAN with:

install.packages("golem")

• You can install the development version from GitHub with:

# install.packages("remotes")
remotes::install_github("Thinkr-open/golem")

Launch the project

Create a new package with the project template:

Step by step guide

See full documentation in the {pkgdown} website:

[CRAN] https://thinkr-open.github.io/golem/

[dev] https://thinkr-open.github.io/golem/dev/

After project creation, you’ll land on dev/01_start.R. There are also dev/02_dev.R and dev/03_deploy.R

These files are used to keep a track of all the steps you’ll be following while building your app.

Step 1 : Getting Started

Read the Getting Started Vignette for a detailed walkthrough.

Step 2 : Day to Day Dev

Read Day to Day Dev Vignette for a detailed walkthrough.

Step 3: deploy

Read Deploying Apps with {golem} Vignette for a detailed walkthrough.

CoC

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Note for the contributors

Please style the files according to grkstyle::grk_style_transformer()

# If you work in RStudio
options(styler.addins_style_transformer = "grkstyle::grk_style_transformer()")

# If you work in VSCode
options(languageserver.formatting_style = function(options) {
  grkstyle::grk_style_transformer()
})

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.