golemexample

The goal of golemexample is to provide some examples for the inner configuration of a {golem} app.

Share value across modules

Add a top level reactiveValue https://github.com/ColinFay/golemexample/blob/master/R/app_server.R#L6
Add a nested level inside modules https://github.com/ColinFay/golemexample/blob/master/R/mod_my_other_module.R#L35
Share this across modules https://github.com/ColinFay/golemexample/blob/master/R/mod_my_third_module.R#L33

Change Shiny Options

https://github.com/ColinFay/golemexample/blob/master/R/run_app.R#L14

Adding external files

CSS

Added with dev/02_dev.R#29 https://github.com/ColinFay/golemexample/blob/master/dev/02_dev.R#L29
Personnalized in inst/app/www/custom.css https://github.com/ColinFay/golemexample/tree/master/inst/app/www/custom.css
Linked to the app at R/app_ui.R#27 https://github.com/ColinFay/golemexample/blob/master/R/app_ui.R#L27

JS

Classic

A simple JS can be used from UI.

Added with dev/02_dev.R#27 https://github.com/ColinFay/golemexample/blob/master/dev/02_dev.R#L27
Personnalized in inst/app/www/alertme.js https://github.com/ColinFay/golemexample/blob/master/inst/app/www/alertme.js
Linked to the app at R/app_ui.R#28 https://github.com/ColinFay/golemexample/blob/master/R/app_ui.R#L28
Called with tags$button("Alert!", onclick = "alertme();") at R/mod_my_first_module.R#33 https://github.com/ColinFay/golemexample/blob/master/R/mod_my_first_module.R#L33

Handlers

A handler JS can be used from server side with golem::invoke_js().

Added with dev/02_dev.R#28 https://github.com/ColinFay/golemexample/blob/master/dev/02_dev.R#L28
Personnalized in inst/app/www/handler.js https://github.com/ColinFay/golemexample/tree/master/inst/app/www/handler.js
Linked to the app at R/app_ui.R#29 https://github.com/ColinFay/golemexample/blob/master/R/app_ui.R#L29
Called with golem::invoke_js("alertarg", "12") at R/mod_my_first_module.R#58 https://github.com/ColinFay/golemexample/blob/master/R/mod_my_first_module.R#L58

Image

Downloaded at inst/app/www/guit.jpg https://github.com/ColinFay/golemexample/blob/master/inst/app/www/guit.jpg
Linked with tags$img(src = "www/guit.jpg") at R/mod_my_first_module.R#23 https://github.com/ColinFay/golemexample/blob/master/R/mod_my_first_module.R#L23

Passing arguments to `run_app`

run_app https://github.com/ColinFay/golemexample/blob/master/R/run_app.R#L6
Read in UI at R/app_ui.R#8 https://github.com/ColinFay/golemexample/blob/master/R/app_ui.R#L8
Read in server at R/app_server.R#5 https://github.com/ColinFay/golemexample/blob/master/R/app_server.R#L5

Using datasets inside your app

Register your dataset as a package data https://github.com/ColinFay/golemexample/blob/master/data-raw/dataset.R#L6 which is turned into https://github.com/ColinFay/golemexample/blob/master/data/plop.rda
Use your data object wherever you need it (in your UI or server)

Using shiny::includeXXX

Add elements in inst/app/www https://github.com/ColinFay/golemexample/blob/master/inst/app/www/plop.md
Use system.file("app/www/plop.md", package = "golemexample") https://github.com/ColinFay/golemexample/blob/master/R/mod_my_fifth_module.R#L19

Please note that the ‘golemexample’ project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

ColinFay/golemexample